Получайте события фронт-офиса Mercateer через вебхуки
Подпишите конечную точку на события Mercateer и получайте подписанные данные сразу после завершения звонка, поступления лида или бронирования заявки. Регистрируйте и управляйте конечными точками через API или панель управления, и проверяйте каждую доставку с помощью HMAC.
Что такое Webhooks?
Вебхуки передают события фронт-офиса Mercateer на ваш URL в реальном времени, чтобы ваши системы могли реагировать без постоянного опроса API. Каждая доставка — это JSON-данные, подписанные HMAC; вы регистрируете и управляете конечными точками через API или панель управления, а при неудачных попытках доставка повторяется с экспоненциальной задержкой.
Что можно делать с помощью Webhooks
Установка за несколько минут
Создайте конечную точку
Зарегистрируйте свой URL и выберите события для подписки — через API или в разделе «Настройки» → «Разработчик». Mercateer вернёт секретный ключ подписи для этой конечной точки. Доступ к API входит в тарифы Crew и Fleet.
Проверьте подпись
При каждой доставке считайте метку времени (t) и подпись (v1) из заголовка подписи, затем вычислите HMAC-SHA256 строки "{timestamp}.{raw request body}" со своим секретом подписи и сравните с значением v1. Отклоняйте любой запрос, который не совпадает или чья метка времени старше 5 минут, чтобы обрабатывать только свежие данные, действительно пришедшие от Mercateer. (Функция проверки в нашем SDK делает всё это за вас.)
Обрабатывайте повторные попытки идемпотентно
Быстро отвечайте статусом 2xx, чтобы подтвердить получение. При неудачных попытках доставка повторяется с экспоненциальной задержкой, поэтому используйте ID события как ключ обработчика, чтобы игнорировать дубликаты и обрабатывать каждое событие один раз.
Часто задаваемые вопросы
Работает со всем вашим стеком
Mercateer использует те же протоколы, что и инструменты, которыми вы уже пользуетесь.
Запустите Mercateer вместе с Webhooks
Начните бесплатно и подключите свой фронт-офис за несколько минут.
Без привязки банковской карты