Mercateer
Ontwikkelaar

Ontvang Mercateer-voorfrontkantoorgebeurtenisse as webhooks

Teken ’n eindpunt in vir Mercateer-gebeurtenisse en ontvang ’n ondertekende inhoud die oomblik wanneer ’n oproep eindig, ’n potensiële kliënt aankom, of ’n werk bespreek word. Registreer en bestuur eindpunte vanaf die API of paneel, en verifieer elke lewering met HMAC.

Wat is Webhooks?

Webhooks stuur Mercateer-voorfrontkantoorgebeurtenisse in werklike tyd na ’n URL wat jy beheer, sodat jou eie stelsels kan reageer sonder om die API te peil. Elke lewering is ’n JSON-inhoud wat met HMAC onderteken is; jy registreer en bestuur eindpunte vanaf die API of paneel, en mislukte lewerings probeer weer met terugtrekking.

Wat jy met Webhooks kan doen

Nuwe potensiële kliënt vasgevang en kontak geskep
IntegrationPages.Conversation started, closed, or handoff requested
IntegrationPages.Call completed
Afspraak bespreek en afspraak herskeduleer
IntegrationPages.Quote accepted
HMAC-ondertekende inhoud wat jy verifieer by ontvangs
Registreer en bestuur eindpunte vanaf die API of paneel

Installeer binne minute

1

Skep ’n eindpunt

Registreer jou URL en kies die gebeurtenisse waaraan jy wil inteken, vanaf die API of in Instellings, dan Ontwikkelaar. Mercateer gee ’n ondertekeninggeheim vir daardie eindpunt terug. API-toegang is ingesluit op die Crew- en Fleet-planne.

2

Verifieer die handtekening

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

Hanteer herprobeer idempotent

Beantwoord vinnig met 2xx om ’n lewering te bevestig. Mislukte lewerings probeer weer met terugtrekking, dus gebruik die gebeurtenis-ID as sleutel vir jou hanteraar om duplikate te ignoreer en elke gebeurtenis een keer te verwerk.

Gereelde vrae

Werk saam met jou hele stapel

Mercateer gebruik dieselfde protokolle as die gereedskap wat jy reeds gebruik.

Laat Mercateer werk met Webhooks

Begin gratis en koppel jou voorfrontkantoor binne minute.

Geen kredietkaart benodig nie