Webhook v2

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

EventoactionQuando
session.openedcreateUma sessão é aberta
session.assignedupdateA sessão é atribuída a outro usuário
session.transferredupdateA sessão muda de departamento
session.closedupdateA sessão é finalizada
message.receivedcreateChega uma mensagem do contato
message.sentcreateUma mensagem é enviada ao contato
message.updatedupdateUma 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.