Організація – Вебхуки#

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

Вебхуки

Макет сторінки#

Вебхуки Mergado#

Вебхуки Mergado доступні організації автоматично, тут нічого не налаштовується. На які події з Mergado має реагувати агент, обираєте просто в агента.

FreeScout#

Розділ FreeScout слугує для підключення гелпдеску FreeScout. Він містить:

  • Base URL, за якою застосунок отримує події з FreeScout,
  • кнопку New webhook,
  • список створених вебхуків із кількістю.

Вебхуки створюють, змінюють і видаляють ролі Owner і Admin; інші учасники лише бачать список і можуть скопіювати URL.

Новий вебхук FreeScout#

Новий вебхук FreeScout

  1. Клікніть New webhook і введіть Name (напр. «Підтримка»). Під полем побачите, як виглядатиме URL вебхука.
  2. У поле Secret Key вставте секретний ключ, який FreeScout показує в Manage » API & Webhooks. Він слугує для перевірки підпису кожної доставки.
  3. Кнопкою Add вебхук збережете. URL отримає випадкове закінчення, щоб бути унікальною.
  4. Скопіюйте 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:

  1. Обираєте сервіс (Mergado або конкретний вебхук FreeScout).
  2. Обираєте конкретну подію.
  3. Для Mergado додаєте інтернет-магазин і за потреби проєкт, яких має стосуватися тригер.

Коли подія настане, запуститься агент, і результат з’явиться як нова розмова з префіксом [Hook] та в історії на сторінці Огляд.

Що тут можна зробити#

  • Створити вебхук FreeScout і отримати його URL.
  • Додати власні типи подій із FreeScout.
  • Перевірити, які агенти використовують вебхук.

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

Тригер не запускається – де шукати помилку? Перевірте налаштування тригера в агента (правильна подія, правильний інтернет-магазин і проєкт). Для FreeScout перевірте, що у FreeScout вказано правильну URL і що збігається Secret Key. Отримані вебхуки знайдете в історії на сторінці Огляд.

Чи можу я вимкнути вебхуки? Вебхуки Mergado керуються на боці Mergado. У застосунку ви лише приберете тригери-вебхуки в агентів. Вебхук FreeScout видалите на цій сторінці, щойно його не використовуватиме жоден агент.

Які події доступні? Для Mergado, наприклад, події щодо імпорту, експорту та застосування правил, зміни проєктів, елементів, вибірок, правил і зв’язки ключів. Для FreeScout – події розмов, відповідей і клієнтів та ваші власні події.

Чи можуть вебхуки запускати автоматизації? Ні, автоматизації запускаються вручну або за розкладом. На події реагують лише агенти.

Чи була ця стаття корисною?