Saltar al contenido principal

Webhooks

Fin de Sesión de WhatsApp

Envía una notificación HTTP a tu endpoint cuando se cierra una conversación de WhatsApp con uno de tus agentes: tras la espera sin mensajes, unos minutos después de que el agente termina el chat, o cuando una plantilla que enviaste no recibe respuesta. Consulta Conversaciones de WhatsApp para saber cuándo pasa cada caso.

Configuración​

Este evento usa el campo webhook de fin de llamada del agente, la misma dirección que recibe Fin de Llamada para las llamadas (pestaña Instrucciones, sección Para desarrollador; consulta General). Para un agente que atiende WhatsApp, cada conversación que se cierra se envía ahí, incluidas las que se cierran sin respuesta del contacto.

Entrega​

  • Método: POST
  • Content-Type: application/json
  • Autorización: ninguna. La petición no incluye header Authorization.
  • Reintentos: ninguno. La petición se envía una sola vez.

Payload​

startedAtstring
Fecha y hora del primer mensaje de la sesión, en ISO 8601.
messagesarray
Los mensajes de la sesión, del más antiguo al más nuevo (como máximo los últimos 200).
analysis.summarystring
Resumen de la conversación. Vacío si el contacto nunca escribió.
analysis.structuredDataobject
Variables de salida que capturó el agente. Vacío si el contacto nunca escribió.
analysis.successEvaluationboolean
Opcional. Si la conversación cumplió los criterios de éxito del agente. Solo aparece si el agente tiene criterios de éxito; false si el contacto nunca escribió.

Detalle de los mensajes​

Cada elemento de messages tiene:

  • role: user para el contacto, assistant para el agente (incluidas las plantillas que enviaste)
  • message: el texto del mensaje

Responder a los eventos​

Devuelve cualquier código HTTP 2xx para confirmar la recepción. El cuerpo de la respuesta se ignora.

Cualquier otra respuesta, o un error de red, cuenta como entrega fallida. El evento no se vuelve a enviar, y la tarjeta de sesión en la bandeja Mensajes del dashboard muestra Falló el webhook.