Загальний опис
Модуль веб-хуків у CRM «Продажі» призначений для автоматичної передачі даних у зовнішні системи при настанні певних подій (створення замовлення, зміна статусу, інтеграційні події тощо).
Це дозволяє:
Автоматизувати обмін інформацією між CRM та сторонніми сервісами.
Використовувати веб-хуки для побудови інтеграцій (аналітика, бухгалтерія, маркетинг).
Оперативно відстежувати зміни у CRM та синхронізувати дані.
Основні можливості
Вибір події – тригер для відправки даних (наприклад, створення замовлення, зміна статусу).
Налаштування умов – передача даних лише за певних умов (наприклад, статус «Новий» або конкретний магазин).
Формування запиту – відправка даних на заданий URL у форматі JSON через
POST.Перевірка безпеки – кожен запит містить параметр
signдля валідації на стороні приймача.Гнучкість – можливість створювати необмежену кількість веб-хуків для різних сценаріїв.
Створення веб-хука
Перейдіть у меню Модулі → Webhooks.
Натисніть «Додати новий веб-хук».
Заповніть поля:
Назва – довільне ім’я веб-хука.
Статус – «Увімкнено» або «Вимкнено».
Подія – оберіть подію, яка запускає відправку (наприклад, «Замовлення»).
URL – адреса вашого сервера для прийому даних.
Додайте умови (необов’язково):
За статусом (наприклад, відправляти лише для «Нових» замовлень).
За магазином (вибір конкретного або всіх джерел продажів).
Натисніть «Створити».
Приклад структури даних (тіло запиту)
При створенні замовлення веб-хук відправить JSON наступного формату:
Перевірка безпеки (sign)
У кожному запиті передається параметр sign, який формується як:
PHP-приклад перевірки:
Інструкція по інтеграції
Підготуйте сервер для прийому запитів:
Налаштуйте обробку POST запитів.
Приймайте JSON-дані та розбирайте їх.
Збережіть дані у вашій системі:
Використовуйте інформацію про замовлення, товари, клієнта.
Перевіряйте sign для безпеки (щоб уникнути підроблених запитів).
Обробляйте події:
Створюйте замовлення у вашій системі.
Синхронізуйте статуси.
Передавайте дані у бухгалтерію, аналітику чи маркетинг.
Тестуйте веб-хук – створіть тестове замовлення в CRM та перевірте, чи коректно воно потрапляє у вашу систему.
