Що таке розширення Mergado Notifications?#

Mergado Notifications — це розширення, яке слугує для передавання сповіщень із Mergado безпосередньо у вашу комунікаційну платформу. Його головна мета — доставити сповіщення, які ви як користувач бачите під значком дзвіночка в адмініструванні Mergado або в електронній пошті, у канали, якими ви зазвичай користуєтеся для спілкування з командою (Rocket.Chat або Slack). Завдяки цьому вам не потрібно регулярно заходити в інтерфейс Mergado, щоб з’ясувати, чи не сталося у ваших проєктах щось важливе.

Наразі Mergado Notifications вміє надсилати лише сповіщення, які надходять з інших розширень.

Розширення ідеально підходить для:

• Агентств, власників інтернет-магазинів і спеціалістів-фрилансерів, які хочуть мати миттєвий огляд змін і помилок у проєктах, навіть коли вони не ввійшли в адміністрування Mergado.

Ціна та виставлення рахунків#

Користування розширенням Mergado Notifications для користувачів Mergado Editor повністю безкоштовне й доступне без жодних додаткових платежів.

Користування розширенням прив’язане до одного користувача в Mergado і безкоштовне незалежно від кількості створених підключень.

Оскільки розширення безкоштовне, воно не має встановленого пробного періоду.

Основні поняття, пов’язані з розширенням Mergado Notifications#

• Webhook URL – Унікальна вебадреса (з’єднання), яку ви згенеруєте у своїй комунікаційній платформі, а потім вставите в Mergado Notifications, щоб їх з’єднати.
• Incoming Webhooks – Функція в комунікаційних інструментах, яка дає змогу зовнішнім застосункам (як-от Mergado) надсилати повідомлення в конкретні канали або користувачам.

Що потрібно для запуску розширення Mergado Notifications#

• Обліковий запис користувача в Mergado Editor.
• Активний webhook у комунікаційній платформі Slack або Rocket.Chat.

Основні функції#

• Пересилання сповіщень у чат – Розширення забезпечить, щоб сповіщення з Mergado надходили як повідомлення в приватний чат або спільний канал.
• Миттєвий огляд поза Mergado – Вам не потрібно входити в адміністрування Mergado, щоб бути в курсі подій у своїх проєктах. Щойно станеться помилка або якась зміна, ви одразу дізнаєтеся про це у своєму комунікаційному інструменті.
• Підтримка комунікаційних платформ – Розширення наразі підтримує Slack і Rocket.Chat. Якщо ви користуєтеся іншим сервісом, повідомте нам — ми охоче додамо можливість його підключити.

Робота в Mergado Notifications#

Розширення активуєте в Mergado Store, натиснувши кнопку I want to activate.

В інтерфейсі розширення Mergado Notifications ви побачите сторінку Connections overview, де згодом побачите створені підключення. Тут ви також побачите кнопку New connection, якою запустите створення з’єднання з вашою комунікаційною платформою.

Як створити підключення до Rocket.Chat?#

а. Отримання webhook URL із Rocket.Chat#

1. В інтерфейсі Rocket.Chat перейдіть до Administration → Workspace → Integrations
   • Щоб потрапити в адміністрування, потрібно мати права адміністратора.
