Recibe eventos de la oficina frontal de Mercateer como webhooks
Suscribe un endpoint a eventos de Mercateer y recibe una carga útil firmada en el momento en que finalice una llamada, llegue un lead o se programe un trabajo. Registra y gestiona endpoints desde la API o el panel, y verifica cada entrega con HMAC.
¿Qué es Webhooks?
Los webhooks envían eventos de la oficina frontal de Mercateer a una URL que tú controlas en tiempo real, para que tus propios sistemas puedan reaccionar sin consultar periódicamente la API. Cada entrega es una carga útil JSON firmada con HMAC; registras y gestionas endpoints desde la API o el panel, y las entregas fallidas se reintentan con retroceso exponencial.
Qué puedes hacer con Webhooks
Instala en minutos
Crea un endpoint
Registra tu URL y elige los eventos a los que suscribirte, ya sea desde la API o en Configuración > 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) del encabezado de firma, luego 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 solicitud que no coincida o cuya marca de tiempo tenga más de 5 minutos, para actuar solo sobre datos recientes que de verdad vinieron de Mercateer. (La función de verificación de nuestro SDK hace todo esto por ti.)
Maneja los reintentos de forma idempotente
Responde rápidamente con un código 2xx para confirmar la entrega. Las entregas fallidas se reintentan con retroceso exponencial, así que usa el ID del evento como clave en tu manejador para ignorar duplicados y procesar cada evento una sola vez.
Preguntas frecuentes
Funciona con todo tu stack
Mercateer usa los mismos protocolos que las herramientas que ya utilizas.
Pon a trabajar a Mercateer con Webhooks
Empieza gratis y conecta tu oficina principal en minutos.
No se requiere tarjeta de crédito