Організація – Вебхуки#
Сторінка Webhooks пов’язана із запуском агентів подіями з інших сервісів. Завдяки вебхукам агенти можуть реагувати на те, що відбувається в Mergado або FreeScout, – наприклад, на завершений експорт фіду або на нову відповідь клієнта.

Макет сторінки#
Вебхуки Mergado#
Вебхуки Mergado доступні організації автоматично, тут нічого не налаштовується. На які події з Mergado має реагувати агент, обираєте просто в агента.
FreeScout#
Розділ FreeScout слугує для підключення гелпдеску FreeScout. Він містить:
- Base URL, за якою застосунок отримує події з FreeScout,
- кнопку New webhook,
- список створених вебхуків із кількістю.
Вебхуки створюють, змінюють і видаляють ролі Owner і Admin; інші учасники лише бачать список і можуть скопіювати URL.
Новий вебхук FreeScout#

- Клікніть New webhook і введіть Name (напр. «Підтримка»). Під полем побачите, як виглядатиме URL вебхука.
- У поле Secret Key вставте секретний ключ, який FreeScout показує в Manage » API & Webhooks. Він слугує для перевірки підпису кожної доставки.
- Кнопкою Add вебхук збережете. URL отримає випадкове закінчення, щоб бути унікальною.
- Скопіюйте URL вебхука (іконкою поруч) і вкажіть її у FreeScout у Manage » API & Webhooks.
На картці вебхука є:
- URL із кнопкою копіювання,
- Used by – агенти, яких запускає цей вебхук,
- олівець для редагування – змінюєте назву або Secret Key; параметром Change webhook URL as well згенеруєте нову адресу (стара тоді перестане працювати, і її потрібно замінити у FreeScout; агенти залишаться підключеними),
- кошик для видалення – не можна використати, доки вебхук використовує якийсь агент.
Власні події#
FreeScout надсилає тип події в заголовку X-FreeScout-Event. Окрім звичайних подій (нова розмова, призначення, зміна стану, відповідь клієнта, відповідь оператора, нотатка, новий чи змінений клієнт…) можна на картці вебхука через Add event ввести й власну – Name і Type (значення заголовка). Власні події потім пропонуються під час налаштування тригера агента.
Як використовуються вебхуки#
Самі реакції на події налаштовуєте в агентах у розділі Triggers параметром Webhook:
- Обираєте сервіс (Mergado або конкретний вебхук FreeScout).
- Обираєте конкретну подію.
- Для Mergado додаєте інтернет-магазин і за потреби проєкт, яких має стосуватися тригер.
Коли подія настане, запуститься агент, і результат з’явиться як нова розмова з префіксом [Hook] та в історії на сторінці Огляд.
Що тут можна зробити#
- Створити вебхук FreeScout і отримати його URL.
- Додати власні типи подій із FreeScout.
- Перевірити, які агенти використовують вебхук.
Часті запитання#
Тригер не запускається – де шукати помилку? Перевірте налаштування тригера в агента (правильна подія, правильний інтернет-магазин і проєкт). Для FreeScout перевірте, що у FreeScout вказано правильну URL і що збігається Secret Key. Отримані вебхуки знайдете в історії на сторінці Огляд.
Чи можу я вимкнути вебхуки? Вебхуки Mergado керуються на боці Mergado. У застосунку ви лише приберете тригери-вебхуки в агентів. Вебхук FreeScout видалите на цій сторінці, щойно його не використовуватиме жоден агент.
Які події доступні? Для Mergado, наприклад, події щодо імпорту, експорту та застосування правил, зміни проєктів, елементів, вибірок, правил і зв’язки ключів. Для FreeScout – події розмов, відповідей і клієнтів та ваші власні події.
Чи можуть вебхуки запускати автоматизації? Ні, автоматизації запускаються вручну або за розкладом. На події реагують лише агенти.