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.

Fejlesztő

Kapja meg a Mercateer ügyfélszolgálati eseményeit webhookokként

Iratkozzon fel egy végpontra a Mercateer eseményeire, és azonnal kapjon aláírt adattartalmat, amint egy hívás véget ér, beérkezik egy érdeklődő, vagy foglalnak egy munkát. Regisztrálja és kezelje a végpontokat az API-n vagy az irányítópulton keresztül, és ellenőrizze minden kézbesítést HMAC-mel.

Telepítés percek alatt Minden integráció

Mi az a Webhooks?

A webhookok valós időben továbbítják a Mercateer ügyfélszolgálati eseményeit az Ön által vezérelt URL-re, így saját rendszerei reagálhatnak API-lekérdezés nélkül. Minden kézbesítés HMAC-mel aláírt JSON-adattartalom, a végpontokat az API-n vagy az irányítópulton keresztül regisztrálhatja és kezelheti, a sikertelen kézbesítéseket pedig exponenciális várakozási idővel újrapróbálják.

Mit tehet Webhooks segítségével

Új érdeklődő rögzítve és kapcsolat létrehozva

Beszélgetés elindult, lezárult, vagy kérték az emberi átadást

Hívás befejezve

Időpont foglalva és időpont átütemezve

Árajánlat elfogadva

HMAC-aláírt adattartalmak, amelyeket kézbesítéskor ellenőriz

Regisztrálja és kezelje a végpontokat az API-n vagy az irányítópulton keresztül

Telepítés percek alatt

Hozzon létre egy végpontot

Regisztrálja az URL-jét, és válassza ki a feliratkozáshoz szükséges eseményeket az API-n vagy a Beállítások > Fejlesztő menüpontban. A Mercateer visszaad egy aláírási titkot ehhez a végponthoz. Az API-hozzáférés része a Crew és Fleet csomagoknak.

Ellenőrizze az aláírást

Minden kézbesítéskor olvassa ki az időbélyeget (t) és az aláírást (v1) az aláírás fejlécéből, majd számítsa ki a „{timestamp}.{raw request body}” karakterlánc HMAC-SHA256 kivonatát az aláírási titkával, és hasonlítsa össze a v1 értékkel. Utasítson el minden olyan kérést, amely nem egyezik, vagy amelynek időbélyege több mint 5 perccel régebbi, így csak a friss, valóban a Mercateertől érkező adattartalmakra reagál. (Az SDK ellenőrző segédprogramja ezt mind megteszi Ön helyett.)

Kezelje az újrapróbálkozásokat idempotensen

Válaszoljon gyorsan 2xx kóddal a kézbesítés visszaigazolásához. A sikertelen kézbesítéseket exponenciális várakozási idővel újrapróbálják, ezért használja az eseményazonosítót kulcsként a kezelőben, hogy figyelmen kívül hagyja a duplikációkat, és minden eseményt csak egyszer dolgozzon fel.

Gyakran ismételt kérdések

Kompatibilis az egész eszköztárával

A Mercateer ugyanazokat a protokollokat használja, mint a már használt eszközei.

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

Minden integráció megtekintése

Használja a Mercateert Webhooks segítségével

Indítson ingyen, és kapcsolja össze elsődleges irodai rendszerét percek alatt.

Indítson ingyen

Hitelkártya nem szükséges

Kapja meg a Mercateer ügyfélszolgálati eseményeit webhookokként

Mi az a Webhooks?

Mit tehet Webhooks segítségével

Telepítés percek alatt

Hozzon létre egy végpontot

Ellenőrizze az aláírást

Kezelje az újrapróbálkozásokat idempotensen

Gyakran ismételt kérdések

Hogyan regisztrálok egy webhook-végpontot?

Milyen eseményekre iratkozhatok fel?

Hogyan ellenőrizhetem, hogy egy kézbesítés tényleg a Mercateertől érkezett?

Mi történik, ha a végpontom nem elérhető?

Melyik Mercateer csomagra van szükségem?

Kompatibilis az egész eszköztárával

Használja a Mercateert Webhooks segítségével