How do I register a webhook endpoint?

Create the endpoint from the API or in Settings, then Developer, give it your URL, and choose the events to subscribe to. Mercateer returns a signing secret you use to verify deliveries, and you can update or remove the endpoint at any time.

What events can I subscribe to?

New lead captured, contact created, conversation started, conversation handoff requested, conversation closed, call completed, missed call, appointment booked, appointment rescheduled, and quote accepted. Subscribe to all of them or only the ones you need.

How do I verify a delivery came from Mercateer?

Every payload is signed with HMAC-SHA256 using your endpoint secret. Read the timestamp and signature from the signature header, compute the HMAC of "{timestamp}.{raw request body}", and compare it to the signature value, dropping the request if it does not match or if the timestamp is over 5 minutes old. That way a forged or replayed call can never trigger your handler. Our SDK ships a verify helper so you don’t have to implement this by hand.

What happens when my endpoint is down?

Failed deliveries retry with backoff for a window, so a brief outage does not lose events. Make your handler idempotent by keying on the event ID, since a retried delivery can arrive more than once.

Which Mercateer plan do I need?

Webhooks are part of API access, which is included on the Crew and Fleet plans. You can start building free to set up your agent, then upgrade to register endpoints.

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.

Instalirajte za nekoliko minuta Sve integracije

Š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

Razgovor započet, zatvoren ili zatražena predaja čovjeku

Poziv završen

Termin zakazan i termin preusmjeren

Ponuda prihvaćena

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

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.

Provjerite potpis

Pri svakoj isporuci pročitajte vremensku oznaku (t) i potpis (v1) iz zaglavlja s potpisom, zatim izračunajte HMAC-SHA256 niza "{timestamp}.{raw request body}" svojom tajnom za potpisivanje i usporedite ga s vrijednošću v1. Odbijte svaki zahtjev koji se ne podudara ili čija je vremenska oznaka starija od 5 minuta, kako biste obrađivali samo svježe podatke koji su doista stigli iz Mercateera. (Pomoćna funkcija verify u našem SDK-u sve to radi umjesto vas.)

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.

Claude Desktop Claude Code Claude Cowork ChatGPT Cursor Codex OpenCode Zapier n8n Make.com

Pogledajte sve integracije

Stavite Mercateer na posao s Webhooks

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

Započnite besplatno

Nije potrebna kreditna kartica

Primanje Mercateer događaja prednjeg ureda putem webhookova

Što je Webhooks?

Što možete raditi s Webhooks

Instalirajte za nekoliko minuta

Stvorite krajnju točku

Provjerite potpis

Obradite ponovne pokušaje idempotentno

Često postavljana pitanja

Kako registrirati krajnju točku webhooka?

Na koje događaje se mogu pretplatiti?

Kako provjeriti da isporuka dolazi od Mercateera?

Što se dogodi kada je moja krajnja točka nedostupna?

Koji mi Mercateer plan treba?

Radi s vašim cijelim alatnim setom

Stavite Mercateer na posao s Webhooks