Дізнаватися про сповіщення й погодження в пошті, Telegram, Slack, Teams і Discord

Повідомлення — це звістка, яку Slen надсилає людям, коли сповіщення відкривається, стає критичним або закривається, і коли виконання чекає на погодження або щодо погодження ухвалено рішення. Ця сторінка — про дві сторінки повідомлень у консолі: про канали й маршрути команди та про ваші власні повідомлення.

Де розташовані повідомлення

Відкрийте Налаштування. Дві його картки ведуть до повідомлень.

• Повідомлення — сторінка команди. Її вкладки — Канали (чати команди в Slack, Microsoft Teams, Discord і Telegram), Маршрути, які вирішують, хто про що дізнається, і Журнал — доставки організації.

• Мої повідомлення — ваша сторінка: ваша пошта й ваш Telegram, що Slen надсилає вам у цій організації, ваші тихі години і, на окремій вкладці, історія того, що він вам надіслав.

Як повідомлення знаходить адресата

Slen повідомляє людям про п’ять подій:

• сповіщення відкрилося;

• відкрите сповіщення стало критичним — один раз для кожного сповіщення;

• сповіщення закрилося;

• виконання чекає на погодження;

• щодо погодження ухвалено рішення, або його строк минув.

Повідомлення несуть канали двох видів.

• Канал команди — це канал у Slack, Microsoft Teams або Discord чи група в Telegram. Він належить організації, а не тому, хто його підключив, і чує всю організацію або один проєкт.

• Особистий канал — це ваша пошта або ваш власний чат із ботом Slen у Telegram. Він належить вам і служить усім організаціям, у яких ви учасник.

Хто отримає повідомлення, вирішують дві речі.

• Маршрут організації називає події та одержувачів: канали команди, ролі й учасників. Його пише власник або адміністратор.

• Підписка — ваша: події, які ви хочете отримувати, і особисті канали, у які вони йдуть. Ваші підписки змінюєте лише ви.

Подія приходить у кожен канал один раз, скільки б маршрутів і підписок її не називали.

Підключити канал команди

Адреса вебхука — секрет: той, хто її має, може писати в канал. Slen зберігає її в зашифрованому вигляді й ніколи не повертає. Рядок каналу показує хост адреси та її останні чотири символи.

Slack

Slack видає адресу через застосунок, який ви створюєте у своєму робочому просторі Slack. У Slen немає застосунку в Slack, який треба встановлювати.

1. Відкрийте застосунки Slack, створіть новий застосунок з нуля й виберіть свій робочий простір.

2. У налаштуваннях застосунку відкрийте Incoming Webhooks і ввімкніть їх.

3. Додайте новий вебхук у робочий простір і виберіть канал, у який він пише.

4. Скопіюйте адресу вебхука. Вона починається з https://hooks.slack.com/services/.

Повідомлення в Slack не має кнопок. Посилання в ньому відкриває сповіщення або погодження в консолі.

Microsoft Teams

Teams приймає повідомлення через робочий процес каналу. З’єднувачі Office 365 — вхідні вебхуки, які Teams мав раніше, — виведено з роботи, і їхніх адрес Slen не приймає.

1. У Teams відкрийте меню каналу й виберіть робочі процеси (Workflows).

2. Виберіть шаблон, який публікує повідомлення в канал, коли приходить запит вебхука.

3. Виберіть команду й канал і збережіть робочий процес.

4. Скопіюйте адресу, яку показує робочий процес. Це адреса Azure Logic Apps або Power Automate з /workflows/ у шляху, і вона несе підпис.

Discord

1. Відкрийте налаштування сервера, потім розділ інтеграцій, а в ньому — вебхуки.

2. Створіть новий вебхук і виберіть канал, у який він пише.

3. Скопіюйте адресу вебхука. Вона починається з https://discord.com/api/webhooks/.

Група в Telegram

Група підключається через бота Slen, а не адресою.

1. У формі нового каналу виберіть групу в Telegram і отримайте посилання. За замовчуванням посилання діє 15 хвилин. Якщо воно спливло раніше, ніж його прийняла група, отримайте у формі нове: канал створюється заново.

2. Відкрийте посилання або відскануйте його QR-код. Telegram запропонує вибрати групу й додасть до неї бота Slen.

3. Дозвольте ботові писати в групу.

4. Поверніться в консоль. Форма показує назву групи, яка підключилася. Натисніть Підтвердити, якщо це ваша група. Якщо це інша група, скажіть про це у формі: бот вийде з тієї групи, і ви отримаєте нове посилання.

Підтверджує групу лише той, хто отримав посилання. Посилання, яке потрапило до когось іншого, не зробить його групу одержувачем вашої організації. Група служить водночас лише одному каналу Slen. У групі бот читає лише адресовані йому команди, а не листування.

Маршрути

Маршрут каже, які події кому йдуть. На вкладці Маршрути натисніть Новий маршрут і заповніть форму.

• Події: сповіщення — коли сповіщення відкривається і коли стає критичним — і запити погодження. Для сповіщень можна позначити частину типів і вибрати одне правило.

• Рівень: від Попередження або від Критично. Запит погодження вважається попередженням.

• Закриття: чи йдуть закриття сповіщення й рішення щодо погодження туди ж, куди пішло перше повідомлення. За замовчуванням це ввімкнено.

• Проєкт: усі проєкти або один із них. Усі проєкти пропонуються лише учасникові, якому доступний кожен проєкт.

• Одержувачі: канали команди, ролі й учасники.

Роль читається, коли приходить подія: повідомлення отримує той, хто має цю роль у цю мить, зокрема учасник, який приєднався після того, як маршрут написали. Учасник отримує повідомлення в ті особисті канали, де він приймає призначене йому, а учасник без такого ввімкненого каналу не отримує нічого — рядок маршруту про це каже. Одержувач отримує лише події, які його роль читає в консолі. Роль Спостерігач не пропонується, коли маршрут несе погодження: спостерігач погоджень не бачить.

Кому повідомляти про одне правило

У панелі правила сповіщення, на вкладці Правила сторінки Сповіщення, є блок Кому повідомляти. Додайте до нього канали команди, ролі або учасників, і сповіщення цього правила доходитимуть до них.

• Блок зберігає маршрут, прив’язаний до правила. Маршрут несе відкриття сповіщення за правилом, його перехід у критичне та його закриття — у проєкті правила. Перший одержувач створює маршрут, а видалення останнього видаляє його. Маршрут видно й на вкладці Маршрути.

• Нове правило отримує свій маршрут, щойно правило створено.

• Без management:write блок доступний лише для читання — як і в правила всієї організації, якщо вам доступний не кожен проєкт.

• Люди, які самі підписалися на такі сповіщення, теж їх отримують.

Ваші власні повідомлення

На сторінці Мої повідомлення ви вибираєте, що приходить вам. Ніхто інший цього не змінює, навіть власник.

Ваші канали

• Пошта приходить на адресу вашого облікового запису. Підключати нічого не треба, і нічого не надсилається, поки адресу не підтверджено.

• Щоб отримувати повідомлення в Telegram, увімкніть його перемикач або виберіть Підключити Telegram у його меню, відкрийте посилання або відскануйте його QR-код і почніть чат із ботом. Поверніться в консоль, перевірте, що вона називає ваш чат, і натисніть Підтвердити. Якщо посилання спливло раніше, отримайте нове. Один обліковий запис Telegram служить одному обліковому запису Slen. Надішліть ботові /stop, щоб поставити чат на паузу.

• Кожен канал має перемикач, який ставить його на паузу й вмикає знову. Меню каналу надсилає тестове повідомлення, яке ставиться в чергу, а історія ваших доставок показує, як воно пройшло. Тестовий лист надсилається не частіше ніж раз на хвилину.

• У меню кожного вашого каналу є прапорець, який приймає те, що вам призначили адміністратори, і за замовчуванням він позначений. Маршрут, який називає вас або вашу роль, доходить до вас лише в ті канали, де прапорець позначений. Ваші власні підписки від цього не залежать.

Що надсилати

Підписка називає події — сповіщення вибраних вами типів, запити погодження, — рівень, з якого вони до вас доходять, проєкт і канали, у які вони йдуть. Підписка на всі ваші проєкти йде за вашим доступом: проєкт, який вам дадуть пізніше, одразу до неї входить. Ролі Спостерігач погодження не пропонуються.

Коли ви входите в організацію і коли змінюється ваша роль, Slen дає вам підписки, рекомендовані для ролі.

Підписка, яку ви змінили, — ваша, і зміна ролі її не чіпає: роль замінює лише рекомендації, які ви залишили як є. Посилання під списком повертає підписки, рекомендовані для вашої ролі. Підписка, яку ваша роль більше не читає, або підписка на проєкт, який вам більше не доступний, залишається у списку закресленою і знову працює, коли доступ повертається.

Тихі години

Тихі години притримують повідомлення у ваші особисті канали на вибрані вами години, у вибраному вами часовому поясі — за замовчуванням у поясі організації. Години можуть переходити через північ. Коли вони закінчуються, повідомлення, що чекали, приходять одним зведенням. За замовчуванням критичне повідомлення все одно приходить одразу. Перемикач тихих годин вмикає й вимикає їх, а їхнє меню змінює години, часовий пояс і те, чи приходить критичне повідомлення одразу. Тихі години — ваші в усіх організаціях, у яких ви учасник. Канали команди тихих годин не мають.

Що приходить і коли

