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.

Pengembang

Dapatkan kejadian front office Mercateer sebagai webhook

Langganan sebuah endpoint ke kejadian Mercateer dan terima muatan (payload) yang telah ditandatangani seketika panggilan selesai, prospek masuk, atau pekerjaan dipesan. Daftarkan dan kelola endpoint melalui API atau dasbor, serta verifikasi setiap pengiriman dengan HMAC.

Pasang dalam hitungan menit Semua integrasi

Apa itu Webhooks?

Webhook mendorong kejadian front office Mercateer ke URL yang Anda kendalikan secara real-time, sehingga sistem Anda bisa bereaksi tanpa perlu polling API. Setiap pengiriman berupa payload JSON yang ditandatangani dengan HMAC, Anda mendaftarkan dan mengelola endpoint melalui API atau dasbor, dan pengiriman yang gagal akan dicoba ulang dengan jeda yang meningkat.

Yang bisa Anda lakukan dengan Webhooks

Prospek baru ditangkap dan kontak dibuat

Percakapan dimulai, ditutup, atau minta dialihkan ke manusia

Panggilan selesai

Janji temu dipesan dan janji temu dijadwal ulang

Penawaran diterima

Payload yang ditandatangani HMAC yang bisa Anda verifikasi saat diterima

Daftarkan dan kelola endpoint melalui API atau dasbor

Pasang dalam hitungan menit

Buat endpoint

Daftarkan URL Anda dan pilih kejadian yang ingin Anda langganan, baik melalui API atau di Pengaturan, lalu Developer. Mercateer akan mengembalikan rahasia penandatanganan (signing secret) untuk endpoint tersebut. Akses API termasuk dalam paket Crew dan Fleet.

Verifikasi tanda tangan

Setiap kali payload dikirim, baca timestamp (t) dan tanda tangan (v1) dari header tanda tangan, lalu hitung HMAC-SHA256 dari string "{timestamp}.{raw request body}" dengan secret penandatanganan Anda dan bandingkan dengan nilai v1. Tolak setiap permintaan yang tidak cocok, atau yang timestamp-nya lebih dari 5 menit, agar Anda hanya memproses payload segar yang benar-benar berasal dari Mercateer. (Helper verify di SDK kami melakukan semua ini untuk Anda.)

Tangani percobaan ulang secara idempoten

Berikan respons 2xx dengan cepat untuk mengonfirmasi penerimaan. Pengiriman yang gagal akan dicoba ulang dengan jeda yang meningkat, jadi gunakan ID kejadian sebagai kunci handler Anda agar mengabaikan duplikat dan memproses setiap kejadian hanya sekali.

Pertanyaan yang sering diajukan

Bekerja dengan seluruh tumpukan aplikasi 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

Manfaatkan Mercateer bersama Webhooks

Mulai gratis dan sambungkan bagian depan kantor Anda dalam hitungan menit.

Mulai gratis

Tidak perlu kartu kredit

Dapatkan kejadian front office Mercateer sebagai webhook

Apa itu Webhooks?

Yang bisa Anda lakukan dengan Webhooks

Pasang dalam hitungan menit

Buat endpoint

Verifikasi tanda tangan

Tangani percobaan ulang secara idempoten

Pertanyaan yang sering diajukan

Bagaimana cara mendaftarkan endpoint webhook?

Kejadian apa saja yang bisa saya langganan?

Bagaimana cara memverifikasi bahwa pengiriman berasal dari Mercateer?

Apa yang terjadi jika endpoint saya sedang down?

Paket Mercateer mana yang saya butuhkan?

Bekerja dengan seluruh tumpukan aplikasi Anda

Manfaatkan Mercateer bersama Webhooks