POST en JSON a la URL configurada, con los datos de la conversación y del contacto. Opcionalmente, el payload puede incluir el resumen generado por Tino, el historial de mensajes y la nota CSAT.
La configuración está en Configurações > Integrações > Webhooks > Finalização de Atendimento (Configuraciones > Integraciones > Webhooks > Finalización de Atendimiento) (talk.saninternet.com/settings/webhooks).
El disparo ocurre cuando la conversación se finaliza de hecho. Esto incluye la finalización manual por el agente, el cierre automático por inactividad y la finalización después de la evaluación CSAT (con o sin respuesta del cliente).
Configuración
1
Activa el webhook
En Configurações > Integrações > Webhooks > Finalização de Atendimento, activa la llave Ativar webhook (Activar webhook).
2
Indica la URL de destino
El endpoint de tu sistema que recibirá el
POST. Indica la URL completa, incluyendo el protocolo (http:// o https://).3
Genera el secret de firma
Haz clic en Gerar novo secret (Generar nuevo secret) y guarda el valor con seguridad. Se usará para validar la autenticidad de cada entrega.
4
Elige el contenido del payload
Conversación y contacto siempre se envían. También puedes incluir el resumen de Tino, el historial de mensajes y la nota CSAT.
5
Define el filtro de relevancia (opcional)
Con Registrar apenas atendimentos relevantes (Registrar solo atendimientos relevantes) activo, las conversaciones triviales (como un saludo sin continuación) no se envían a tu sistema.
6
Prueba la entrega
El botón Testar webhook (Probar webhook) envía una entrega de prueba a la URL configurada, para validar la integración antes de activarla.
Identificando al cliente: el ID externo
Para que tu sistema sepa a qué cliente pertenece el atendimiento, cada contacto de Tartini tiene un campo ID externo: un código libre que hace referencia al cliente en tu sistema (por ejemplo, su ID en tu ERP o CRM). El agente define ese valor en el panel de detalles del contacto, dentro del Inbox. Una vez completado, acompaña al contacto en todas las finalizaciones futuras y llega en el payload comocontact.externalId.
Formato del payload
Campos especiales
Cuando el resumen generado por Tino está habilitado, la entrega espera la generación del resumen y puede demorar algunos minutos respecto al cierre de la conversación.
Entrega y respuesta
- El
POSTse envía conContent-Type: application/json. - Tu endpoint debe responder con estado
2xxpara confirmar la recepción.
Headers enviados
Validando la firma
Toda entrega se firma con HMAC-SHA256 usando el secret configurado, enviado en el headerX-Webhook-Signature. Las solicitudes con firma inválida deben rechazarse.