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-ի հաճախորդների սպասարկման իրադարձությունները webhook-ներով

Բաժանորդագրեք վերջնակետը Mercateer-ի իրադարձություններին և ստացեք ստորագրված տվյալներ այն պահին, երբ զանգն ավարտվում է, պոտենցիալ հաճախորդ է գալիս կամ աշխատանք է ամրագրվում. Գրանցեք և կառավարեք վերջնակետերը API-ից կամ վահանակից, և ստուգեք ամեն առաքում HMAC-ով.

Տեղադրվում է րոպեների ընթացքում Բոլոր ինտեգրումները

Ի՞նչ է Webhooks-ը?

Webhook-ները իրական ժամանակում ուղարկում են Mercateer-ի հաճախորդների սպասարկման իրադարձությունները ձեր վերահսկած URL-ին, որպեսզի ձեր սեփական համակարգերը կարողանան արձագանքել՝ առանց API-ն անընդհատ հարցում անելու. Յուրաքանչյուր առաքում HMAC-ով ստորագրված JSON տվյալ է, վերջնակետերը գրանցում և կառավարում եք API-ից կամ վահանակից, իսկ ձախողված առաքումները կրկնվում են աստիճանաբար աճող ընդմիջումներով.

Ինչ կարող եք անել Webhooks-ի հետ

Գրանցվել է նոր պոտենցիալ հաճախորդ և ստեղծվել է կոնտակտ

Զրույցը սկսվել է, փակվել կամ պահանջվել է փոխանցում մարդուն

Զանգն ավարտվել է

Այցելությունն ամրագրվել է և այցելությունը վերաամրագրվել է

Գնանշումն ընդունվել է

HMAC-ով ստորագրված տվյալներ, որոնք ստանալիս ստուգում եք

Գրանցեք և կառավարեք վերջնակետերը API-ից կամ վահանակից

Տեղադրվում է րոպեների ընթացքում

Ստեղծեք վերջնակետ

Գրանցեք ձեր URL-ը և ընտրեք իրադարձությունները, որոնց ուզում եք բաժանորդագրվել՝ API-ից կամ Settings, ապա Developer բաժնում. Mercateer-ը վերադարձնում է ստորագրման գաղտնի բանալի այդ վերջնակետի համար. API-ի հասանելիությունը ներառված է Crew և Fleet փաթեթներում.

Ստուգեք ստորագրությունը

Ամեն առաքման ժամանակ ստորագրության վերնագրից կարդացեք ժամանակի դրոշմը (t) և ստորագրությունը (v1), ապա ձեր ստորագրման գաղտնի բանալիով հաշվեք "{timestamp}.{raw request body}" տողի HMAC-SHA256-ը և համեմատեք այն v1 արժեքի հետ. Մերժեք ցանկացած հարցում, որը չի համընկնում կամ որի ժամանակի դրոշմը 5 րոպեից հին է, որպեսզի գործեք միայն թարմ տվյալների հիման վրա, որոնք իսկապես եկել են Mercateer-ից. (Մեր SDK-ի ստուգման օժանդակ գործառույթը այս ամենն անում է ձեր փոխարեն.)

Կրկնվող առաքումները մշակեք իդեմպոտենտ ձևով

Առաքումը հաստատելու համար արագ պատասխանեք 2xx կոդով. Ձախողված առաքումները կրկնվում են աստիճանաբար աճող ընդմիջումներով, ուստի ձեր մշակիչը հիմնեք իրադարձության ID-ի վրա՝ կրկնօրինակներն անտեսելու և յուրաքանչյուր իրադարձությունը մեկ անգամ մշակելու համար.

Հաճախ տրվող հարցեր

Աշխատում է ձեր բոլոր գործիքների հետ

Mercateer-ը խոսում է նույն արձանագրություններով, ինչ ձեր արդեն օգտագործած գործիքները.

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

Տեսնել բոլոր ինտեգրումները

Գործի դրեք Mercateer-ը Webhooks-ի հետ

Սկսեք անվճար և րոպեների ընթացքում միացրեք ձեր հաճախորդների սպասարկումը.

Սկսել անվճար

Բանկային քարտ պետք չէ

Ստացեք Mercateer-ի հաճախորդների սպասարկման իրադարձությունները webhook-ներով

Ի՞նչ է Webhooks-ը?

Ինչ կարող եք անել Webhooks-ի հետ

Տեղադրվում է րոպեների ընթացքում

Ստեղծեք վերջնակետ

Ստուգեք ստորագրությունը

Կրկնվող առաքումները մշակեք իդեմպոտենտ ձևով

Հաճախ տրվող հարցեր

Ինչպե՞ս գրանցել webhook-ի վերջնակետ?

Ո՞ր իրադարձություններին կարող եմ բաժանորդագրվել?

Ինչպե՞ս ստուգել, որ առաքումը եկել է Mercateer-ից?

Ի՞նչ է լինում, երբ իմ վերջնակետը հասանելի չէ?

Mercateer-ի ո՞ր փաթեթն է ինձ պետք?

Աշխատում է ձեր բոլոր գործիքների հետ

Գործի դրեք Mercateer-ը Webhooks-ի հետ