Corpo
Um JSON com o nome do evento e os dados relacionados (contato, conversa, mensagem, card, ligação ou documento), enviado por POST com Content-Type: application/json.
Automação & APIs
Guia completo de Webhooks
Envie eventos do CRM (mensagens, contatos, conversas, ligações, negócios e documentos) para a URL do seu sistema, em tempo real.
Telas reais da empresa Demo
Reconheça a integração antes de configurar
Os prints não exibem tokens, senhas ou dados de clientes.
Etapa 1 de 2
O que esta integração faz
O Webhook avisa o seu sistema (ERP, n8n, Make, API própria, planilha ou BI) sempre que algo acontece no CRM. A cada evento marcado, o CRM faz um POST em JSON para a URL que você cadastrou, assinado com um segredo exclusivo do webhook. É o caminho inverso do Webhook de Entrada, que recebe dados de fora.
Antes de começar
Tenha uma URL pública com HTTPS pronta para receber POST e responder rápido com um código 2xx. Nunca copie o segredo para conversas ou prints.
Passo a passo completo
- Abra a tela. Em Integrações, abra o card Webhooks e clique em Novo Webhook.
- Informe a URL. Dê um nome e cole o endereço do seu sistema que vai receber os eventos (de preferência HTTPS).
- Marque os eventos. Escolha só o que o seu sistema precisa: mensagens recebidas e enviadas, novo contato, contato atualizado, etiqueta adicionada, status ou atribuição de conversa, ligações (iniciada, atendida, não atendida, encerrada), cards do Kanban (criado, movido, ganho, perdido) e documentos (enviado, visualizado, assinado, concluído, recusado, cancelado, expirado).
- Salve e copie o segredo. O CRM gera um segredo exclusivo para cada webhook. Ele fica oculto no card; use os botões para mostrar, copiar ou gerar um novo.
- Valide a assinatura no seu sistema. Confira cada chamada antes de processar (veja abaixo) e responda com código 2xx.
- Acompanhe. Abra o Histórico de entregas do webhook para ver quando cada evento saiu, a situação e o detalhe da resposta.
O que o seu sistema recebe
Assinatura
Cabeçalhos X-Webhook-Timestamp e X-Webhook-Signature: sha256=…. Calcule HMAC_SHA256(timestamp + "." + corpo_bruto, segredo) e compare com a assinatura; se não bater, descarte a chamada.
Entrega única
X-Webhook-Delivery-Id é igual em todas as tentativas do mesmo evento e X-Webhook-Attempt diz qual é a tentativa. Guarde o Delivery-Id para não processar o mesmo evento duas vezes.
Teste recomendado
Cadastre primeiro uma URL de teste sua (por exemplo, um fluxo do n8n ou um endpoint de homologação), marque um único evento e provoque esse evento com um contato de teste. Confira no Histórico de entregas se a situação ficou como entregue e, no seu sistema, se a assinatura foi validada. Só depois troque para a URL de produção e marque os demais eventos.
Se algo não funcionar
Reenvio automático
Quando a sua URL não pode ser alcançada (falha de rede, DNS lento, conexão recusada), o CRM tenta de novo depois de 1, 5, 15 e 60 minutos. Se o seu sistema respondeu com erro HTTP (404, 500…) ou demorou depois de receber o pedido, não há reenvio: a entrega aconteceu e repetir poderia duplicar o evento.
Resposta lenta
O CRM espera poucos segundos pela resposta. Responda 2xx logo ao receber e faça o processamento pesado em segundo plano.
Assinatura não bate
Use o corpo bruto exatamente como chegou (sem reformatar o JSON) e o segredo atual. Se gerou um segredo novo, atualize-o também no seu sistema.
Evento não chegou
Confira se o evento está marcado no webhook, se o webhook está ativo e o que o Histórico de entregas mostra para aquele horário.
Principais dúvidas
Qual a diferença para o Webhook de Entrada?
Este webhook envia eventos do CRM para fora. O Webhook de Entrada faz o contrário: recebe dados de outro sistema para criar contatos e disparar mensagens.
Posso ter mais de um webhook?
Sim. Cada webhook tem URL, eventos e segredo próprios, e o seu próprio histórico de entregas.
O reenvio pode duplicar um evento?
O reenvio só acontece quando o pedido comprovadamente não chegou ao seu sistema. Mesmo assim, use o X-Webhook-Delivery-Id para ignorar repetições.
Posso pausar sem apagar?
Sim. Edite o webhook e desmarque Ativo; ele deixa de enviar até ser ativado de novo.