Få Mercateers receptionsrelaterade händelser som webhooks
Prenumerera på en endpoint för Mercateer-händelser och få en signerad dataström direkt när ett samtal avslutas, en lead kommer in eller ett jobb bokas. Registrera och hantera endpoints via API:t eller instrumentpanelen, och verifiera varje leverans med HMAC.
Vad är Webhooks?
Webhooks skickar Mercateers receptionsrelaterade händelser till en URL du styr i realtid, så dina egna system kan reagera utan att behöva polla API:t. Varje leverans är en JSON-dataström signerad med HMAC, du registrerar och hanterar endpoints via API:t eller instrumentpanelen, och misslyckade leveranser försöks igen med exponentiell backoff.
Vad du kan göra med Webhooks
Installera på några minuter
Skapa en endpoint
Registrera din URL och välj vilka händelser du vill prenumerera på – antingen via API:t eller under Inställningar > Utvecklare. Mercateer returnerar en signeringsshemlighet för den endpointen. API-åtkomst ingår i Crew- och Fleet-planerna.
Verifiera signaturen
Läs vid varje leverans tidsstämpeln (t) och signaturen (v1) från signaturhuvudet, räkna sedan ut HMAC-SHA256 för strängen "{timestamp}.{raw request body}" med din signeringsnyckel och jämför med v1-värdet. Avvisa alla anrop som inte stämmer, eller vars tidsstämpel är äldre än 5 minuter, så att du bara agerar på färska data som verkligen kommer från Mercateer. (Verifieringshjälpen i vårt SDK gör allt det här åt dig.)
Hantera återförsök idempotent
Svara snabbt med 2xx för att bekräfta mottagandet. Misslyckade leveranser försöks igen med backoff, så använd händelse-ID:t som nyckel i din hanterare för att ignorera dubbletter och bearbeta varje händelse endast en gång.
Vanliga frågor
Fungerar med hela din teknikstack
Mercateer använder samma protokoll som de verktyg du redan använder.
Sätt igång Mercateer med Webhooks
Börja gratis och anslut ditt receptionsarbete på några minuter.
Inget kreditkort krävs