Resumen
Este artículo explica los diferentes tipos de eventos disponibles para acciones de API de REST en Wati. Aprenderás cuándo se desencadena cada evento, qué datos puede enviar y cómo usarlos correctamente, especialmente al recopilar comentarios, datos de formularios o información de leads.
Instrucciones
Las acciones de API de REST basadas en eventos se ejecutan automáticamente cuando ocurre un evento específico en una conversación. Cada tipo de evento se comporta de manera diferente, especialmente en términos de qué datos (parámetros) se pueden enviar.
Entender estas diferencias te ayuda a elegir el evento correcto y evitar problemas de configuración.
1. Eventos de pulgares arriba / pulgares abajo
Cuándo se desencadena
Este evento se desencadena cuando un usuario hace clic en el botón de comentarios ( o ) en la interfaz de chat.
Comportamiento de parámetros
Solo se admiten parámetros estáticos (fijos)
No se puede pasar datos de usuario dinámicos
Esto significa que todos los valores en la solicitud de API deben estar predefinidos.
Casos de uso comunes
Seguimiento de métricas de satisfacción del usuario
Enviar notificaciones de Slack cuando se recibe una retroalimentación negativa
Registro de eventos de comentarios en una plataforma de análisis
️ Importante: Los eventos de pulgares arriba y abajo no pueden enviar información de usuario dinámica, como direcciones de correo electrónico, nombres o contenido de conversación, por sí mismos.
Combinar pulgares arriba/abajo con un formulario de comentarios
Si necesitas comentarios detallados o información de usuario, puedes combinar este evento con el evento Formulario enviado.
Cómo funciona
Crea un formulario personalizado de tipo Comentarios
Cuando el usuario hace clic en o , el formulario de comentarios aparece automáticamente
El usuario completa el formulario (por ejemplo, razón para los comentarios o correo electrónico)
Ambos eventos pueden desencadenarse al mismo tiempo:
Evento de pulgares arriba/abajo → envía datos estáticos
Evento de formulario enviado → envía datos de formulario dinámicos
Escenario de ejemplo
Consejo: Para recopilar correos electrónicos, razones o comentarios, siempre usa un formulario personalizado y crea una acción de API de REST separada para el evento Formulario enviado.
2. Evento de formulario enviado
Cuándo se desencadena
Este evento se desencadena cuando un usuario completa y envía un formulario personalizado en la interfaz de chat.
Comportamiento de parámetros
Admite parámetros dinámicos desde campos de formulario
Los nombres de los campos de formulario deben coincidir exactamente con los marcadores de posición utilizados en tu configuración de API de REST
Cómo configurarlo
Paso 1: Crear un formulario personalizado
Crea un formulario personalizado con nombres de campo claramente definidos.
Ejemplo:
Nombre del campo del formulario | Tipo de campo | Descripción |
| Correo electrónico | Dirección de correo electrónico del usuario |
| Texto | Nombre del usuario |
| Texto | Nombre de la empresa |
| Texto | Mensaje del usuario |
Paso 2: Configurar la acción de API de REST
Usa marcadores de posición en tu solicitud de API donde el sufijo coincide con el nombre del campo del formulario.
Los marcadores de posición pueden incluir prefijos como contact., agent. o action., pero la coincidencia se basa solo en el sufijo (la parte después del último .).
Ejemplos:
Campo de formulario
email→{{email}}o{{contact.email}}Campo de formulario
first_name→{{first_name}}o{{contact.first_name}}Campo de formulario
company→{{company}}o{{contact.company}}
Reglas de coincidencia de parámetros
Campo del formulario | Marcador de posición | Coincidencia | Razón |
|
| Sí | Coincidencia directa |
|
| Sí | El sufijo |
|
| Sí | El sufijo |
|
| Sí | El sufijo |
|
| No | Coincidencia de sufijo (sensible a mayúsculas y minúsculas) |
|
| No | Coincidencia de sufijo ( |
️ Importante: El sufijo del marcador de posición debe coincidir exactamente con el nombre del campo del formulario, incluyendo mayúsculas y minúsculas. El prefijo no afecta la coincidencia.
Flujo de ejemplo
3. Evento de lead capturado
Cuándo se desencadena
Este evento se desencadena automáticamente 10 minutos después de que finalice la conversación, si el agente de IA ha recopilado información de lead durante el chat.
Comportamiento de parámetros
Utiliza una estructura de cuerpo de solicitud fija
No puedes personalizar ni modificar los campos enviados
Estructura de cuerpo de solicitud fija
Cuando se ejecuta este evento, Wati envía automáticamente la siguiente carga útil:
{
"agent_id": "agent_id",
"data": {
"conversation_id": "conversation_id",
"details": "Detalles del lead",
"email": "[email protected]",
"first_name": "John",
"last_name": "Doe",
"lead_level": "Caliente",
"lead_score": 100,
"lead_summary": "Resumen del lead",
"max_score": 100
},
"event": "lead_captured"
}Descripciones de campos
Campo | Descripción |
| ID del agente de IA |
| Identificador de conversación único |
| Información de lead recopilada |
| Correo electrónico del usuario (si está disponible) |
| Nombre del usuario |
| Apellido del usuario |
| Calidad del lead (Caliente, Térmico, Frío) |
| Puntuación numérica del lead |
| Resumen del lead generado por el agente de IA |
| Puntuación máxima posible |
Nota: No necesitas definir un request_body para eventos de Lead capturado. Cualquier configuración de cuerpo de solicitud personalizada se ignorará.
Casos de uso comunes
Crear leads automáticamente en Salesforce o HubSpot
Enviar datos de lead a herramientas de automatización de marketing
Desencadenar flujos de trabajo de seguimiento en tu CRM
Referencia rápida: Comparación de tipos de eventos
Característica | Pulgares arriba/abajo | Formulario enviado | Lead capturado |
Parámetros dinámicos | No | Sí | Estructura fija |
Cuerpo de solicitud personalizado | Sí (solo estático) | Sí | No |
Requiere configuración de formulario | No | Sí | No |
Momento de desencadenamiento | Inmediato | Inmediato | 10 minutos después de que finaliza el chat |
Acción del usuario requerida | Hacer clic en el botón de comentarios | Enviar formulario | Ninguna (automático) |
Elección del tipo de evento correcto
Usa Pulgares arriba/abajo para el seguimiento de comentarios simple
Usa Formulario enviado cuando necesites entrada de usuario dinámica
Usa Lead capturado para la entrega automática de leads después de conversaciones
Seleccionar el evento correcto garantiza que tus acciones de API de REST se ejecuten de manera confiable y envíen los datos que esperas.