1. Início
  2. Integrações
  3. 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

  1. Nos Webhooks, adicione seu URL https e escolha os eventos; você receberá um segredo de assinatura uma vez.

  2. Quando um evento acontece, nós POSTamos um pequeno documento JSON com um id, o tipo de evento e seus dados.

  3. Seu servidor verifica o cabeçalho X-MotorHangar-Signature com o segredo e responde 2xx.

  4. 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.