Mercateer
Développeur

Recevez les événements d’accueil Mercateer via des webhooks

Abonnez une URL à des événements Mercateer et recevez une charge utile signée dès qu’un appel se termine, qu’un prospect arrive ou qu’une intervention est réservée. Enregistrez et gérez vos points de terminaison via l’API ou le tableau de bord, et vérifiez chaque livraison grâce à HMAC.

Qu’est-ce que Webhooks ?

Les webhooks transmettent en temps réel les événements d’accueil Mercateer vers une URL que vous contrôlez, permettant à vos systèmes de réagir sans interroger régulièrement l’API. Chaque livraison est une charge utile JSON signée avec HMAC ; vous enregistrez et gérez vos points de terminaison via l’API ou le tableau de bord, et les échecs de livraison sont automatiquement relancés avec un délai croissant.

Ce que vous pouvez faire avec Webhooks

Nouveau prospect capté et contact créé
IntegrationPages.Conversation started, closed, or handoff requested
IntegrationPages.Call completed
Rendez-vous réservé et rendez-vous reprogrammé
IntegrationPages.Quote accepted
Charges utiles signées HMAC que vous vérifiez à la réception
Enregistrez et gérez vos points de terminaison via l’API ou le tableau de bord

Installation en quelques minutes

1

Créer un point de terminaison

Enregistrez votre URL et choisissez les événements auxquels vous abonner, via l’API ou dans Paramètres > Développeur. Mercateer vous renvoie une clé secrète de signature propre à ce point de terminaison. L’accès à l’API est inclus dans les formules Crew et Fleet.

2

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

3

Gérez les nouvelles tentatives de façon idempotente

Répondez rapidement avec un code 2xx pour accuser réception. En cas d’échec, les livraisons sont relancées avec un délai croissant : identifiez votre gestionnaire par l’ID d’événement afin d’ignorer les doublons et de traiter chaque événement une seule fois.

Questions fréquentes

Compatible avec toute votre stack

Mercateer parle les mêmes protocoles que les outils que vous utilisez déjà.

Mettez Mercateer au travail avec Webhooks

Commencez gratuitement et connectez votre service client en quelques minutes.

Aucune carte bancaire requise