Recevez les événements du service à la clientèle de Mercateer sous forme de webhooks
Abonnez un point de terminaison aux événements Mercateer et recevez une charge utile signée dès qu’un appel se termine, qu’une opportunité arrive ou qu’un travail est réservé. Inscrivez et gérez vos points de terminaison depuis l’API ou le tableau de bord, et vérifiez chaque livraison à l’aide d’HMAC.
Qu’est-ce que Webhooks ?
Les webhooks transmettent en temps réel les événements du service à la clientèle de Mercateer vers une URL que vous contrôlez, afin que vos propres systèmes puissent réagir sans interroger l’API. Chaque livraison est une charge utile JSON signée avec HMAC, vous inscrivez et gérez les points de terminaison depuis l’API ou le tableau de bord, et les livraisons échouées sont relancées avec un délai croissant.
Ce que vous pouvez faire avec Webhooks
Installation en quelques minutes
Créer un point de terminaison
Enregistrez votre URL et choisissez les événements auxquels vous abonner, depuis l’API ou dans Paramètres, puis Développeur. Mercateer vous retourne une clé secrète de signature pour ce point de terminaison. L’accès à l’API est inclus aux forfaits Crew et Fleet.
Vérifiez la signature
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_)
Gérez les nouvelles tentatives de façon idempotente
Répondez rapidement avec un code 2xx pour accuser réception d’une livraison. Les livraisons échouées sont relancées avec un délai croissant, alors identifiez votre gestionnaire à l’aide de l’ID d’événement pour ignorer les doublons et traiter chaque événement une seule fois.
Questions fréquemment posées
Compatible avec toute votre pile technologique
Mercateer utilise les mêmes protocoles que les outils que vous utilisez déjà.
Mettez Mercateer au travail avec Webhooks
Commencez gratuitement et connectez votre service à la clientèle en quelques minutes.
Aucune carte de crédit requise