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.

Entwickler

Empfangen Sie Mercateer Front-Office-Ereignisse als Webhooks

Abonnieren Sie einen Endpunkt für Mercateer-Ereignisse und erhalten Sie sofort eine signierte Nutzlast, sobald ein Anruf endet, ein Lead eingeht oder ein Auftrag gebucht wird. Registrieren und verwalten Sie Endpunkte über die API oder das Dashboard und verifizieren Sie jede Zustellung mit HMAC.

In Minuten installiert Alle Integrationen

Was ist Webhooks?

Webhooks übermitteln Mercateer Front-Office-Ereignisse in Echtzeit an eine von Ihnen kontrollierte URL, sodass Ihre eigenen Systeme reagieren können, ohne die API abfragen zu müssen. Jede Zustellung ist eine mit HMAC signierte JSON-Nutzlast; Sie registrieren und verwalten Endpunkte über die API oder das Dashboard, und fehlgeschlagene Zustellungen werden mit exponentiellem Backoff erneut versucht.

Was Sie mit Webhooks tun können

Neuer Lead erfasst und Kontakt erstellt

Konversation gestartet, geschlossen oder Übergabe angefordert

Anruf beendet

Termin gebucht und Termin verschoben

Angebot angenommen

Mit HMAC signierte Nutzlasten, die Sie beim Empfang verifizieren

Endpunkte über die API oder das Dashboard registrieren und verwalten

In Minuten installiert

Einen Endpunkt erstellen

Registrieren Sie Ihre URL und wählen Sie die Ereignisse aus, auf die Sie abonnieren möchten – entweder über die API oder unter Einstellungen > Entwickler. Mercateer gibt Ihnen dafür ein Signing Secret zurück. Der API-Zugriff ist in den Crew- und Fleet-Tarifen enthalten.

Die Signatur verifizieren

Lesen Sie bei jeder Zustellung den Zeitstempel (t) und die Signatur (v1) aus dem Signatur-Header, berechnen Sie dann den HMAC-SHA256 der Zeichenkette "{timestamp}.{raw request body}" mit Ihrem Signing-Secret und vergleichen Sie ihn mit dem Wert v1. Weisen Sie jede Anfrage zurück, die nicht übereinstimmt oder deren Zeitstempel älter als 5 Minuten ist, damit Sie nur auf frische Payloads reagieren, die wirklich von Mercateer stammen. (Der Verify-Helper unseres SDK erledigt das alles für Sie.)

Wiederholungen idempotent verarbeiten

Antworten Sie schnell mit einem 2xx-Status, um eine Zustellung zu bestätigen. Fehlgeschlagene Zustellungen werden mit Backoff erneut versucht – daher sollten Sie Ihren Handler am Event-ID orientieren, um Duplikate zu ignorieren und jedes Ereignis nur einmal zu verarbeiten.

Häufig gestellte Fragen

Funktioniert mit Ihrem gesamten Tech-Stack

Mercateer spricht dieselben Protokolle wie die Tools, die Sie bereits nutzen.

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

Alle Integrationen anzeigen

Setzen Sie Mercateer mit Webhooks ein

Kostenlos starten und Ihr Front Office in Minuten verbinden.

Kostenlos starten

Keine Kreditkarte erforderlich

Empfangen Sie Mercateer Front-Office-Ereignisse als Webhooks

Was ist Webhooks?

Was Sie mit Webhooks tun können

In Minuten installiert

Einen Endpunkt erstellen

Die Signatur verifizieren

Wiederholungen idempotent verarbeiten

Häufig gestellte Fragen

Wie registriere ich einen Webhook-Endpunkt?

Auf welche Ereignisse kann ich abonnieren?

Wie verifiziere ich, dass eine Zustellung von Mercateer stammt?

Was passiert, wenn mein Endpunkt nicht erreichbar ist?

Welchen Mercateer-Tarif benötige ich?

Funktioniert mit Ihrem gesamten Tech-Stack

Setzen Sie Mercateer mit Webhooks ein