Pular para o conteúdo

Webhooks — Eventos disponíveis

O webhook da conta aceita treze eventos. Cada webhook escolhe quais quer receber.

EventoQuando dispara
conversation_createdUma conversa nova é aberta
conversation_updatedQualquer campo da conversa muda — responsável, equipe, prioridade, atributo
conversation_status_changedO status muda: aberta, pendente, adiada, resolvida
conversation_typing_onAlguém começou a digitar
conversation_typing_offParou de digitar
EventoQuando dispara
message_createdMensagem nova, recebida ou enviada
message_updatedUma 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.

EventoQuando dispara
contact_createdContato novo
contact_updatedQualquer campo do contato muda
EventoQuando dispara
inbox_createdUma caixa nova é conectada
inbox_updatedA configuração de uma caixa muda
EventoQuando dispara
webwidget_triggeredO visitante abriu o chat do site
conversion_event_createdUma 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.

O formulário de webhook mostra dez opções. Estes três o backend aceita, mas a tela não oferece:

  • inbox_created
  • inbox_updated
  • conversion_event_created

Para assinar qualquer um deles, cadastre o webhook pela API, mandando a lista no campo subscriptions. Veja gerenciar webhooks.

Terminal window
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"]
}'

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 → Ganho
AÇÃO Enviar webhook → o seu endereço

Ali 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.

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.