14 de novembro de 2026
O webhook de lead, e como ligar na conta de um cliente
Guia de uso para o time. Serve para quando o cliente tem uma página, um formulário ou uma ferramenta fora da plataforma e quer que o contato caia no Atendimento dele.
O que é
Na configuração do CRM existe a aba Webhook. O cliente cria um webhook com um nome e recebe duas coisas: um endereço e uma chave, só dele. Quem tiver os dois consegue criar lead na conta dele, e nada além disso.
Cada página, formulário ou ferramenta ganha o seu. Dá para desligar um sem derrubar os outros, e o histórico mostra separado o que cada um mandou.
Isso substitui a resposta antiga de "não dá". Antes só as nossas próprias páginas conseguiam mandar lead para dentro, porque o caminho descobria de qual cliente era o lead pelo endereço do site, e não pedia chave nenhuma.
O caminho do lead, desenhado
Da página do cliente até a conversa no WhatsApp, com as duas escolhas que ele faz na tela.
Como ligar, passo a passo
- Abrir Configurações do CRM e a aba Webhook.
- Clicar em Novo webhook e dar um nome que diga de onde vem, por exemplo o nome da página.
- Escolher a fila que recebe, e o prompt se a conta usa mais de um.
- Decidir se o lead só entra no Atendimento ou se recebe um modelo oficial de mensagem.
- Se a página for enviar pelo navegador, adicionar o domínio dela em Sites que podem enviar.
- Copiar o endereço e a chave. A chave aparece uma vez só.
- Usar o botão Como enviar: ele mostra o exemplo pronto para colar no e-mail de quem vai programar.
- Usar Enviar lead de teste e conferir o card no Atendimento.
Para a pessoa que vai programar existe um documento próprio, feito para ser enviado: o guia do cliente.
As escolhas da tela
| Campo | O que decide |
|---|---|
| Fila que recebe | quem do time fica com esses leads |
| Etiqueta de campanha | como esses leads aparecem separados nos relatórios |
| Prompt | qual personalidade da I.A. atende esse lead |
| Quando o lead chegar | só criar o lead no Atendimento, ou mandar um modelo oficial de mensagem para abrir a conversa |
| Sites que podem enviar | de quais endereços aceitamos o envio |
A lista de modelos só deixa escolher o que serve para abrir conversa. Modelo que pede imagem no cabeçalho ou link variável no botão aparece com o motivo e não pode ser selecionado, porque sairia recusado pelo WhatsApp em todo envio.
A regra que vale sempre
Se a mensagem de abertura não sair, por qualquer motivo, o lead entra do mesmo jeito e o histórico diz por quê.
O histórico, e o que cada estado quer dizer
Cada webhook tem o seu histórico, com as últimas 50 tentativas. Toda tentativa deixa linha, inclusive a que foi recusada.
| Estado | O que aconteceu |
|---|---|
| Entrou | o lead foi criado, ou caiu numa conversa que já existia |
| Repetido | o mesmo telefone chegou duas vezes em menos de um minuto, que é o duplo clique no formulário |
| Recusado | não virou lead, e o motivo está escrito na linha |
Os motivos de recusa mais comuns: chave ausente ou inválida, webhook desligado, site fora da lista, faltou nome ou telefone, telefone que não é um número válido.
O que responder quando perguntarem
- Pediram a URL: é o endereço que aparece na linha do webhook, junto com a chave.
- A chave se perdeu: clicar em Trocar. O endereço continua o mesmo, e a chave antiga para de funcionar na hora.
- O lead não chegou: abrir o Histórico daquele webhook e ler o motivo.
- O lead chegou mas não recebeu mensagem: ou o webhook está em só criar o lead, ou a abertura falhou, e o motivo está no histórico.
- Querem mandar um campo que não existe aqui: pode mandar, vai para o comentário do lead sem precisar de nada do nosso lado.
- Medir a página de fora: o Analytics da plataforma não enxerga página hospedada em outro lugar.
A chave é como uma senha
Quando a própria página envia pelo navegador, a chave fica visível no código dela. É por isso que existe a lista de sites: com ela preenchida, só esses endereços podem enviar. Sem nenhum site na lista, qualquer lugar pode enviar, que é o certo para quem envia pelo servidor.
Documento interno · 14 de novembro de 2026 · guia para enviar ao cliente