Saltar al contenido principal
Abre Desarrolladores en el pie de la barra lateral. Esta área contiene Claves de API, Webhooks para administradores del espacio y Plantillas de WhatsApp. El enlace Documentación de API abre la referencia para desarrolladores.

​
Claves de API

Las claves ofrecen acceso entre sistemas limitado al espacio de trabajo.

​
Crear una clave

  1. Selecciona Crear clave de API.
  2. Introduce un nombre reconocible.
  3. Elige uno o más permisos (scopes).
  4. Configura una fecha de vencimiento si lo deseas.
  5. Crea la clave y copia su valor.
El valor completo se muestra una sola vez. Guárdalo en un gestor de secretos. Los permisos disponibles cubren canales, conversaciones, escalamientos, acciones, historial de ejecuciones, plantillas de WhatsApp, tickets, comercio y otras API compatibles. Concede solo las operaciones necesarias; los permisos existentes no se amplían automáticamente cuando aparecen nuevos scopes. Para deshabilitar una credencial, selecciona Revocar y confirma. La revocación es irreversible.

​
Plantillas de WhatsApp

Esta pestaña permite auditar el procesamiento de solicitudes. Filtra por:
  • accepted: aceptada
  • replayed: repetida
  • rejected: rechazada
  • publish failed: publicación fallida
Busca una solicitud específica. Abre una fila cuando haya registros para revisar la solicitud y su resultado de procesamiento.

​
Webhooks

Los administradores pueden crear destinos firmados, elegir eventos compatibles, pausar entregas y revisar intentos. El secreto solo se muestra al crearlo o rotarlo. Guárdalo en un gestor de secretos, verifica firmas sobre el cuerpo sin modificar y procesa reintentos de forma idempotente. Consulta Webhooks del dashboard para configuración, historial, rotación y recuperación segura.

​
Acciones y ejecuciones

Las acciones se administran en Conectores, no en Desarrolladores. Usa un sistema con API para llamar a tu backend, un sistema alojado en Visito para guardar envíos estructurados o Google Sheets para lecturas y escrituras configuradas.

Conectar tu primera herramienta

Sigue un ejemplo de estado de pedido desde el conector hasta las respuestas del Área de pruebas, incluidos datos faltantes y consultas fallidas.

​
Cómo se ve una conversación con el cliente

Para get_order_status, un flujo correcto sigue esta secuencia:
  1. El cliente pregunta: “¿Dónde está el pedido A-1003?”.
  2. El asistente llama a la herramienta con { "order_number": "A-1003" }.
  3. Tu backend devuelve datos estructurados del pedido.
  4. Playground muestra Action completed: get order status. En una conversación real, la línea de tiempo muestra el registro compacto Action completed.
  5. El asistente convierte el resultado en una respuesta natural al cliente.
El registro y la salida sin procesar de la herramienta son solo para operadores. El cliente recibe la respuesta final del asistente. Para ver solicitud, respuesta, registro y mensaje final completos, consulta Herramientas de IA personalizadas.

​
Actividad

Abre Conectores → Actividad para inspeccionar acción, conector, conexión, estado, endpoint, estado de respuesta, duración, entradas guardadas, encabezados saneados, respuesta y errores. Si un registro muestra Action failed, revisa su actividad antes de reintentar. Comprueba si falló por argumentos inválidos, autenticación, tiempo de espera, respuesta distinta de 2xx o salida mal formada. No asumas que una acción que modifica datos se completó.
Concede los permisos mínimos necesarios para claves y acciones. Trata las claves copiadas, secretos de webhook y credenciales de conectores como credenciales de producción.
Para configuración programática compatible, pruebas directas e inspección de ejecuciones, usa la API de Acciones. Una prueba directa comprueba la operación configurada con entradas proporcionadas; no demuestra la selección conversacional ni la generación correcta de argumentos.