Mercateer
Razvojni programeri

Primanje Mercateer događaja prednjeg ureda putem webhookova

Pretplatite krajnju točku na Mercateer događaje i primajte potpisani sadržaj u trenutku kada se poziv završi, kada pristigne potencijalni klijent ili kada se posao zaključa. Registrirajte i upravljajte krajnjim točkama putem API-ja ili nadzorne ploče te provjeravajte svaku isporuku HMAC-om.

Što je Webhooks?

Webhookovi guraju Mercateer događaje prednjeg ureda na URL koji kontrolirate u stvarnom vremenu, tako da vaši sustavi mogu reagirati bez upita API-ju. Svaka isporuka je JSON sadržaj potpisan HMAC-om, registrirate i upravljate krajnjim točkama putem API-ja ili nadzorne ploče, a neuspjele isporuke se ponavljaju s eksponencijalnim kašnjenjem.

Što možete raditi s Webhooks

Novi potencijalni klijent uhvaćen i kontakt stvoren
IntegrationPages.Conversation started, closed, or handoff requested
IntegrationPages.Call completed
Termin zakazan i termin preusmjeren
IntegrationPages.Quote accepted
HMAC-potpisani sadržaji koje provjeravate pri primanju
Registrirajte i upravljajte krajnjim točkama putem API-ja ili nadzorne ploče

Instalirajte za nekoliko minuta

1

Stvorite krajnju točku

Registrirajte svoj URL i odaberite događaje na koje želite pretplatiti se, putem API-ja ili u Postavkama, zatim Razvoj. Mercateer vraća tajni ključ za tu krajnju točku. Pristup API-ju uključen je u planovima Crew i Fleet.

2

Provjerite potpis

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

Obradite ponovne pokušaje idempotentno

Brzo odgovorite 2xx kodom kako biste potvrdili isporuku. Neuspjele isporuke se ponavljaju s eksponencijalnim kašnjenjem, pa temeljite svoj rukovatelj na ID-u događaja kako biste zanemarili duplikate i obradili svaki događaj samo jednom.

Često postavljana pitanja

Radi s vašim cijelim alatnim setom

Mercateer koristi iste protokole kao i alati koje već koristite.

Stavite Mercateer na posao s Webhooks

Započnite besplatno i povežite svoj poslovni prijem za nekoliko minuta.

Nije potrebna kreditna kartica