Webhooks: configurando eventos e payload

2 visualizações Atualizado em 02/04/2026 webhooks, API, integração, eventos, payload, real-time

Webhooks — Notificações em Tempo Real

Webhooks permitem que o CAR DATA HUB notifique seu sistema externo instantaneamente quando eventos importantes ocorrem.

Criando um webhook

Acesse Configurações → Integrações → Webhooks → Novo e configure:

URL do endpoint — URL HTTPS do seu sistema que receberá as notificações
Eventos — Quais eventos devem disparar o webhook
Secret — Chave secreta para validar a autenticidade das requisições

Eventos disponíveis

lead.created — Novo lead capturado
sale.completed — Venda registrada e confirmada
ticket.created — Novo ticket de suporte aberto
ticket.updated — Status de ticket alterado
payment.received — Pagamento confirmado no financeiro
contract.signed — Contrato assinado digitalmente
vehicle.sold — Veículo marcado como vendido
testimonial.approved — Depoimento aprovado pelo admin

Estrutura do payload

{
  "event": "sale.completed",
  "timestamp": "2026-03-16T14:30:00-03:00",
  "tenant_id": 1,
  "data": {
    "sale_id": 4521,
    "vehicle_id": 892,
    "customer_id": 1043,
    "value": 85000.00
  }
}

Validando a assinatura

Valide cada requisição usando HMAC-SHA256 com o secret configurado e o header X-CardataHub-Signature. Rejeite requisições com assinatura inválida.

Retry automático

Em caso de falha (timeout ou status >= 400), o sistema tenta novamente após 5 min, 30 min, 2h e 12h. Após 4 tentativas sem sucesso, o webhook é marcado como falho e o administrador é notificado.

Este artigo foi útil?