Recibe eventos de la oficina frontal de Mercateer mediante webhooks
Suscribe un endpoint a eventos de Mercateer y recibe una carga útil firmada en el momento en que finalice una llamada, llegue un cliente potencial o se programe un trabajo. Registra y gestiona endpoints desde la API o el panel de control, y verifica cada entrega con HMAC.
¿Qué es Webhooks?
Los webhooks envían eventos de la oficina frontal de Mercateer a una URL bajo tu control en tiempo real, para que tus propios sistemas puedan reaccionar sin tener que sondear la API. Cada entrega es una carga útil JSON firmada con HMAC; registras y gestionas los endpoints desde la API o el panel de control, y las entregas fallidas se reintentan con retroceso exponencial.
Qué puedes hacer con Webhooks
Instala en minutos
Crear un endpoint
Registra tu URL y selecciona los eventos a los que suscribirte, ya sea desde la API o en Ajustes > Desarrollador. Mercateer devuelve un secreto de firma para ese endpoint. El acceso a la API está incluido en los planes Crew y Fleet.
Verifica la firma
IntegrationPages.On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}_{raw request body}" with your signing secret and compare it to the v1 value_ Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer_ (Our SDK’s verify helper does all of this for you_)
Gestiona los reintentos de forma idempotente
Responde con un código 2xx rápidamente para confirmar la entrega. Las entregas fallidas se reintentan con retroceso exponencial, así que indexa tu manejador por el ID del evento para ignorar duplicados y procesar cada evento una sola vez.
Preguntas frecuentes
Funciona con todo tu stack
Mercateer habla los mismos protocolos que las herramientas que ya usas.
Pon Mercateer a trabajar con Webhooks
Empieza gratis y conecta tu recepción en minutos.
No se requiere tarjeta de crédito