Formato dos eventos para quem escolhe a versão 2 do webhook.
Em Configurações → Desenvolvedor → Versão do webhook, escolha v2 para receber os eventos neste formato. A troca vale na hora.
Formato
{
"event": "session.assigned", // String. Nome do evento (lista abaixo).
"action": "update", // String. "create" quando o registro é criado, "update" quando muda.
"old": { }, // Objeto | null. Registro antes da mudança; null em "create".
"new": { }, // Objeto. Registro depois da mudança.
"timestamp": "2025-03-14T16:42:03.467677" // String. Momento do evento.
}
old e new trazem o registro da sessão (os mesmos campos de session_data no v1) ou da mensagem (os mesmos campos de message_data).
Eventos
| Evento | action | Quando |
|---|---|---|
session.opened | create | Uma sessão é aberta |
session.assigned | update | A sessão é atribuída a outro usuário |
session.transferred | update | A sessão muda de departamento |
session.closed | update | A sessão é finalizada |
message.received | create | Chega uma mensagem do contato |
message.sent | create | Uma mensagem é enviada ao contato |
message.updated | update | Uma mensagem é alterada |
Se uma mesma atualização da sessão encaixa em mais de um evento, vale o primeiro desta ordem: session.closed, session.transferred, session.assigned.
