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
Lees bij elke levering de tijdstempel (t) en de handtekening (v1) uit de signature-header, bereken vervolgens de HMAC-SHA256 van de tekst "{timestamp}.{raw request body}" met je ondertekeningssleutel en vergelijk die met de waarde van v1. Wijs elk verzoek af dat niet overeenkomt of waarvan de tijdstempel ouder is dan 5 minuten, zodat je alleen verse gegevens verwerkt die echt van Mercateer komen. (De verify-helper in onze SDK doet dit allemaal voor je.)
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