Slack Notifications¶
Ваша команда и так живёт в Slack. Slack Notifications отправляет каждому его уведомления Turbo EA личным сообщением в Slack — назначенную задачу, решение, ожидающее подписи, риск, оказавшийся в его зоне ответственности, — с кнопкой, ведущей прямо к карточке.
Каждый сохраняет контроль: в собственных настройках уведомлений появляется столбец Slack рядом со столбцами «В приложении» и «Эл. почта», где человек сам отмечает, какие именно типы уведомлений должны туда приходить. По умолчанию не включено ничего.
Кратко¶
| Лицензия | Коммерческое — требуется подписанное лицензионное право |
| Минимальная версия Turbo EA | 2.89.1 |
| Право доступа | ext.slack-notify.admin |
| Разрешения доступа к данным | core.notifications.channel, core.users.read |
| Нужна перезагрузка серверной части | да — содержит серверный код |
| Где появляется | Админ → Настройки → Интеграции → Slack · столбец Slack в настройках уведомлений каждого пользователя |
Требуется только исходящий HTTPS к slack.com — ни входящего URL, ни
OAuth-обработчика, ни проверки в Slack Marketplace. Именно поэтому расширение
работает на самостоятельно размещённых экземплярах и за межсетевым экраном.
Настройка¶
Откройте Админ → Настройки → Интеграции и выберите вкладку Slack. Панель проведёт вас по трём пронумерованным шагам.
1. Создайте приложение Slack¶
Панель показывает готовый манифест приложения. В Slack выберите Create New
App → From a manifest, укажите своё рабочее пространство, вставьте манифест
(есть кнопка Скопировать манифест), затем нажмите Install to Workspace и
скопируйте Bot User OAuth Token — он начинается с xoxb-.
Манифест запрашивает четыре области действия бота и ничего сверх того:
| Область | Зачем |
|---|---|
chat:write |
Отправлять личное сообщение |
im:write |
Открывать личную переписку с человеком |
users:read |
Читать справочник участников |
users:read.email |
Сопоставлять учётную запись Turbo EA с участником Slack по почте |
Оставьте ротацию токенов выключенной
Манифест намеренно отключает ротацию токенов Slack. Если её включить, токен бота будет истекать каждые 12 часов, а обновлять его эта версия не умеет: доставка останавливалась бы дважды в сутки.
2. Подключите рабочее пространство¶
| Поле | Примечания |
|---|---|
| OAuth-токен бота | Токен xoxb-…. Хранится в зашифрованном виде; позже оставьте поле пустым, чтобы сохранить его |
| Имя, отображаемое в сообщениях Slack | По умолчанию Turbo EA. Используется в кнопке и подписи сообщения |
| Доставлять уведомления в Slack | Включено по умолчанию — это переключатель паузы, а не шаг установки |
Нажмите Сохранить, затем Проверить подключение; метка подтвердит Connected to ….
3. Сопоставьте людей¶
Учётные записи сопоставляются по адресу электронной почты при первой отправке сообщения человеку, и результат кэшируется. Карточка Люди перечисляет всех, начиная с проблемных случаев, и помечает, кто подключён, кого нет в Slack и кто ещё не проверен.
Для тех, чей адрес в Slack отличается от почты в Turbo EA, введите
идентификатор участника Slack (вида U01ABCDEF) и нажмите Сохранить —
ручное сопоставление всегда важнее совпадения по почте. Отправить тестовое
сообщение подтверждает, что сопоставление работает от начала до конца. Если
очистить поле, человек снова попадает под поиск по почте.
Людей, которых Slack не знает, система автоматически перепроверяет раз в сутки, поэтому тот, кто присоединился к рабочему пространству Slack уже после получения учётной записи Turbo EA, будет учтён без вмешательства.
Хранятся только идентификаторы участников
Расширение хранит идентификаторы участников Slack и ничего больше — адреса электронной почты остаются в Turbo EA.
Что настраивает каждый сам¶
Как только расширение работает, у каждого в настройках уведомлений появляется столбец Slack рядом со столбцами «В приложении» и «Эл. почта».
- Каждый тип по умолчанию выключен. Никто не получит сообщение в Slack, пока сам не включит этот тип.
- Подпись под таблицей сообщает каждому, подключена ли его учётная запись к Slack или нужно попросить администратора выполнить сопоставление.
- Объявление об обновлении, существующее только в приложении, в Slack никогда не доставляется.
Turbo EA решает, какие типы уведомлений существуют и кто их включил; расширение лишь доставляет сообщение.
Как выглядит сообщение¶
Личное сообщение в Slack содержит заголовок уведомления полужирным шрифтом, текст сообщения, кнопку Open in Turbo EA (с настроенным вами именем), ведущую к нужной карточке или странице, и небольшую подпись с названием приложения и типом уведомления.
Доставка строго односторонняя — из Turbo EA в Slack — и всегда в виде личного сообщения. В каналы ничего не публикуется.
Наблюдение за доставкой¶
Карточка Журнал доставки показывает, сколько сообщений ожидает, отправлено и не доставлено, а также 50 последних строк журнала.
Сообщения ставятся в очередь и отправляются за секунды. Если Slack ограничивает частоту или возвращает ошибку, расширение повторяет попытку с нарастающей паузой и сдаётся после шести попыток; постоянные ошибки — отозванный токен, удалённый пользователь, отсутствующая область действия — прекращают попытки сразу, а не расходуют все шесть. Доставленные записи удаляются через 14 дней.
У неподвижной очереди ровно две причины, и панель называет ту, которая применима:
- Токен бота не сохранён — вставьте токен и сохраните.
- Доставка выключена — снова включите Доставлять уведомления в Slack.
Повторить неудачные возвращает в очередь всё, от чего система отказалась, и заново проверяет людей, которых Slack не знал. Это путь восстановления после сбоя или смены токена.
Права доступа¶
| Право | Позволяет |
|---|---|
ext.slack-notify.admin |
Настраивать подключение к рабочему пространству, сопоставлять людей, отправлять тестовые сообщения, читать журнал доставки и повторять неудачные отправки |
Для остальных вкладка скрыта. Конечным пользователям дополнительные права не нужны — они лишь отмечают галочки в собственных настройках уведомлений.
Если лицензия истекла или расширение отключено¶
Доставка приостанавливается, столбец Slack исчезает из диалога, но все настройки и включённые типы сохраняются. Обновлённая лицензия возобновляет доставку. То же верно для переключателя Доставлять уведомления в Slack: он приостанавливает доставку, ничего не удаляя, — сообщения в очереди просто ждут.
Токен бота хранится в зашифрованном виде и исключён из переноса рабочего пространства.
Ограничения¶
- Только личные сообщения — публикаций в каналы нет.
- Интерактивных кнопок нет. Действия вроде «Отметить выполненным» или «Утвердить» прямо из Slack в этой версии недоступны; сообщение ведёт обратно в Turbo EA.
- Сводок нет — каждое уведомление отправляется отдельным сообщением, а не сгруппированной сводкой.
- Не включайте ротацию токенов Slack (см. предупреждение выше).