Resumen
Este artículo te guía a través de cómo configurar una acción de API de REST en Wati. Aprenderás cómo elegir el desencadenador correcto, seleccionar un tipo de evento si es necesario y agregar la acción a las instrucciones de tu agente de IA para que funcione como se espera.
Instrucciones
Una acción de API de REST solo funciona cuando se configura correctamente y se agrega a las instrucciones de tu agente de IA. El proceso de configuración tiene 3 pasos principales:
Elige cómo se debe activar la acción
Selecciona un tipo de evento (si corresponde)
Agrega la acción de API de REST a las instrucciones de tu agente de IA
Sigue los pasos a continuación para completar la configuración.
Paso 1: Elige un tipo de desencadenador
Al crear una acción de API de REST, la primera decisión es cómo se debe activar.
Hay 2 tipos de desencadenadores disponibles:
Desencadenador basado en intención
Este desencadenador se utiliza cuando deseas que la acción se ejecute en función de lo que dice el usuario.
Se activa cuando el agente de IA detecta una intención específica del usuario durante una conversación
Útil para acciones como enviar datos cuando un usuario solicita una demostración o muestra interés
Comportamiento de parámetros: se pueden utilizar marcadores de posición dinámicos para la configuración de la API.
Modo de desencadenador: Actualmente, solo se admite agent_decides. Esto significa que el agente de IA decide cuándo ejecutar la acción en función del contexto de la conversación.
Desencadenador basado en eventos
Este desencadenador se ejecuta automáticamente cuando ocurre un evento predefinido.
Se activa sin depender de la intención del usuario
Útil para acciones impulsadas por el sistema, como la retroalimentación o la presentación de formularios
Paso 2: Selecciona un tipo de evento (solo basado en eventos)
Si eliges Evento como tipo de desencadenador, debes seleccionar uno de los tipos de eventos admitidos.
Actualmente, Astra admite los siguientes tipos de eventos:
Retroalimentación positiva recibida (pulgar hacia arriba)
Se activa cuando un usuario hace clic en la opción de pulgar hacia arriba
Admite parámetros estáticos solo
Retroalimentación negativa recibida (pulgar hacia abajo)
Se activa cuando un usuario hace clic en la opción de pulgar hacia abajo
Admite parámetros estáticos solo
Formulario presentado
Se activa cuando un usuario presenta un formulario personalizado
Admite parámetros dinámicos que se pasan desde los campos del formulario
Lead capturado
Se activa cuando se recopila información de lead durante una conversación
Utiliza una estructura de cuerpo de solicitud fija
Elige el tipo de evento que mejor se adapte a cuándo deseas que se ejecute la acción de API de REST.
Paso 3: Agrega la acción de API de REST a las instrucciones del agente de IA
Crear una acción de API de REST no es suficiente por sí sola. La acción no funcionará hasta que se agregue a las instrucciones de tu agente de IA.
Requerido para todas las acciones de API de REST
Agrega la acción de API de REST a la configuración de instrucciones de tu agente
Si la acción no se incluye en las instrucciones, nunca se activará.
Requisito adicional para “Formulario presentado”
Si estás utilizando el tipo de evento Formulario presentado, hay un requisito adicional:
También debes agregar el formulario personalizado relacionado a las instrucciones del agente
Tanto la acción de API de REST como el formulario personalizado deben incluirse
Si falta alguno de ellos, la acción de API de REST no se activará correctamente.
Aquí tienes una visión general rápida de qué integrar dependiendo del tipo de evento:
Tipo de evento | Qué integrar |
Pulgar hacia arriba / Pulgar hacia abajo | Acción de API de REST solo |
Formulario presentado | Acción de API de REST + Formulario personalizado |
Lead capturado | Acción de API de REST solo |
Intención | Acción de API de REST solo |
Lista de verificación final
Antes de publicar tu agente de IA, asegúrate de que:
Se ha seleccionado un tipo de desencadenador
Se ha elegido un tipo de evento (si es basado en eventos)
La acción de API de REST se ha agregado a las instrucciones del agente
El formulario personalizado se ha agregado cuando se utiliza Formulario presentado
Una vez que se completen todos estos pasos, tu acción de API de REST estará lista para ejecutarse automáticamente durante las conversaciones.