Webhook
Notificaciones de eventos como traspaso a un agente humano, nuevos mensajes, fin de conversación, tickets y procesamiento de documentos, además de las reglas de verificación de firma y reintentos.
En el panel de administración, en «Configuración del bot», introduce la dirección del webhook. Cabeceras de la solicitud:
| Cabecera | Descripción |
|---|---|
X-AICS-Event-Id | ID del evento; úsalo para deduplicar |
X-AICS-Timestamp / X-AICS-Signature | El método de verificación de firma es el mismo que en la API de consulta de pedidos |
Cuerpo de la solicitud: {"id", "type", "created_at", "data"}.
| Evento | Cuándo se produce |
|---|---|
conversation.handoff | Transferencia a un agente humano (cuando el método de transferencia elegido es «Enviar a mi sistema» o «Notificar en ambos sitios») |
conversation.message | El cliente envía un nuevo mensaje en modo de atención humana |
conversation.closed | La conversación finaliza (data.conversation.closed_by indica quién la cerró) |
conversation.rated | El cliente valoró una conversación finalizada: data.rating, data.comment |
ticket.created | Nuevo ticket (incluye los mensajes que deja el cliente cuando no hay agentes conectados): data.ticket, data.description |
ticket.updated | Cambios en el estado, la prioridad, el responsable, etc. del ticket: data.changes es {字段: [旧, 新]} |
ticket.replied | Un agente respondió al cliente: data.reply |
document.ready / document.failed | El procesamiento del documento se completó o falló |
Una respuesta 2xx se considera correcta; de lo contrario, se reintenta con espera progresiva de 30 segundos, 2 minutos, 10 minutos… hasta un máximo de 12 horas, 8 intentos en total. No se garantiza el orden.
¿Te ha resultado útil esta página?
Última actualización:
