Узнавать об оповещениях и согласованиях в почте, 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 в ваш сервис.