2. Перейдіть на вкладку Incoming і натисніть New у правому верхньому куті.
3. У розділі Settings виберіть варіант Enabled.
4. Заповніть форму:
   • Name: Будь-яка назва (наприклад, Mergado Notifications).
   • Post to Channel: Канал за замовчуванням, куди надсилатимуться сповіщення з Mergado. (Використовуйте #назваканалу для каналу або @ім’якористувача для приватного повідомлення)
   • Post as: Користувач (віртуальний) за замовчуванням, від імені якого надсилатимуться повідомлення. Він має бути доданий до каналу, який ви вказали в Post to Channel. Якщо такого користувача у вас ще немає, створіть його тут
   • Alias: Ім’я, під яким показуватимуться сповіщення (якщо не вказати, це буде ім’я вашого віртуального користувача, вказаного в Post as.)
   • Avatar URL: За бажанням можна змінити логотип аватара.
   • Emoji: Можете вказати будь-яке емодзі в Rocket.Chat.
   • Позначте Allow to overwrite destination channel in the body parameters.
   • Не позначайте Script Enabled.
5. Збережіть, натиснувши Save.
6. З’явиться сторінка, звідки ви скопіюєте отриману Webhook URL.

б. Створення підключення в Mergado Notifications#

1. В інтерфейсі Mergado Notifications натисніть New connection.
2. У полі Service виберіть Rocket.Chat.
3. Введіть Name підключення.
4. Вставте скопійовану Webhook URL з адміністрування Rocket.Chat.
5. Заповніть Channel, куди мають надходити сповіщення, у тому самому вигляді, як ви заповнювали в адмініструванні Rocket.Chat (Post to Channel). Використовуйте #назваканалу для каналу або @ім’якористувача для приватного повідомлення)
6. Натисніть Create.
7. Правильність підключення можна перевірити, натиснувши значок сигналу, який ви знайдете біля створеного підключення в огляді на сторінці Connections overview. Після натискання значка ви отримаєте тестове повідомлення з текстом «Test notification from Mergado Notifications».

Увага: Якщо для надсилання повідомлень ви вибрали приватний канал, у якому немає користувача за замовчуванням (Post as), сповіщення не працюватимуть. Цього користувача-посередника потрібно запросити до каналу, щоб він міг надсилати в канал сповіщення.

Як створити підключення до Slack?#

а. Отримання webhook URL зі Slack#

1. Увійдіть у свій Slack, а потім перейдіть за цим посиланням.
2. Створіть новий застосунок, натиснувши Create New App.
3. Виберіть варіант From scratch.
4. Назвіть застосунок (App Name) і виберіть свій робочий простір/сервер у Slack (Pick a workspace to develop your app in).
5. У лівому меню перейдіть до розділу Incoming Webhooks і цю функцію увімкніть (Activate Incoming Webhooks → On).
6. Підтвердьте, натиснувши кнопку Add new webhook.
7. Виберіть канал або користувача, куди надсилатимуться сповіщення з Mergado, і підтвердьте, натиснувши Allow.
8. З’явиться сторінка, звідки ви скопіюєте отриману Webhook URL.

б. Створення підключення в Mergado Notifications#

1. В інтерфейсі Mergado Notifications натисніть New connection.
2. У полі Service виберіть Slack.
3. Введіть Name підключення.
4. Вставте скопійовану Webhook URL зі Slack.
5. Натисніть Create.
6. Правильність підключення можна перевірити, натиснувши значок сигналу, який ви знайдете біля створеного підключення в огляді на сторінці Connections overview.

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

Що таке Mergado Notifications і для чого він слугує?#

Mergado Notifications — безкоштовне розширення для Mergado Editor, яке пересилає сповіщення з Mergado безпосередньо у вашу комунікаційну платформу (Slack або Rocket.Chat). Завдяки цьому ви будете в курсі подій у своїх проєктах, навіть коли зараз не ввійшли в адміністрування Mergado.

Скільки коштує Mergado Notifications?#

Розширення для користувачів Mergado Editor повністю безкоштовне.

Які комунікаційні платформи підтримуються?#

Наразі Slack і Rocket.Chat. Якщо ви користуєтеся іншим сервісом, повідомте нам — ми охоче додамо можливість його підключити.

Чи можна створити кілька підключень, наприклад до Slack і Rocket.Chat водночас?#

Так, кількість підключень не обмежена. Можна створити будь-яку кількість підключень до різних каналів або платформ.

Які сповіщення надсилає мені Mergado Notifications?#

Наразі розширення пересилає лише сповіщення, які надходять з інших розширень у Mergado. У планах — запуск версії, яка підтримуватиме всі сповіщення з Mergado Editor.

Що мені потрібно, щоб розширення працювало?#

Обліковий запис користувача в Mergado Editor і активний webhook у Rocket.Chat або Slack, який ви вкажете в налаштуваннях розширення.

Чи можна надсилати сповіщення в приватне повідомлення замість спільного каналу?#

Так. Під час налаштування підключення просто вкажіть @ім’якористувача замість #назваканалу.

Як дізнатися, що моє підключення налаштовано правильно?#

На сторінці Connections overview натисніть значок сигналу біля відповідного підключення.

Сповіщення до мене не надходять, хоча підключення створене. Що робити?#

Якщо ви вибрали приватний канал у Rocket.Chat, перевірте, чи додано до нього користувача-посередника (вказаного в полі «Post as»). Без цього сповіщення до приватного каналу не дійдуть.