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

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
IntegrationPages.Conversation started, closed, or handoff requested
IntegrationPages.Call completed
Termin gebucht und Termin verschoben
IntegrationPages.Quote accepted
Mit HMAC signierte Nutzlasten, die Sie beim Empfang verifizieren
Endpunkte über die API oder das Dashboard registrieren und verwalten

In Minuten installiert

1

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.

2

Die Signatur verifizieren

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

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.

Setzen Sie Mercateer mit Webhooks ein

Kostenlos starten und Ihr Front Office in Minuten verbinden.

Keine Kreditkarte erforderlich