Webhooks — Eventos disponíveis
O webhook da conta aceita treze eventos. Cada webhook escolhe quais quer receber.
Conversas
Seção intitulada “Conversas”| Evento | Quando dispara |
|---|---|
conversation_created | Uma conversa nova é aberta |
conversation_updated | Qualquer campo da conversa muda — responsável, equipe, prioridade, atributo |
conversation_status_changed | O status muda: aberta, pendente, adiada, resolvida |
conversation_typing_on | Alguém começou a digitar |
conversation_typing_off | Parou de digitar |
Mensagens
Seção intitulada “Mensagens”| Evento | Quando dispara |
|---|---|
message_created | Mensagem nova, recebida ou enviada |
message_updated | Uma mensagem existente muda — inclusive o status de entrega |
message_created vale para os dois sentidos. Use o message_type do payload para separar o que o cliente mandou do que a equipe respondeu.
Contatos
Seção intitulada “Contatos”| Evento | Quando dispara |
|---|---|
contact_created | Contato novo |
contact_updated | Qualquer campo do contato muda |
Caixas de entrada
Seção intitulada “Caixas de entrada”| Evento | Quando dispara |
|---|---|
inbox_created | Uma caixa nova é conectada |
inbox_updated | A configuração de uma caixa muda |
Site e conversão
Seção intitulada “Site e conversão”| Evento | Quando dispara |
|---|---|
webwidget_triggered | O visitante abriu o chat do site |
conversion_event_created | Uma conversão foi registrada — formulário enviado, clique em WhatsApp, landing page, plugin do site ou API |
O conversion_event_created é o mais útil para integração de marketing: é ele que avisa, na hora, que entrou lead novo com a origem junto. Veja eventos de conversão.
Três não aparecem na tela
Seção intitulada “Três não aparecem na tela”O formulário de webhook mostra dez opções. Estes três o backend aceita, mas a tela não oferece:
inbox_createdinbox_updatedconversion_event_created
Para assinar qualquer um deles, cadastre o webhook pela API, mandando a lista no campo subscriptions. Veja gerenciar webhooks.
curl -X POST "https://app.smart2.com.br/api/v1/accounts/1/webhooks" \ -H "api_access_token: SEU_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "url": "https://seusistema.com.br/webhooks/smart?k=segredo", "subscriptions": ["conversion_event_created", "contact_created"] }'Não existe evento de negócio
Seção intitulada “Não existe evento de negócio”Nenhum evento de funil entra aqui: negócio criado, movido de etapa, ganho ou perdido não disparam o webhook da conta.
Para reagir a negócio, o caminho é outro e é melhor — a automação do funil:
GATILHO Status do negócio alterado → GanhoAÇÃO Enviar webhook → o seu endereçoAli você escolhe o gatilho com precisão — entrou numa etapa específica, saiu de outra, passou do tempo, mudou de valor —, e vê a execução. Veja automações do funil.
O mesmo vale para tarefa, ticket e contato: o workflow tem ação de enviar webhook, com o gatilho que você precisar.
Como escolher o que assinar
Seção intitulada “Como escolher o que assinar”Assine pouco. Cada evento assinado é uma chamada ao seu servidor. conversation_updated e message_created numa operação movimentada são milhares por dia.
Comece pelo que dispara ação. Se o seu sistema só precisa saber de lead novo, conversion_event_created e contact_created resolvem — e o volume é pequeno.
Deixe os de digitação para último. conversation_typing_on e off só fazem sentido para quem está construindo uma interface de atendimento própria.
Próximos passos
Seção intitulada “Próximos passos”- Payloads — o que vem em cada evento
- Segurança do webhook
- Entrega e falhas