Webhooks salientes
Los webhooks salientes te permiten recibir en tu propio servidor un aviso en tiempo real cada vez que ocurre un evento importante en tus agentes, para que puedas integrarlo con tus propios sistemas (por ejemplo, tu CRM, un sistema de tickets propio o una automatización interna).
Eventos disponibles
Al crear un webhook eliges a qué eventos quieres suscribirte:
- Conversación creada (
conversation.created) - Mensaje recibido (
message.created) - Mensaje valorado (
message.rated) - Traspaso a humano (
human_handoff.requested)
Cómo crear un webhook
- Ve a Configuración → Webhooks.
- Haz clic en Nuevo webhook.
- Completa un nombre descriptivo (por ejemplo, "Mi servidor") y la URL de destino donde EMMIA enviará las peticiones (por ejemplo,
https://mi-app.com/webhook). - Marca uno o más eventos a los que quieres suscribirte.
- Haz clic en Crear webhook.
Nota: al crear el webhook, EMMIA te muestra un secret una sola vez. Cópialo y guárdalo de inmediato — no se volverá a mostrar. Lo necesitas para verificar que las peticiones realmente vienen de EMMIA.
Cómo verificar que la petición viene de EMMIA
Cada petición que EMMIA envía a tu servidor incluye una cabecera X-EMMIA-Signature con una firma HMAC calculada usando el secret del webhook. Tu servidor debe recalcular esa firma con el mismo secret y compararla antes de confiar en el contenido recibido, para evitar procesar peticiones falsificadas.
Probar un webhook
Cada webhook tiene un botón de prueba (ícono de reproducir) que envía un evento de ejemplo a tu URL de destino, útil para verificar que tu servidor está recibiendo y respondiendo correctamente antes de depender de él en producción.
Historial de entregas
Al expandir un webhook puedes ver:
- Los eventos a los que está suscrito.
- El número de fallos recientes, si los hay.
- Un registro de las últimas entregas, con fecha, evento, código de respuesta HTTP y el error (si falló).
Eliminar un webhook
- Ve a Configuración → Webhooks.
- Haz clic en el ícono de la papelera junto al webhook que quieres eliminar.
- Confirma la acción.