1. Inicio
  2. Integraciones
  3. Webhooks

Automatización y API Beta

Webhooks salientes para nuevos leads, coches vendidos y problemas de sincronización

Un webhook es la forma más simple de conectar MotorHangar a cualquier CRM o automatización: llamamos a tu URL en el momento en que ocurre algo en lugar de que tú preguntes cada pocos minutos. Cada entrega está firmada para que puedas verificar que proviene de nosotros, se reintenta si tu servidor está caído, y se lista en tu panel.

Cómo funciona

  1. En Webhooks, añade tu URL https y selecciona los eventos; obtienes un secreto de firma una vez.

  2. Cuando ocurre un evento, publicamos un pequeño documento JSON con un id, el tipo de evento y sus datos.

  3. Tu servidor verifica el encabezado X-MotorHangar-Signature con el secreto y responde 2xx.

  4. Si está caído, intentamos de nuevo después de 1, 5, 30, 120 y 360 minutos; cada entrega se muestra en tu panel.

Qué sincroniza

  • lead.created: un comprador escribió sobre uno de tus autos, con el enlace a la conversación
  • vehicle.sold: un auto se vendió, ya sea que lo vendiste en el panel, por API, por feed o en tu tienda.
  • vehicle.rejected y sync.failed: un auto que falló en la validación, o un feed que no pudo ser leído

Limitaciones

  • Nuevo: construido y probado, aún no comprobado con el CRM en vivo de un concesionario.
  • El email y teléfono de los compradores nunca se incluyen: ellos los comparten en la conversación si desean.
  • Un webhook que falla 20 entregas seguidas se apaga hasta que envíes una prueba desde el panel.

Preguntas sobre Webhooks

¿Cómo sé si un webhook realmente vino de MotorHangar?

Cada solicitud lleva X-MotorHangar-Signature con una marca de tiempo y un HMAC-SHA256 creado con tu secreto. Recomputalo sobre el cuerpo sin procesar y rechaza marcas de tiempo antiguas; /developers/ tiene el código.

¿Pueden n8n o Zapier registrar el webhook por su cuenta?

Sí. POST /webhooks con tu clave API crea uno y devuelve su secreto, y DELETE lo elimina — el patrón que utilizan los nodos de activación para suscribirse y anularse.

¿Recibiré el mismo evento dos veces?

Posiblemente, después de un reintento. Cada entrega lleva el id de evento en X-MotorHangar-Delivery: guárdalo y omite los ids que ya has procesado.