Leaper Central de Ajuda
Desenvolvedores Entrar

O que são Webhooks

Entenda como receber notificações automáticas de eventos de leads.

Um webhook é um endereço do seu sistema que a Leaper chama sempre que algo acontece com um lead. Em vez de você perguntar 'tem novidade?' a cada poucos minutos, nós avisamos — a cada lead novo, a cada mudança de etapa. É a forma ideal de integrar a Leaper com CRMs, automações, planilhas ou uma aplicação própria. A parte técnica — estrutura do pacote, verificação da assinatura e tentativas de entrega — está na documentação de webhooks.

Como funciona

  1. 1Configure uma URLEm Configurações → Webhooks, clique em 'Criar Webhook' e informe o endereço do seu sistema que vai receber as chamadas (POST com corpo JSON, via HTTPS).
  2. 2Escolha os eventosMarque quais acontecimentos quer receber: Novo Lead, Mudança de Status, Lead Convertido ou Submissão de Formulário.
  3. 3Receba notificaçõesQuando o evento acontece, a Leaper monta o pacote e o coloca numa fila. Um processo em segundo plano faz a entrega — logo em seguida ao acontecimento, não no exato instante.

Um detalhe que vale conhecer

Os dados do pacote são montados no momento do envio, não quando o evento entrou na fila. Se o lead foi enriquecido nesse intervalo (o nome chegou depois, os dados de campanha foram resolvidos), você já recebe a versão atual. Em compensação, o bloco de status reflete a transição que gerou o evento, então continua descrevendo o que aconteceu.

Casos de uso

  • Integração com CRM — Envie leads automaticamente para Salesforce, HubSpot, Pipedrive, etc.
  • Automação com Zapier/Make — Dispare fluxos automatizados a cada novo lead, conversão ou envio de formulário.
  • Notificações customizadas — Alerte sua equipe via Slack, Discord ou email quando leads importantes chegarem.
  • Sistema próprio — Sincronize os leads com seu próprio banco de dados ou aplicação interna.

Confiabilidade

Se uma entrega falhar (status HTTP diferente de 2xx, erro de conexão ou tempo esgotado), a Leaper tenta reenviar automaticamente — até 3 tentativas no total. Você pode pausar um webhook a qualquer momento sem excluí-lo: enquanto pausado, nada é entregue. São permitidos até 3 webhooks por empresa.