How do I register a webhook endpoint?

Create the endpoint from the API or in Settings, then Developer, give it your URL, and choose the events to subscribe to. Mercateer returns a signing secret you use to verify deliveries, and you can update or remove the endpoint at any time.

What events can I subscribe to?

New lead captured, contact created, conversation started, conversation handoff requested, conversation closed, call completed, missed call, appointment booked, appointment rescheduled, and quote accepted. Subscribe to all of them or only the ones you need.

How do I verify a delivery came from Mercateer?

Every payload is signed with HMAC-SHA256 using your endpoint secret. Read the timestamp and signature from the signature header, compute the HMAC of "{timestamp}.{raw request body}", and compare it to the signature value, dropping the request if it does not match or if the timestamp is over 5 minutes old. That way a forged or replayed call can never trigger your handler. Our SDK ships a verify helper so you don’t have to implement this by hand.

What happens when my endpoint is down?

Failed deliveries retry with backoff for a window, so a brief outage does not lose events. Make your handler idempotent by keying on the event ID, since a retried delivery can arrive more than once.

Which Mercateer plan do I need?

Webhooks are part of API access, which is included on the Crew and Fleet plans. You can start building free to set up your agent, then upgrade to register endpoints.

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.

Installation en quelques minutes Toutes les intégrations

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éé

Conversation démarrée, clôturée ou transfert demandé

Appel terminé

Rendez-vous réservé et rendez-vous reprogrammé

Devis accepté

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

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.

Vérifiez la signature

À chaque livraison, lisez l’horodatage (t) et la signature (v1) dans l’en-tête de signature, puis calculez le HMAC-SHA256 de la chaîne "{timestamp}.{raw request body}" avec votre clé de signature et comparez-le à la valeur v1. Rejetez toute requête qui ne correspond pas, ou dont l’horodatage a plus de 5 minutes, afin de ne traiter que des charges utiles récentes provenant réellement de Mercateer. (L’assistant de vérification de notre SDK fait tout cela pour vous.)

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à.

Claude Desktop Claude Code Claude Cowork ChatGPT Cursor Codex OpenCode Zapier n8n Make.com

Voir toutes les intégrations

Mettez Mercateer au travail avec Webhooks

Commencez gratuitement et connectez votre service client en quelques minutes.

Commencer gratuitement

Aucune carte bancaire requise

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

Qu’est-ce que Webhooks ?

Ce que vous pouvez faire avec Webhooks

Installation en quelques minutes

Créer un point de terminaison

Vérifiez la signature

Gérez les nouvelles tentatives de façon idempotente

Questions fréquentes

Comment enregistrer un point de terminaison webhook ?

À quels événements puis-je m’abonner ?

Comment vérifier qu’une livraison provient bien de Mercateer ?

Que se passe-t-il si mon point de terminaison est indisponible ?

Quelle formule Mercateer me faut-il ?

Compatible avec toute votre stack

Mettez Mercateer au travail avec Webhooks

Qu’est-ce que Webhooks ?