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
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_)
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