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.

Pembangun

Dapatkan acara pejabat hadapan Mercateer sebagai webhook

Langgan titik akhir kepada acara Mercateer dan terima muatan bertandatangan sebaik sahaja panggilan tamat, prospek masuk, atau kerja ditempah. Daftar dan urus titik akhir melalui API atau papan pemuka, dan sahkan setiap penghantaran dengan HMAC.

Pasang dalam beberapa minit Semua integrasi

Apakah Webhooks?

Webhook menolak acara pejabat hadapan Mercateer ke URL yang anda kawal secara masa nyata, supaya sistem anda sendiri boleh bertindak balas tanpa perlu membuat polling API. Setiap penghantaran ialah muatan JSON yang ditandatangani dengan HMAC, anda mendaftar dan mengurus titik akhir melalui API atau papan pemuka, dan penghantaran gagal akan dicuba semula dengan jeda meningkat.

Apa yang boleh anda lakukan dengan Webhooks

Prospek baharu ditangkap dan kenalan dicipta

Perbualan bermula, ditutup, atau penyerahan diminta

Panggilan selesai

Temujanji ditempah dan temujanji dijadual semula

Sebut harga diterima

Muatan bertandatangan HMAC yang anda sahkan ketika diterima

Daftar dan urus titik akhir melalui API atau papan pemuka

Pasang dalam beberapa minit

Cipta titik akhir

Daftarkan URL anda dan pilih acara untuk dilanggan, melalui API atau di Tetapan, kemudian Pembangun. Mercateer mengembalikan rahsia tandatangan untuk titik akhir tersebut. Akses API disertakan dalam pelan Crew dan Fleet.

Sahkan tandatangan

Pada setiap penghantaran, baca cap masa (t) dan tandatangan (v1) daripada pengepala tandatangan, kemudian kira HMAC-SHA256 bagi rentetan "{timestamp}.{raw request body}" dengan rahsia penandatanganan anda dan bandingkannya dengan nilai v1. Tolak sebarang permintaan yang tidak sepadan, atau yang cap masanya melebihi 5 minit, supaya anda hanya bertindak pada muatan segar yang benar-benar datang daripada Mercateer. (Pembantu verify dalam SDK kami melakukan semua ini untuk anda.)

Kendalikan cubaan semula secara idempoten

Berikan respons 2xx dengan cepat untuk mengesahkan penghantaran. Penghantaran gagal akan dicuba semula dengan jeda meningkat, jadi gunakan ID acara sebagai kunci pengendali anda untuk mengabaikan pendua dan memproses setiap acara sekali sahaja.

Soalan lazim

Berfungsi dengan keseluruhan tumpukan peralatan anda

Mercateer menggunakan protokol yang sama dengan alat yang sudah anda gunakan.

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

Lihat semua integrasi

Gunakan Mercateer bersama Webhooks

Mula secara percuma dan sambungkan pejabat hadapan anda dalam beberapa minit.

Mula secara percuma

Tiada kad kredit diperlukan

Dapatkan acara pejabat hadapan Mercateer sebagai webhook

Apakah Webhooks?

Apa yang boleh anda lakukan dengan Webhooks

Pasang dalam beberapa minit

Cipta titik akhir

Sahkan tandatangan

Kendalikan cubaan semula secara idempoten

Soalan lazim

Bagaimana saya mendaftarkan titik akhir webhook?

Apakah acara yang boleh saya langgan?

Bagaimana saya mengesahkan penghantaran datang daripada Mercateer?

Apa yang berlaku apabila titik akhir saya tidak aktif?

Pelan Mercateer manakah yang saya perlukan?

Berfungsi dengan keseluruhan tumpukan peralatan anda

Gunakan Mercateer bersama Webhooks