Mercateer
Utvecklare

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

Ny lead fångad och kontakt skapad
IntegrationPages.Conversation started, closed, or handoff requested
IntegrationPages.Call completed
Tid bokad och tid ombokad
IntegrationPages.Quote accepted
HMAC-signerade dataströmmar som du verifierar vid mottagandet
Registrera och hantera endpoints via API:t eller instrumentpanelen

Installera på några minuter

1

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.

2

Verifiera signaturen

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

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