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.

Pro vývojáře

Získejte události z přední kanceláře Mercateer jako webhooky

Přihlaste si koncový bod k událostem Mercateer a okamžitě po ukončení hovoru, příchodu potenciálního zákazníka nebo rezervaci zakázky obdržíte podepsaný datový balíček. Koncové body registrujte a spravujte přes API nebo ovládací panel a ověřujte každé doručení pomocí HMAC.

Nainstalujte během několika minut Všechny integrace

Co je Webhooks?

Webhooky posílají události z přední kanceláře Mercateer v reálném čase na vámi řízenou URL adresu, aby vaše systémy mohly reagovat bez opakovaného dotazování API. Každé doručení je JSON datový balíček podepsaný HMAC, koncové body registrujete a spravujete přes API nebo ovládací panel a neúspěšná doručení se opakují s exponenciálním zpožděním.

Co můžete dělat s Webhooks

Nový potenciální zákazník zachycen a kontakt vytvořen

Zahájená nebo uzavřená konverzace, případně žádost o předání člověku

Dokončený hovor

Termín zakázky rezervován a termín zakázky změněn

Přijatá cenová nabídka

Datové balíčky podepsané HMAC, které ověříte při přijetí

Registrujte a spravujte koncové body přes API nebo ovládací panel

Nainstalujte během několika minut

Vytvořte koncový bod

Zaregistrujte svou URL a vyberte události, ke kterým se chcete přihlásit – buď přes API, nebo v Nastavení → Vývojář. Mercateer vrátí podepisovací tajný klíč pro daný koncový bod. Přístup k API je součástí plánů Crew a Fleet.

Ověřte podpis

Při každém doručení přečtěte z hlavičky s podpisem časové razítko (t) a podpis (v1), pak spočítejte HMAC-SHA256 řetězce "{timestamp}.{raw request body}" se svým podpisovým tajemstvím a porovnejte ho s hodnotou v1. Každý požadavek, který nesedí nebo jehož časové razítko je starší než 5 minut, odmítněte, abyste reagovali jen na čerstvá data, která opravdu přišla z Mercateeru. (Ověřovací pomocník v našem SDK tohle všechno udělá za vás.)

Zpracovávejte opakování idempotentně

Rychle odpovězte kódem 2xx pro potvrzení doručení. Neúspěšná doručení se opakují s exponenciálním zpožděním, proto svůj handler zaměřte na ID události, aby ignoroval duplikáty a každou událost zpracoval jen jednou.

Časté dotazy

Kompatibilní se všemi vašimi nástroji

Mercateer komunikuje stejnými protokoly jako nástroje, které již používáte.

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

Zobrazit všechny integrace

Nasazení Mercateer společně s Webhooks

Začněte zdarma a propojte svou recepci během několika minut.

Začít zdarma

Bez nutnosti zadat platební kartu

Získejte události z přední kanceláře Mercateer jako webhooky

Co je Webhooks?

Co můžete dělat s Webhooks

Nainstalujte během několika minut

Vytvořte koncový bod

Ověřte podpis

Zpracovávejte opakování idempotentně

Časté dotazy

Jak zaregistruji koncový bod webhooku?

Ke kterým událostem se mohu přihlásit?

Jak ověřím, že doručení pochází od Mercateer?

Co se stane, když bude můj koncový bod nedostupný?

Který tarif Mercateer potřebuji?

Kompatibilní se všemi vašimi nástroji

Nasazení Mercateer společně s Webhooks