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
En cada entrega, lee la marca de tiempo (t) y la firma (v1) de la cabecera de firma, calcula el HMAC-SHA256 de la cadena "{timestamp}.{raw request body}" con tu secreto de firma y compáralo con el valor v1. Rechaza cualquier petición que no coincida, o cuya marca de tiempo tenga más de 5 minutos, para actuar solo sobre payloads recientes que vengan realmente de Mercateer. (El ayudante de verificación de nuestro SDK hace todo esto por ti.)
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