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.

Dezvoltator

Primirea evenimentelor din biroul frontal Mercateer ca webhook-uri

Abonați un endpoint la evenimentele Mercateer și primiți un payload semnat imediat ce se încheie un apel, sosește un prospect sau se programează o lucrare. Înregistrați și gestionați endpoint-urile din API sau din tabloul de bord și verificați fiecare livrare folosind HMAC.

Instalează în câteva minute Toate integrările

Ce este Webhooks?

Webhook-urile trimit evenimentele din biroul frontal Mercateer către o adresă URL controlată de dumneavoastră în timp real, astfel încât propriile dvs. sisteme pot reacționa fără a interoga API-ul periodic. Fiecare livrare este un payload JSON semnat cu HMAC, înregistrați și gestionați endpoint-urile din API sau din tabloul de bord, iar livrările eșuate se reîncearcă cu întârzieri crescătoare.

Ce poți face cu Webhooks

Prospect capturat și contact creat

Conversație începută, închisă sau preluare solicitată

Apel încheiat

Programare efectuată și programare reprogramată

Ofertă acceptată

Payload-uri semnate cu HMAC pe care le verificați la primire

Înregistrați și gestionați endpoint-urile din API sau din tabloul de bord

Instalează în câteva minute

Creați un endpoint

Înregistrați adresa dvs. URL și selectați evenimentele la care vreți să vă abonați, fie din API, fie în Secțiuni → Dezvoltator. Mercateer returnează o cheie secretă de semnare pentru acel endpoint. Accesul la API este inclus în planurile Crew și Fleet.

Verificați semnătura

La fiecare livrare, citește marca de timp (t) și semnătura (v1) din antetul semnăturii, apoi calculează HMAC-SHA256 al șirului "{timestamp}.{raw request body}" cu secretul tău de semnare și compară-l cu valoarea v1. Respinge orice cerere care nu se potrivește sau a cărei marcă de timp este mai veche de 5 minute, ca să acționezi doar pe baza datelor proaspete, venite cu adevărat de la Mercateer. (Funcția de verificare din SDK-ul nostru face tot acest lucru în locul tău.)

Gestionați reîncercările în mod idempotent

Răspundeți rapid cu un cod 2xx pentru a confirma primirea. Livrările eșuate se reîncearcă cu întârzieri crescătoare, așa că bazați gestiunea pe ID-ul evenimentului pentru a ignora duplicatele și a procesa fiecare eveniment o singură dată.

Întrebări frecvente

Funcționează cu întreaga ta stivă tehnologică

Mercateer folosește aceleași protocoale ca și instrumentele pe care le folosești deja.

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

Vezi toate integrările

Pune Mercateer la treabă cu Webhooks

Începe gratuit și conectează-ți biroul frontal în câteva minute.

Începe gratuit

Nu este necesară carte de credit

Primirea evenimentelor din biroul frontal Mercateer ca webhook-uri

Ce este Webhooks?

Ce poți face cu Webhooks

Instalează în câteva minute

Creați un endpoint

Verificați semnătura

Gestionați reîncercările în mod idempotent

Întrebări frecvente

Cum înregistrez un endpoint webhook?

La ce evenimente mă pot abona?

Cum verific dacă o livrare provine din Mercateer?

Ce se întâmplă când endpoint-ul meu este indisponibil?

De ce plan Mercateer am nevoie?

Funcționează cu întreaga ta stivă tehnologică

Pune Mercateer la treabă cu Webhooks