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

Installation en quelques minutes Toutes les intégrations

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

Nouvelle opportunité captée et contact créé

Conversation démarrée, fermée ou transfert demandé

Appel terminé

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

Soumission acceptée

Charges utiles signées HMAC que vous vérifiez à la réception

Inscrivez et gérez les points de terminaison depuis 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, 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

À 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 secret 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 n'agir que sur des données récentes provenant réellement de Mercateer. (La fonction 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 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à.

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 à la clientèle en quelques minutes.

Commencer gratuitement

Aucune carte de crédit requise

Recevez les événements du service à la clientèle de Mercateer sous forme de 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équemment posées

Comment inscrire 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 hors ligne ?

Quel forfait Mercateer ai-je besoin ?

Compatible avec toute votre pile technologique

Mettez Mercateer au travail avec Webhooks

Qu’est-ce que Webhooks ?