Webhooks de Saída
Os Webhooks de Saída enviam dados de leads do LeadHub para uma URL externa sempre que um evento de lead ocorre. Use-os para sincronizar leads com um CRM, acionar fluxos no Zapier ou notificar sistemas externos.
Como Funcionam os Webhooks de Saída
- Você cria um webhook de saída com uma URL de destino e os eventos a monitorar.
- Quando o evento selecionado ocorre (ex.: novo lead criado), o LeadHub envia uma requisição HTTP POST para sua URL.
- O payload é um objeto JSON contendo os dados completos do lead.
Criando um Webhook de Saída
- Vá para Integrações → Webhooks de Saída.
- Clique em Novo Webhook de Saída.
- Configure:
| Campo | Descrição |
|---|---|
| Nome | Nome interno (ex.: "Sincronizar com HubSpot") |
| URL | O endpoint externo que recebe o POST |
| Eventos | Quais eventos acionam este webhook (veja abaixo) |
| Segredo | Segredo HMAC opcional para verificação de assinatura da requisição |
| Ativo | Alternar para habilitar ou desabilitar |
- Clique em Salvar.
Eventos Disponíveis
| Evento | Quando é acionado |
|---|---|
lead.created | Um novo registro de lead é criado |
lead.updated | Um lead é modificado |
lead.deleted | Um lead é excluído |
lead.stage_changed | Um lead avança para um novo estágio do pipeline |
lead.assigned | Um lead é atribuído a um usuário |
form.submitted | Um envio de formulário é recebido |
Formato do Payload
Todos os webhooks de saída enviam um corpo JSON via POST:
{
"event": "lead.created",
"occurred_at": "2026-04-29T10:30:00Z",
"lead": {
"id": 123,
"first_name": "Jane",
"last_name": "Smith",
"email": "[email protected]",
"phone": "+1-555-000-0000",
"source": "web_form",
"status": "new",
"lead_score": 45,
"pipeline": "Sales Pipeline",
"stage": "New Lead",
"assigned_to": "[email protected]",
"tags": ["vip", "from-webinar"],
"created_at": "2026-04-29T10:30:00Z"
}
}
Verificação de Assinatura HMAC
Se você definir um Segredo, o LeadHub assina cada requisição com uma assinatura HMAC-SHA256.
A assinatura é enviada no cabeçalho X-LeadHub-Signature.
Para verificar (exemplo em PHP):
$computed = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (!hash_equals($computed, $_SERVER['HTTP_X_LEADHUB_SIGNATURE'])) {
http_response_code(401);
exit;
}
Entrega e Novas Tentativas de Webhook
O LeadHub entrega webhooks de forma assíncrona via fila. Se o endpoint externo retornar uma resposta não 2xx, a entrega é tentada novamente até 3 vezes com backoff exponencial.
Consulte o Log de Webhook para revisar o histórico de entregas.
Desabilitar vs Excluir
- Desabilitar: Alterne Ativo para desligado — nenhum evento é enviado, mas o webhook é preservado.
- Excluir: Remove permanentemente a configuração do webhook.