Receber avisos de eventos
Nível: Avançado Tempo de leitura: 5 min Plano necessário: Todos os planos
Por que existe
Sem isso, o seu sistema teria que ficar perguntando de minuto em minuto se chegou mensagem nova, se alguém pediu atendente, se a campanha terminou. Gasta recurso dos dois lados e ainda chega atrasado.
Com os avisos de evento, o caminho inverte. Você registra um endereço, e a Wevichat manda um aviso lá assim que a coisa acontece.
São 30 acontecimentos diferentes, entre eles:
- Cliente mandou mensagem, mensagem entregue, mensagem lida, falha no envio
- Conversa nova, pediram atendente, humano assumiu, devolvida para a IA, encerrada, reaberta
- Cliente avaliou o atendimento
- Contato criado, alterado, mudou de etapa no funil, ganhou ou perdeu dono
- Contato pediu para sair da lista ou voltou a aceitar
- Automação começou, terminou ou falhou
- Campanha começou ou terminou
- Template mudou de status na Meta
Como é diferente das ações do agente
São coisas separadas, e vale não confundir.
| Quem começa | Quando dispara | |
|---|---|---|
| Ações do agente | O agente, durante a conversa | Quando a IA decide que precisa daquilo |
| Avisos de evento | A plataforma | Sempre que o acontecimento ocorre, com ou sem conversa em andamento |
Se você quer que o agente consulte o seu estoque no meio da conversa, use ação do agente. Se você quer saber toda vez que uma conversa for encerrada, use aviso de evento.
Passo a passo
Tenha um endereço pronto para receber. Precisa ser público e em
https. Pode ser um fluxo do n8n, do Make, ou uma rota do seu próprio sistema.Abra a aba Desenvolvedores. No app, clique no seu nome no rodapé do menu lateral e vá em Desenvolvedores.
Cadastre o webhook. Informe o endereço e marque quais acontecimentos você quer receber. Marque só o que vai usar.
Guarde o segredo. Ao criar, aparece um código secreto. Ele aparece uma vez só e é com ele que você confere se o aviso veio mesmo da gente.
Responda rápido. O seu sistema deve responder 200 assim que receber. Se você tiver trabalho pesado para fazer, responda primeiro e processe depois.
Confira a assinatura
Todo aviso chega com um cabeçalho Wevi-Signature. Ele prova que o aviso saiu da Wevichat e que ninguém mexeu no conteúdo pelo caminho.
Sem essa conferência, qualquer pessoa que descubra o seu endereço consegue inventar um evento falso. Se o seu fluxo cria pedido, cobra ou manda mensagem, isso vira um problema de verdade.
Quem usa o nó do n8n não precisa fazer nada: o gatilho já confere sozinho. Quem recebe no próprio sistema encontra o passo a passo em Webhooks na documentação técnica, com exemplo de código.
Se o seu servidor sair do ar
A Wevichat tenta de novo. Se o seu endereço não responder ou devolver erro, o aviso entra na fila e é reenviado com intervalos crescentes.
Você não precisa descobrir isso pelo cliente reclamando. Um webhook que está falhando há mais de uma hora aparece com aviso na tela, em Minha conta → Desenvolvedores, junto da lista de webhooks. Abrindo as entregas, você vê o que o seu servidor respondeu em cada tentativa.
Por isso, o mesmo aviso pode chegar duas vezes. Escreva o seu lado para aguentar isso: antes de agir, verifique se aquele evento já foi tratado, usando o identificador que vem no corpo. É a diferença entre reenviar uma cobrança e ignorar uma repetição.
Dicas para um bom resultado
- Marque só os eventos que você usa. Cada aviso é uma chamada no seu servidor.
- Teste com chave de teste. Os avisos disparam de verdade mesmo em modo de teste, então dá para validar o seu recebedor inteiro sem envolver cliente nenhum.
- Um endereço por finalidade. Um para o CRM, outro para o time interno. Fica fácil desligar um sem afetar o resto.
- Registre o que chegou. Guarde o corpo dos avisos por alguns dias. Quando algo não bater, é o que responde a pergunta.
E depois?
- Conectar a Wevichat ao n8n, o jeito mais fácil de receber e reagir sem escrever código.
- Conectar a Wevichat a outros sistemas, o quadro geral.
- Proteger a sua chave de API.
- Como configurar webhooks personalizados, que são as ações que o agente dispara na conversa.
- Referência técnica de webhooks, com o formato do corpo e o código de conferência da assinatura.