Mercateer
Pre vývojárov

Získajte udalosti prednej kancelárie Mercateer ako webhooky

Prihláste koncový bod na udalosti Mercateer a prijmite podpísaný obsah hneď po ukončení hovoru, príchode potenciálneho zákazníka alebo rezervácii práce. Koncové body registrujte a spravujte cez API alebo nástenku a overujte každé doručenie pomocou HMAC.

Čo je Webhooks?

Webhooky odosielať udalosti prednej kancelárie Mercateer v reálnom čase na URL adresu, ktorú ovládate, aby vaše systémy mohli reagovať bez opakovaného dotazovania API. Každé doručenie je JSON obsah podpísaný HMAC, koncové body registrujete a spravujete cez API alebo nástenku a neúspešné pokusy sa opakujú s postupným oneskorením.

Čo môžete robiť s Webhooks

Zachytený nový potenciálny zákazník a vytvorený kontakt
IntegrationPages.Conversation started, closed, or handoff requested
IntegrationPages.Call completed
Termín rezervovaný a termín presunutý
IntegrationPages.Quote accepted
Obsahy podpísané HMAC, ktoré overíte pri prijatí
Registrujte a spravujte koncové body cez API alebo nástenku

Nainštalujte za pár minút

1

Vytvorte koncový bod

Zaregistrujte svoju URL adresu a vyberte udalosti, na ktoré sa chcete prihlásiť – buď cez API alebo v Nastaveniach → Vývojár. Mercateer vráti podpisové tajomstvo pre tento koncový bod. Prístup k API je zahrnutý v plánoch Crew a Fleet.

2

Overte podpis

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

Spracujte opakovania idempotentne

Rýchlo odpovedzte kódom 2xx na potvrdenie doručenia. Neúspešné doručenia sa opakujú s postupným oneskorením, preto naväzujte svoj spracovateľ na ID udalosti, aby ste ignorovali duplikáty a každú udalosť spracovali len raz.

Často kladené otázky

Kompatibilné s celým vaším technologickým zásobníkom

Mercateer používa rovnaké protokoly ako nástroje, ktoré už používate.

Zapojte Mercateer spolu s Webhooks

Začnite zdarma a prepojte svoju recepciu za pár minút.

Bez nutnosti zadávať platobnú kartu