Få Mercateer frontkontor-hendelser som webhooks
Abonner en endepunkt på Mercateer-hendelser og motta en signert data-pakke det øyeblikket en samtale avsluttes, en lead kommer inn eller en jobb bookes. Registrer og administrer endepunkter via API-et eller dashbordet, og verifiser hver leveranse med HMAC.
Hva er Webhooks?
Webhooks sender Mercateer frontkontor-hendelser til en URL du kontrollerer i sanntid, slik at dine egne systemer kan reagere uten å måtte spørre API-et. Hver leveranse er en JSON-data-pakke signert med HMAC, du registrerer og administrerer endepunkter via API-et eller dashbordet, og mislykkede leveranser prøves på nytt med eksponentiell ventetid.
Hva du kan gjøre med Webhooks
Installer på få minutter
Opprett et endepunkt
Registrer din URL og velg hvilke hendelser du vil abonnere på – enten via API-et eller i Innstillinger > Utvikler. Mercateer returnerer en signeringhemmelighet for dette endepunktet. API-tilgang er inkludert i Crew- og Fleet-abonnementene.
Verifiser signaturen
Ved hver levering leser du tidsstempelet (t) og signaturen (v1) fra signaturheaderen, regner ut HMAC-SHA256 av strengen "{timestamp}.{raw request body}" med signeringsnøkkelen din og sammenligner den med v1-verdien. Avvis alle forespørsler som ikke stemmer, eller der tidsstempelet er mer enn 5 minutter gammelt, slik at du bare handler på ferske data som virkelig kommer fra Mercateer. (Verifiseringsfunksjonen i SDK-en vår gjør alt dette for deg.)
Behandle gjentakelser idempotent
Svar raskt med 2xx for å bekrefte mottak. Mislykkede leveranser prøves på nytt med eksponentiell ventetid, så bruk hendelses-ID-en som nøkkel i din håndterer for å ignorere duplikater og behandle hver hendelse kun én gang.
Ofte stilte spørsmål
Fungerer med hele din verktøykasse
Mercateer bruker de samme protokollene som verktøyene du allerede bruker.
Bruk Mercateer sammen med Webhooks
Begynn gratis og koble resepsjonen din på få minutter.
Ingen kredittkort kreves