Mercateer
Для розробників

Отримуйте події фронт-офісу Mercateer через webhook’и

Підпишіть endpoint на події Mercateer і одразу отримуйте підписаний пакет даних після завершення дзвінка, надходження ліда або бронювання замовлення. Реєструйте й керуйте endpoint’ами через API або панель керування, і перевіряйте кожну доставку за допомогою HMAC.

Що таке Webhooks?

Webhook’и надсилають події фронт-офісу Mercateer у реальному часі на URL, який ви контролюєте, щоб ваші системи могли реагувати без постійного опитування API. Кожна доставка — це JSON-пакет, підписаний HMAC; ви реєструєте й керуєте endpoint’ами через API або панель керування, а невдалі спроби доставки повторюються з експоненційною затримкою.

Що можна робити з Webhooks

Новий лід отриманий і контакт створено
IntegrationPages.Conversation started, closed, or handoff requested
IntegrationPages.Call completed
Запис заброньовано й запис перенесено
IntegrationPages.Quote accepted
Пакети даних, підписані HMAC, які ви перевіряєте під час отримання
Реєструйте й керуйте endpoint’ами через API або панель керування

Встановлюється за хвилини

1

Створіть endpoint

Зареєструйте свій URL і оберіть події для підписки через API або в Налаштуваннях → Розробник. Mercateer поверне секретний ключ для підпису цього endpoint’у. Доступ до API включено у тарифах Crew і Fleet.

2

Перевірте підпис

IntegrationPages.On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}_{raw request body}" with your signing secret and compare it to the v1 value_ Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer_ (Our SDK’s verify helper does all of this for you_)

3

Обробляйте повторні спроби ідемпотентно

Швидко відповідайте кодом 2xx, щоб підтвердити отримання. Невдалі доставки повторюються з експоненційною затримкою, тому використовуйте ID події як ключ у вашому обробнику, щоб ігнорувати дублікати й обробляти кожну подію лише один раз.

Часті запитання

Працює з усім вашим стеком

Mercateer використовує ті самі протоколи, що й інструменти, які ви вже застосовуєте.

Запустіть Mercateer разом із Webhooks

Почніть безкоштовно та підключіть свій фронт-офіс за хвилини.

Без кредитної картки