• Подія — це одне повідомлення в кожному каналі. Людина з поштою й Telegram отримує по одному повідомленню в кожен.

• Коли в один канал за п’ять хвилин іде більше п’яти повідомлень (обидва числа — значення за замовчуванням), перші п’ять ідуть одразу. Решта приходить наприкінці цих п’яти хвилин одним зведенням: до десяти рядків і посилання на стрічку.

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

• Про те, що сповіщення стало критичним, повідомляється один раз. Хто чув про його відкриття, дізнається про це як про продовження, а маршрут або підписка від Критично отримує це як перше повідомлення. Про сповіщення, яке хтось прийняв, теж повідомляється — з іменем того, хто його прийняв.

• Сповіщення, яке відкрилося й закрилося, поки його повідомлення ще чекало на зведення або на кінець тихих годин, приходить у зведенні одним рядком — відкрито й закрито, і скільки воно тривало, — і окремого повідомлення про закриття немає.

• Повідомлення в особистий канал приходить мовою вашого облікового запису й у вашому часовому поясі. Повідомлення в канал команди — мовою каналу й у часовому поясі організації.

• Посилання в повідомленні відкриває консоль в організації та проєкті події.

• У кожному листі-повідомленні є посилання для відписки. Одне клацання ставить на паузу листи-повідомлення на вашу адресу в усіх організаціях; листи для входу й запрошення приходять, як і раніше. Увімкніть листи знову на сторінці Мої повідомлення.

• Лист-повідомлення каже внизу, чому він прийшов: ви на нього підписані, його призначив вам маршрут команди або він продовжує повідомлення, яке ви вже отримали. Маршрут він не називає.

• Slen надсилає на день обмежену кількість листів-повідомлень одній людині й одній організації. Лист понад ліміт пропускається, і журнал про це каже.

Ролі й проєкти

• Власник або Адміністратор, який увійшов у консоль як людина, підключає канали команди й пише маршрути.

• Каналу або маршруту всієї організації потрібен доступ до кожного проєкту, а його мають власник і адміністратор.

• Розробник і учасник із роллю Фінанси бачать канали, маршрути й журнал і нічого з цього не змінюють. Спостерігач не відкриває сторінку команди.

• Кожна людина сама налаштовує свої канали, підписки й тихі години, хоч би якою була її роль.

• Повідомлення ніколи не розповідає людині про проєкт поза її доступом або про подію, яку її роль не читає в консолі: спостерігач не чує про жодне погодження. Slen перевіряє це, коли спрямовує подію маршрутами, і ще раз просто перед надсиланням повідомлення.

• Учасника, який покинув організацію, вилучають з її маршрутів, а його підписки в ній видаляються. Маршрут, у якому не залишилося одержувачів, видаляється. Канали, які підключив цей учасник, залишаються в організації.

Журнал

Вкладка Журнал перелічує доставки організації за останні 30 днів: коли, яка подія, куди, статус і кількість спроб. Особистий канал іншої людини показано іменем людини й видом каналу, без адреси. Журнал показує лише події проєктів, які вам доступні, і події поза проєктами. Вкладка історії на сторінці Мої повідомлення перелічує доставки вам — з тими самими фільтрами за статусом і за каналом, що й журнал.

Статус каже, що сталося з повідомленням: доставлено, у черзі, відкладено до певного часу, увійшло до зведення, помилка з її текстом або пропущено з причиною — наприклад, людина більше не учасник або проєкт вийшов з її доступу.

Канал вимкнено

Slen вимикає канал після п’яти невдалих доставок поспіль. Одразу він робить це, коли сервіс каже, що адреси більше немає: вебхук видалено, канал архівовано, бота видалили з групи або заблокували. Рядок каналу каже чому. Slen повідомляє тому, хто підключив канал, поки він власник або адміністратор, і власникам організації. Про вимкнення особистого Telegram повідомляється листом.

• Slack, Microsoft Teams, Discord: створіть у сервісі новий вебхук і вставте його адресу в канал — це знову вмикає канал. Потім натисніть Надіслати тест.

• Telegram: розблокуйте бота або поверніть його в групу й підключіть свій чат або групу знову.

Повідомлення й вебхуки

Вебхук — для ваших систем: підписаний JSON-запит про кожну подію, на яку він підписаний, який надсилається знову, поки ваш сервіс його не прийме. Повідомлення — для людей: кілька подій словами мовою читача, зібрані у зведення, з тихими годинами й посиланням для відписки. Одне від іншого не залежить, і сповіщення доходить і до вебхуків, і до повідомлень.

Що читати далі

• Сповіщення — правила, про сповіщення яких кажуть повідомлення.

• Погодження — рішення, на які чекає запит погодження.

• Учасники й запрошення — ролі й проєкти, доступні учасникові.

• Вебхуки — надсилати події Slen у ваш сервіс.