Skip to main content
El Webhook de Atendimiento notifica a tu sistema externo cada vez que una conversación se finaliza en Tartini. En cada cierre, Tartini envía un 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 como contact.externalId.
Cuando el ID externo no esté completado, contact.externalId llega como null. El payload también trae contact.phoneNumber.

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 POST se envía con Content-Type: application/json.
  • Tu endpoint debe responder con estado 2xx para confirmar la recepción.

Headers enviados


Validando la firma

Toda entrega se firma con HMAC-SHA256 usando el secret configurado, enviado en el header X-Webhook-Signature. Las solicitudes con firma inválida deben rechazarse.
El secret nunca viaja en las solicitudes. Si se filtra, genera uno nuevo en la pantalla de configuración y guarda. Las próximas entregas pasan a usar el nuevo valor de inmediato.