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.

מפתחים

קבל אירועים ממשרד הקדמי של Mercateer כ-webhooks

הרשם לקצה (endpoint) לאירועי Mercateer וקבל מידע חתום ברגע ששיחה מסתיימת, ליד מגיע או עבודה מתוזמנת. רשום ונהל קצוות מה-API או מהלוח הבקרה, ואמת כל מסירה באמצעות HMAC.

התקנה תוך דקות כל האינטגרציות

מהו Webhooks?

Webhooks דוחפים אירועים ממשרד הקדמי של Mercateer לכתובת URL שבשליטתך בזמן אמת, כך שהמערכות שלך יכולות להגיב ללא סקרים חוזרים ל-API. כל מסירה היא מידע מסוג JSON החתום ב-HMAC, אתה רושם ומנהל קצוות מה-API או מהלוח הבקרה, ומסירות נכשלות ניסות מחדש עם השהייה הולכת וגדלה.

מה תוכלו לעשות עם Webhooks

ליד חדש נקלט ואיש קשר נוצר

שיחה שנפתחה, נסגרה או שהתבקשה בה העברה לאדם

שיחה שהסתיימה

מפגש הוזמן ושינוי תאריך מפגש

הצעת מחיר שאושרה

מידע חתום ב-HMAC שאתה מאמת בעת הקבלה

רשום ונהל קצוות מה-API או מהלוח הבקרה

התקנה תוך דקות

צור קצה

רשום את כתובת ה-URL שלך ובחר את האירועים שברצונך להירשם אליהם, מה-API או תחת הגדרות ואז מפתח. Mercateer מחזיר סוד חתימה עבור הקצה הזה. גישת ה-API כלולה בתוכניות Crew ו-Fleet.

אמת את החתימה

בכל שליחה, קראו את חותמת הזמן (t) ואת החתימה (v1) מכותרת החתימה, ואז חשבו HMAC-SHA256 של המחרוזת "{timestamp}.{raw request body}" עם סוד החתימה שלכם והשוו לערך של v1. דחו כל בקשה שלא תואמת, או שחותמת הזמן שלה ישנה ביותר מ-5 דקות, כך שתפעלו רק על מטענים טריים שבאמת הגיעו מ-Mercateer. (פונקציית האימות ב-SDK שלנו עושה את כל זה בשבילכם.)

טפל בניסיונות חוזרים בצורה אידמפוטנטית

ענה בקוד 2xx במהירות כדי לאשר קבלת מסירה. מסירות נכשלות ניסות שוב עם השהייה הולכת וגדלה, לכן השתמש במזהה האירוע כדי להתעלם מכפילויות ולעבד כל אירוע פעם אחת בלבד.

שאלות נפוצות

עובד עם כל מערכת הכלים שלכם

Mercateer מדבר באותם פרוטוקולים כמו הכלים שאתם כבר משתמשים בהם.

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

ראו את כל האינטגרציות

הכניסו את Mercateer לפעולה עם Webhooks

התחילו בחינם וחברו את המשרד הקדמי תוך דקות.

התחילו בחינם

אין צורך בכרטיס אשראי

קבל אירועים ממשרד הקדמי של Mercateer כ-webhooks

מהו Webhooks?

מה תוכלו לעשות עם Webhooks

התקנה תוך דקות

צור קצה

אמת את החתימה

טפל בניסיונות חוזרים בצורה אידמפוטנטית

שאלות נפוצות

איך אני רושם קצה webhook?

לאילו אירועים אני יכול להירשם?

איך אני מאמת שמסירה הגיעה מ-Mercateer?

מה קורה כשהקצה שלי לא פעיל?

איזו חבילה של Mercateer אני צריך?

עובד עם כל מערכת הכלים שלכם

הכניסו את Mercateer לפעולה עם Webhooks