- Início
- Integrações
- Webhooks
Automação e API Beta
Webhooks de saída para novos leads, carros vendidos e problemas de sincronização
Um webhook é a maneira mais simples de conectar o MotorHangar a qualquer CRM ou automação: chamamos sua URL no momento em que algo acontece em vez de você perguntar a cada poucos minutos. Cada entrega é assinada para que você possa verificar que veio de nós, tentada novamente se seu servidor estiver fora, e listada em seu painel.
Como funciona
Nos Webhooks, adicione seu URL https e escolha os eventos; você receberá um segredo de assinatura uma vez.
Quando um evento acontece, nós POSTamos um pequeno documento JSON com um id, o tipo de evento e seus dados.
Seu servidor verifica o cabeçalho X-MotorHangar-Signature com o segredo e responde 2xx.
Se estiver fora do ar, tentamos novamente após 1, 5, 30, 120 e 360 minutos; cada entrega aparece em seu painel.
O que sincroniza
- lead.created: um comprador escreveu sobre um dos seus carros, com o link para a conversa
- vehicle.sold: um carro foi vendido, seja você o vendeu no painel, pela API, pelo feed ou na sua loja
- vehicle.rejected e sync.failed: um carro que falhou na validação, ou um feed que não pôde ser lido
Limitações
- Novo: construído e testado, ainda não comprovado com o CRM ao vivo de uma concessionária.
- O e-mail e o telefone dos compradores nunca são incluídos: eles os compartilham na conversa se quiserem.
- Um webhook que falha 20 entregas seguidas é desligado até que você envie um teste do painel.
Perguntas sobre Webhooks
Como sei se um webhook realmente veio do MotorHangar?
Cada solicitação carrega X-MotorHangar-Signature com um timestamp e um HMAC-SHA256 feito com seu segredo. Recalcule-o sobre o corpo bruto e rejeite timestamps antigos; /developers/ tem o código.
n8n ou Zapier podem registrar o webhook por conta própria?
Sim. POST /webhooks com sua chave API cria um e retorna seu segredo, e DELETE o remove — o padrão que os nós do gatilho usam para inscrever e desinscrever.
Eu receberei o mesmo evento duas vezes?
Possivelmente, após uma nova tentativa. Cada entrega carrega o id do evento em X-MotorHangar-Delivery: armazene-o e pule ids que você já processou.
Os nomes dos produtos pertencem aos seus proprietários. A MotorHangar não está afiliada ou respaldada por eles, e nenhuma dessas integrações está listada em suas lojas de aplicativos ou marketplaces.