Тема
Уведомления
Кто получает уведомления о задачах, по каким каналам они приходят и как выбрать, о чём сообщать.
Кому приходят уведомления
Уведомления получают только люди. О событии в задаче узнают её участники: ревизор, исполнитель, оператор и создатель. Если роль в задаче занимает агент, уведомление получает его владелец. Тот, кто сам совершил действие, уведомление о нём не получает.
Часть событий адресована одному человеку. Например, вопрос агента приходит только тому, кому он задан.
В доске
Все уведомления копятся под колокольчиком в шапке доски. Как работает список — в разделе «Меню и проекты».
Сколько последних уведомлений хранить под колокольчиком, задаётся в профиле, в поле «Глубина ленты уведомлений»: от 1 до 1000, по умолчанию 100.
Под колокольчик попадает всё. А всплывают в углу экрана только события, включённые для канала «В браузере» — см. «Настроить уведомления».
Системные уведомления
Обычно всплывающее уведомление видно, только пока доска открыта перед глазами. Чтобы видеть уведомления на другой вкладке или при свёрнутом окне, разрешите системные уведомления: откройте свои настройки уведомлений, выберите канал «В браузере» и нажмите «Разрешить системные уведомления». Разрешение действует в том браузере, где вы его дали.
Если браузер заблокировал уведомления, разрешите их в настройках сайта — значок замка у адреса.
Каналы
| Канал | Куда приходит | По умолчанию |
|---|---|---|
| В браузере | Всплывает на доске и в системе | включён |
| Telegram | В личные сообщения от бота доски или от вашего бота | включён |
| Почта | На почту из профиля | включён |
| Бот-ассистент | В ваш мост — агента, который сам ходит на доску | выключен |
| Вебхук | POST-запрос на адрес вашего моста | выключен |
Как подключить Telegram — в разделе «Telegram». Почту администратор настраивает при установке доски — см. «Шаблоны писем». Мосты описаны в разделе «Агенты».
Канал не настроен
Если канал не подключён в установке, под его названием будет написано: «Канал не настроен в установке: события сохранятся, но доставляться не будут.»
Настроить уведомления
Свои уведомления: «Профиль» → кнопка с колокольчиком «Настроить уведомления пользователя». Администратор и те, у кого есть права на пользователей, могут открыть эти настройки и для другого человека: «Пользователи» → та же кнопка в строке пользователя.
- В поле «Канал» выберите канал. Рядом с каждым каналом видно, сколько событий в нём включено, например «5 из 19».
- Включите нужные события. «Выбрать все» включает или выключает все события канала разом.
- Нажмите «Сохранить события».
События настраиваются для каждого канала отдельно. Например, в браузере можно видеть всё, а в Telegram получать только вопросы агентов.
События
| Событие | Когда приходит |
|---|---|
| Задача создана | Поставлена новая задача |
| Задача перемещена | Задача перешла на другую стадию |
| Экстренное перемещение | Задачу перевели в обход обычного пути |
| Задача поставлена на паузу | |
| Работа возобновлена | |
| Смена ревизора | Вас сняли с роли ревизора задачи |
| Новый комментарий | В обсуждении задачи новый комментарий |
| Упоминание | Вас упомянули в комментарии |
| Ожидается финальное решение | Работа закончена, но следующей стадии нет — ход за человеком |
| Ожидается оператор | |
| Ожидается согласование | Стадия пройдена, переход нужно подтвердить |
| Агент остановился | |
| Вопрос агента | Агент задал вам вопрос и ждёт ответа |
| Ошибка запуска | Запуск агента завершился ошибкой |
| Запуск требует внимания | Запуск не может продолжиться без человека |
| Лимит запросов | Агент упёрся в лимит модели. Работа продолжится сама |
| Запуск завершён | Запуск агента закончился |
| Согласование принято | Согласование принято |
| Согласование отклонено | Согласование отклонено |
Исходящий вебхук
Вебхук отправляет ваши уведомления во внешнюю систему: доска шлёт POST-запрос с JSON на адрес вашего моста. Приходят те же уведомления, что и вам.
Подключить
- Откройте мост: «Профиль» → «Агенты пользователя» → кнопка «Редактировать агента» у моста. Вебхук есть только у мостов — агентов с назначением «Мост — ходит на доску сам». Адрес можно указать и при создании моста, в поле «Адрес вебхука (необязательно)».
- В блоке «Вебхук моста» укажите адрес в поле «URL» и нажмите «Подключить». Адрес принимается только с https и только публичный: адреса внутренней сети запрещены.
- Доска покажет секрет подписи. Скопируйте его сразу — повторно он не показывается. Затем нажмите «Я сохранил секрет».
- Нажмите «Проверить», чтобы отправить пробный запрос. Доска покажет, что ответил приёмник.
- Выберите события: настройки уведомлений → канал «Вебхук» → в поле «Мост» выберите мост → включите события → «Сохранить события».
Пока события не выбраны, на вебхук ничего не уходит. События выбираются для каждого моста отдельно: у двух мостов одного человека может быть разный набор.
| Кнопка | Что делает |
|---|---|
| Сохранить адрес | Меняет адрес вебхука |
| Перевыпустить секрет | Выдаёт новый секрет. Прежний перестаёт действовать сразу — приёмник надо перенастроить |
| Отключить | Удаляет адрес и секрет. Уведомления на вебхук перестают уходить |
Что приходит
Тело запроса — JSON с полями:
| Поле | Что в нём |
|---|---|
notificationId | Идентификатор уведомления |
type | Тип события, например task.commented |
title | Ключ и название задачи: КЛЮЧ-1: Название |
taskId | Идентификатор задачи |
projectId | Идентификатор проекта |
url | Ссылка на задачу |
createdAt | Когда случилось событие |
Текста комментария в запросе нет. Его читают по ссылке, в самой доске.
Подпись лежит в заголовке X-QW-Signature в виде sha256=<подпись>. Это HMAC-SHA256 от тела запроса, ключ — секрет вебхука. Приёмник проверяет подпись и отбрасывает запросы, где она не сошлась.
Ответ приёмника
| Ответ | Что делает доска |
|---|---|
| 2xx | Уведомление доставлено |
| 429, 5xx, нет ответа | Повторяет позже |
| Остальные коды | Больше не повторяет |
Повторы
Повторная отправка может прийти на приёмник, который уже принял это уведомление. Отбрасывайте дубли по notificationId.
Действие, которое мост совершил сам, на его вебхук не приходит.
Если доставка не удалась
Если Telegram, почта или вебхук временно недоступны, доска повторяет отправку: через минуту, 5 минут, 15 минут и час — всего до пяти попыток. Под колокольчиком уведомление есть в любом случае.