Tema
Catálogo de eventos
Todos os eventos que um webhook pode assinar, com um exemplo do corpo enviado. Todo envio tem o mesmo envelope:
json
{ "id": "<uuid do evento>", "evento": "<nome>", "criado_em": "<ISO 8601>", "dados": { } }idé o mesmo em todas as tentativas e reenvios do evento. Use para ignorar duplicados (veja Idempotência).- Envios de Enviar teste trazem
"teste": trueno envelope. - Eventos de conversa e mensagem trazem
dados.conversaedados.contatono formato das rotas da API; os eventos que vêm da linha do tempo da conversa trazem tambémdados.evento_interno. - Campos novos podem aparecer com o tempo. Ignore o que você não conhece.
Resumo
| Evento | Quando |
|---|---|
mensagem.recebida | O cliente mandou mensagem. |
mensagem.enviada | A equipe, o robô ou a API mandou mensagem. |
mensagem.entregue | O WhatsApp confirmou a entrega de uma mensagem enviada. |
mensagem.lida | O cliente leu uma mensagem enviada. |
mensagem.nota_interna | Alguém da equipe (ou a IA) escreveu uma nota interna na conversa. |
mensagem_agendada.enviada | Uma mensagem agendada saiu na hora marcada. |
conversa.criada | Começou uma conversa nova. |
conversa.atribuida | Alguém assumiu ou recebeu a conversa. |
conversa.transferida | A conversa mudou de setor ou de pessoa. |
conversa.encerrada | A conversa foi encerrada. |
conversa.reaberta | Uma conversa encerrada foi reaberta. |
conversa.na_fila | A conversa entrou na fila de um setor, esperando alguém. |
conversa.adiada | A conversa foi adiada (soneca) até uma data. |
conversa.prioridade_alterada | A prioridade da conversa mudou. |
conversa.sla_estourado | O prazo da primeira resposta do setor estourou. |
conversa.transferida_para_humano | O agente de IA passou a conversa para a equipe. |
csat.recebido | O cliente deu a nota do atendimento. |
contato.criado | Um contato novo foi cadastrado (mensagem, painel, API, importação ou fluxo). |
contato.alterado | Nome, telefone, e-mail ou campos do contato mudaram. |
contato.etiqueta_adicionada | O contato ganhou uma ou mais etiquetas. |
contato.etiqueta_removida | O contato perdeu uma ou mais etiquetas. |
contato.bloqueado | O contato foi bloqueado. |
contato.descadastrado | O contato pediu para não receber mais mensagens (opt-out). |
ticket.criado | A conta abriu um ticket de suporte. |
ticket.atualizado | O ticket mudou de status ou prioridade, ou recebeu resposta. |
ticket.resolvido | O suporte marcou o ticket como resolvido. |
lead.criado | Um lead novo entrou na prospecção. |
lead.etapa_alterada | O lead mudou de etapa no funil. |
lead.visita_agendada | O lead marcou reunião ou visita (etapa "agendado"). |
campanha.iniciada | A campanha começou a enviar. |
campanha.concluida | A campanha terminou de enviar para todo o público. |
campanha.resposta | Um contato respondeu a uma campanha. |
campanha.descadastro | Um contato respondeu SAIR a uma campanha. |
ligacao.recebida | Um cliente está ligando pelo WhatsApp. |
ligacao.perdida | Uma ligação recebida não foi atendida (perdida ou recusada). |
ligacao.encerrada | Uma ligação terminou (atendida, perdida, recusada ou que falhou). |
canal.desconectado | Um WhatsApp que estava conectado caiu. |
canal.reconectado | Um WhatsApp voltou a ficar conectado. |
Mensagens
mensagem.recebida
O cliente mandou mensagem.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "mensagem.recebida",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"mensagem": {
"id": 99120,
"conversa_id": 4821,
"direcao": "entrada",
"autor": "contato",
"autor_nome": null,
"tipo": "texto",
"texto": "Meu site está fora do ar",
"midia": null,
"status": null,
"criado_em": "2026-10-30T14:02:11.000Z"
}
}
}mensagem.enviada
A equipe, o robô ou a API mandou mensagem.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "mensagem.enviada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"mensagem": {
"id": 99120,
"conversa_id": 4821,
"direcao": "saida",
"autor": "usuario",
"autor_nome": "Ana Lima",
"tipo": "texto",
"texto": "Olá, Maria! Já estou verificando.",
"midia": null,
"status": "enviada",
"criado_em": "2026-10-30T14:02:11.000Z"
}
}
}mensagem.entregue
O WhatsApp confirmou a entrega de uma mensagem enviada.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "mensagem.entregue",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"mensagem": {
"id": 99120,
"conversa_id": 4821,
"direcao": "saida",
"autor": "usuario",
"autor_nome": "Ana Lima",
"tipo": "texto",
"texto": "Olá, Maria! Já estou verificando.",
"midia": null,
"status": "entregue",
"criado_em": "2026-10-30T14:02:11.000Z"
}
}
}mensagem.lida
O cliente leu uma mensagem enviada.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "mensagem.lida",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"mensagem": {
"id": 99120,
"conversa_id": 4821,
"direcao": "saida",
"autor": "usuario",
"autor_nome": "Ana Lima",
"tipo": "texto",
"texto": "Olá, Maria! Já estou verificando.",
"midia": null,
"status": "lida",
"criado_em": "2026-10-30T14:02:11.000Z"
}
}
}mensagem.nota_interna
Alguém da equipe (ou a IA) escreveu uma nota interna na conversa.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "mensagem.nota_interna",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"mensagem": {
"id": 99120,
"conversa_id": 4821,
"direcao": "saida",
"autor": "usuario",
"autor_nome": "Ana Lima",
"tipo": "texto",
"texto": "@Pedro pode olhar o DNS deste cliente?",
"midia": null,
"status": null,
"criado_em": "2026-10-30T14:02:11.000Z",
"privada": true
}
}
}mensagem_agendada.enviada
Uma mensagem agendada saiu na hora marcada.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "mensagem_agendada.enviada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "agendada_enviada",
"agendada_id": 55,
"nome": "Ana Lima",
"reaberta": false
}
}Conversas
conversa.criada
Começou uma conversa nova.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "conversa.criada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "criada",
"canal": "WhatsApp Comercial",
"origem": null
}
}conversa.atribuida
Alguém assumiu ou recebeu a conversa.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "conversa.atribuida",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "atribuida",
"usuario_id": 12,
"modo": "assumiu"
}
}conversa.transferida
A conversa mudou de setor ou de pessoa.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "conversa.transferida",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "transferida",
"para_setor": 2,
"nome": "Suporte técnico",
"de_setor": "Comercial"
}
}conversa.encerrada
A conversa foi encerrada.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "conversa.encerrada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "encerrada",
"motivo": "Resolvido"
}
}conversa.reaberta
Uma conversa encerrada foi reaberta.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "conversa.reaberta",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "reaberta"
}
}conversa.na_fila
A conversa entrou na fila de um setor, esperando alguém.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "conversa.na_fila",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "fila",
"setor_id": 2,
"setor": "Suporte técnico",
"motivo": "fluxo"
}
}conversa.adiada
A conversa foi adiada (soneca) até uma data.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "conversa.adiada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "adiada",
"ate": "2026-10-31T09:00:00.000Z"
}
}conversa.prioridade_alterada
A prioridade da conversa mudou.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "conversa.prioridade_alterada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "prioridade",
"de": "normal",
"para": "urgente"
}
}conversa.sla_estourado
O prazo da primeira resposta do setor estourou.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "conversa.sla_estourado",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "sla_estourado"
}
}conversa.transferida_para_humano
O agente de IA passou a conversa para a equipe.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "conversa.transferida_para_humano",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "ia_transferiu",
"agente_id": 4,
"motivo": "pediu_humano",
"detalhe": "O cliente pediu para falar com uma pessoa."
}
}csat.recebido
O cliente deu a nota do atendimento.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "csat.recebido",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "csat",
"nota": 5
}
}Contatos
contato.criado
Um contato novo foi cadastrado (mensagem, painel, API, importação ou fluxo).
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "contato.criado",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
],
"campos": {
"empresa": "Souza Design",
"cidade": "Maringá"
},
"bloqueado": false,
"criado_em": "2026-03-12T10:20:00.000Z",
"atualizado_em": "2026-10-30T14:02:11.000Z"
}
}
}contato.alterado
Nome, telefone, e-mail ou campos do contato mudaram.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "contato.alterado",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
],
"campos": {
"empresa": "Souza Design",
"cidade": "Maringá"
},
"bloqueado": false,
"criado_em": "2026-03-12T10:20:00.000Z",
"atualizado_em": "2026-10-30T14:02:11.000Z"
},
"alterados": [
"email",
"campos"
]
}
}contato.etiqueta_adicionada
O contato ganhou uma ou mais etiquetas.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "contato.etiqueta_adicionada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
],
"campos": {
"empresa": "Souza Design",
"cidade": "Maringá"
},
"bloqueado": false,
"criado_em": "2026-03-12T10:20:00.000Z",
"atualizado_em": "2026-10-30T14:02:11.000Z"
},
"etiquetas": [
"plano-pro"
]
}
}contato.etiqueta_removida
O contato perdeu uma ou mais etiquetas.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "contato.etiqueta_removida",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
],
"campos": {
"empresa": "Souza Design",
"cidade": "Maringá"
},
"bloqueado": false,
"criado_em": "2026-03-12T10:20:00.000Z",
"atualizado_em": "2026-10-30T14:02:11.000Z"
},
"etiquetas": [
"teste-gratis"
]
}
}contato.bloqueado
O contato foi bloqueado.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "contato.bloqueado",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
],
"campos": {
"empresa": "Souza Design",
"cidade": "Maringá"
},
"bloqueado": true,
"criado_em": "2026-03-12T10:20:00.000Z",
"atualizado_em": "2026-10-30T14:02:11.000Z"
},
"motivo": "Spam"
}
}contato.descadastrado
O contato pediu para não receber mais mensagens (opt-out).
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "contato.descadastrado",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
],
"campos": {
"empresa": "Souza Design",
"cidade": "Maringá"
},
"bloqueado": false,
"criado_em": "2026-03-12T10:20:00.000Z",
"atualizado_em": "2026-10-30T14:02:11.000Z",
"opt_out_em": "2026-10-30T14:02:11.000Z"
}
}
}Tickets de suporte
ticket.criado
A conta abriu um ticket de suporte.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "ticket.criado",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"ticket": {
"id": 311,
"numero": 1311,
"assunto": "Não consigo conectar o WhatsApp",
"categoria": "problema_tecnico",
"prioridade": "alta",
"status": "novo",
"criado_em": "2026-10-29T09:10:00.000Z",
"atualizado_em": "2026-10-30T11:45:00.000Z",
"primeira_resposta_em": null,
"resolvido_em": null
}
}
}ticket.atualizado
O ticket mudou de status ou prioridade, ou recebeu resposta.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "ticket.atualizado",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"ticket": {
"id": 311,
"numero": 1311,
"assunto": "Não consigo conectar o WhatsApp",
"categoria": "problema_tecnico",
"prioridade": "alta",
"status": "em_andamento",
"criado_em": "2026-10-29T09:10:00.000Z",
"atualizado_em": "2026-10-30T11:45:00.000Z",
"primeira_resposta_em": "2026-10-29T09:40:00.000Z",
"resolvido_em": null
},
"mudancas": [
"status",
"resposta"
],
"status_anterior": "novo"
}
}ticket.resolvido
O suporte marcou o ticket como resolvido.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "ticket.resolvido",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"ticket": {
"id": 311,
"numero": 1311,
"assunto": "Não consigo conectar o WhatsApp",
"categoria": "problema_tecnico",
"prioridade": "alta",
"status": "resolvido",
"criado_em": "2026-10-29T09:10:00.000Z",
"atualizado_em": "2026-10-30T11:45:00.000Z",
"primeira_resposta_em": "2026-10-29T09:40:00.000Z",
"resolvido_em": "2026-10-30T16:00:00.000Z"
}
}
}Leads (Agente SDR)
lead.criado
Um lead novo entrou na prospecção.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "lead.criado",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"lead": {
"id": 5120,
"nome": "Carlos Pereira",
"telefone": "+5511988887777",
"email": "[email protected]",
"negocio": "Padaria Pereira",
"cidade": "São Paulo",
"site": null,
"origem": "planilha",
"etiquetas": [
"padaria"
],
"etapa": "novo",
"campanha_id": 8,
"contato_id": 917,
"conversa_id": null,
"criado_em": "2026-10-28T08:00:00.000Z",
"atualizado_em": "2026-10-30T14:02:11.000Z"
}
}
}lead.etapa_alterada
O lead mudou de etapa no funil.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "lead.etapa_alterada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"lead": {
"id": 5120,
"nome": "Carlos Pereira",
"telefone": "+5511988887777",
"email": "[email protected]",
"negocio": "Padaria Pereira",
"cidade": "São Paulo",
"site": null,
"origem": "planilha",
"etiquetas": [
"padaria"
],
"etapa": "qualificado",
"campanha_id": 8,
"contato_id": 917,
"conversa_id": 4821,
"criado_em": "2026-10-28T08:00:00.000Z",
"atualizado_em": "2026-10-30T14:02:11.000Z"
},
"de": "respondeu",
"para": "qualificado"
}
}lead.visita_agendada
O lead marcou reunião ou visita (etapa "agendado").
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "lead.visita_agendada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"lead": {
"id": 5120,
"nome": "Carlos Pereira",
"telefone": "+5511988887777",
"email": "[email protected]",
"negocio": "Padaria Pereira",
"cidade": "São Paulo",
"site": null,
"origem": "planilha",
"etiquetas": [
"padaria"
],
"etapa": "agendado",
"campanha_id": 8,
"contato_id": 917,
"conversa_id": 4821,
"criado_em": "2026-10-28T08:00:00.000Z",
"atualizado_em": "2026-10-30T14:02:11.000Z"
},
"de": "qualificado"
}
}Campanhas
campanha.iniciada
A campanha começou a enviar.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "campanha.iniciada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"campanha": {
"id": 42,
"nome": "Black Friday clientes ativos",
"status": "enviando",
"canal": {
"id": 3,
"nome": "WhatsApp Comercial"
},
"total": 1250,
"enviadas": 0,
"entregues": 0,
"lidas": 0,
"respostas": 0,
"falhas": 0,
"iniciada_em": "2026-11-27T12:00:00.000Z",
"concluida_em": null
}
}
}campanha.concluida
A campanha terminou de enviar para todo o público.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "campanha.concluida",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"campanha": {
"id": 42,
"nome": "Black Friday clientes ativos",
"status": "concluida",
"canal": {
"id": 3,
"nome": "WhatsApp Comercial"
},
"total": 1250,
"enviadas": 1238,
"entregues": 1201,
"lidas": 940,
"respostas": 133,
"falhas": 12,
"iniciada_em": "2026-11-27T12:00:00.000Z",
"concluida_em": "2026-11-27T15:40:00.000Z"
}
}
}campanha.resposta
Um contato respondeu a uma campanha.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "campanha.resposta",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "campanha_resposta",
"campanha_id": 42,
"nome": "Black Friday clientes ativos",
"saiu": false
}
}campanha.descadastro
Um contato respondeu SAIR a uma campanha.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "campanha.descadastro",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "campanha_resposta",
"campanha_id": 42,
"nome": "Black Friday clientes ativos",
"saiu": true
}
}Ligações
ligacao.recebida
Um cliente está ligando pelo WhatsApp.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "ligacao.recebida",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "ligacao_recebida",
"ligacao": {
"id": 77,
"status": "tocando",
"direcao": "entrada",
"duracao_s": null
}
}
}ligacao.perdida
Uma ligação recebida não foi atendida (perdida ou recusada).
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "ligacao.perdida",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "ligacao",
"id": 77,
"status": "perdida",
"direcao": "entrada",
"duracao_s": null
}
}ligacao.encerrada
Uma ligação terminou (atendida, perdida, recusada ou que falhou).
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "ligacao.encerrada",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"conversa": {
"id": 4821,
"protocolo": 104821,
"status": "aberta",
"canal": {
"id": 3,
"tipo": "cloud",
"nome": "WhatsApp Comercial"
},
"setor": {
"id": 2,
"nome": "Suporte técnico"
},
"atendente": {
"id": 12,
"nome": "Ana Lima"
},
"prioridade": "normal",
"ultima_mensagem": "Meu site está fora do ar",
"ultima_mensagem_em": "2026-10-30T14:02:11.000Z",
"criado_em": "2026-10-30T13:58:40.000Z",
"encerrada_em": null,
"motivo_encerramento": null,
"aguardando_desde": "2026-10-30T14:02:11.000Z",
"primeira_resposta_em": "2026-10-30T14:00:05.000Z",
"primeira_resposta_segundos": 85
},
"contato": {
"id": 917,
"nome": "Maria Souza",
"telefone": "+5544999998888",
"email": "[email protected]",
"etiquetas": [
"cliente",
"plano-pro"
]
},
"evento_interno": "ligacao",
"id": 77,
"status": "encerrada",
"direcao": "entrada",
"duracao_s": 192
}
}Canais
canal.desconectado
Um WhatsApp que estava conectado caiu.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "canal.desconectado",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"canal": {
"id": 3,
"tipo": "evolution",
"nome": "WhatsApp Comercial",
"status_conexao": "close"
},
"de": "conectado",
"para": "close"
}
}canal.reconectado
Um WhatsApp voltou a ficar conectado.
json
{
"id": "6b0c3f0e-8a51-4d1e-9f4e-0c2b7a9d1e55",
"evento": "canal.reconectado",
"criado_em": "2026-10-30T14:02:12.000Z",
"dados": {
"canal": {
"id": 3,
"tipo": "evolution",
"nome": "WhatsApp Comercial",
"status_conexao": "conectado"
},
"de": "close",
"para": "conectado"
}
}De onde vêm
Contatos, leads, tickets, campanhas (início e fim) e canais são registrados pelo próprio banco de dados no momento da gravação, venha a mudança do painel, da API, de um fluxo, de uma importação ou do suporte. Chegam em até alguns segundos.