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.

Kehittäjä

Hanki Mercateerin etuosaston tapahtumat webhookkeina

Tilaa päätepiste Mercateerin tapahtumiin ja vastaanota allekirjoitettu hyötykuorma heti kun puhelu päättyy, potentiaalinen asiakas saapuu tai työ varataan. Rekisteröi ja hallitse päätepisteitä API:n tai hallintapaneelin kautta ja varmista jokainen toimitus HMAC:lla.

Asennus minuuteissa Kaikki integraatiot

Mikä on Webhooks?

Webhookit työntävät Mercateerin etuosaston tapahtumat hallitsemaasi URL-osoitteeseen reaaliajassa, jotta omat järjestelmäsi voivat reagoida ilman API-kyselyjen tekemistä. Jokainen toimitus on HMAC:lla allekirjoitettu JSON-hyötykuorma, rekisteröit ja hallitset päätepisteitä API:n tai hallintapaneelin kautta ja epäonnistuneet toimitukset yrittävät uudelleen viiveellä.

Mitä voit tehdä Webhooks:n kanssa

Uusi potentiaalinen asiakas tallennettu ja yhteystieto luotu

Keskustelu alkanut, suljettu tai siirtoa ihmiselle pyydetty

Puhelu päättynyt

Tapaaminen varattu ja tapaaminen siirretty

Hinta-arvio hyväksytty

HMAC:lla allekirjoitetut hyötykuormat, jotka varmistat vastaanotettaessa

Rekisteröi ja hallitse päätepisteitä API:n tai hallintapaneelin kautta

Asennus minuuteissa

Luo päätepiste

Rekisteröi URL-osoitteesi ja valitse tilattavat tapahtumat API:n tai Asetukset > Kehittäjä -osion kautta. Mercateer palauttaa allekirjoitussalaisuuden kyseiselle päätepisteelle. API-käyttö sisältyy Crew- ja Fleet-suunnitelmiin.

Varmista allekirjoitus

Lue jokaisen toimituksen yhteydessä aikaleima (t) ja allekirjoitus (v1) allekirjoitusotsakkeesta, laske sitten merkkijonon "{timestamp}.{raw request body}" HMAC-SHA256 allekirjoitussalaisuudellasi ja vertaa sitä v1-arvoon. Hylkää jokainen pyyntö, joka ei täsmää tai jonka aikaleima on yli 5 minuuttia vanha, jotta käsittelet vain tuoreita ja aidosti Mercateerilta tulleita viestejä. (SDK:mme verify-apufunktio hoitaa tämän kaiken puolestasi.)

Käsittele uudelleenyritykset idempotentisti

Vastaa nopeasti 2xx-vastauksella vahvistaaksesi toimituksen. Epäonnistuneet toimitukset yrittävät uudelleen viiveellä, joten avaa käsittelijäsi tapahtumatunnuksella ohittaaksesi kaksoiskappaleet ja käsittelemään jokaisen tapahtuman vain kerran.

Usein kysytyt kysymykset

Toimii koko työkalupaketissasi

Mercateer käyttää samoja protokollia kuin työkalut, joita käytät jo nyt.

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

Näytä kaikki integraatiot

Ota Mercateer käyttöön Webhooks:n kanssa

Aloita ilmaiseksi ja yhdistä etuosasto muutamassa minuutissa.

Aloita ilmaiseksi

Luottokorttia ei vaadita

Hanki Mercateerin etuosaston tapahtumat webhookkeina

Mikä on Webhooks?

Mitä voit tehdä Webhooks:n kanssa

Asennus minuuteissa

Luo päätepiste

Varmista allekirjoitus

Käsittele uudelleenyritykset idempotentisti

Usein kysytyt kysymykset

Miten rekisteröin webhook-päätepisteen?

Mihin tapahtumiin voin tilata?

Miten voin varmistaa, että toimitus on peräisin Mercateerilta?

Mitä tapahtuu, jos päätepisteeni on alas?

Minkä Mercateer-suunnitelman tarvitsen?

Toimii koko työkalupaketissasi

Ota Mercateer käyttöön Webhooks:n kanssa