Ontvang Mercateer frontoffice-events als webhooks
Abonneer een endpoint op Mercateer-events en ontvang direct een ondertekende payload zodra een gesprek eindigt, een lead binnenkomt of een klus wordt ingepland. Registreer en beheer endpoints via de API of het dashboard, en verifieer elke levering met HMAC.
Wat is Webhooks?
Webhooks sturen Mercateer frontoffice-events in realtime naar een URL die u beheert, zodat uw eigen systemen kunnen reageren zonder de API te pollen. Elke levering is een JSON-payload ondertekend met HMAC; u registreert en beheert endpoints via de API of het dashboard, en mislukte leveringen worden met backoff opnieuw geprobeerd.
Wat je kunt doen met Webhooks
Installeer binnen enkele minuten
Maak een endpoint aan
Registreer uw URL en kies de events waarop u zich wilt abonneren, via de API of onder Instellingen > Ontwikkelaar. Mercateer retourneert een ondertekeningsgeheim voor die endpoint. API-toegang is inbegrepen bij de Crew- en Fleet-abonnementen.
Verifieer de handtekening
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_)
Verwerk herhaalpogingen idempotent
Reageer snel met een 2xx-status om een levering te bevestigen. Mislukte leveringen worden met backoff opnieuw geprobeerd; gebruik daarom het event-ID als sleutel in uw handler om duplicaten te negeren en elk event maar één keer te verwerken.
Veelgestelde vragen
Werkt met je volledige stack
Mercateer spreekt dezelfde protocollen als de tools die je al gebruikt.
Zet Mercateer aan het werk met Webhooks
Begin gratis en koppel je frontoffice binnen enkele minuten.
Geen creditcard vereist