WorkenДокументация/ Проект и командаworken.ru

проект и команда · статья 26

Уведомления: адресаты, правила, журнал

Кабинет знает всё, что происходит с вашими ИИ-сотрудниками, — но для этого в нём надо сидеть. Экран «Настройки → Уведомления» решает обратную задачу: вы занимаетесь своими делами, а проект сам сообщает о важном туда, где вы и так живёте, — в телеграм или на почту. Здесь выбирают, о каких событиях рассказывать, кому доставлять и как проверить, что всё дошло.

1

Что решает экран

На экране три блока, и читаются они как одна фраза:«Правила» — о чём проект сообщает, «Куда доставлять» — кому, «Журнал доставки» — что из этого реально дошло. Настраивают его владелец и администратор; оператор и наблюдатель по прямой ссылке увидят заглушку «Уведомления проекта настраивают владелец и администратор».

Экран «Настройки → Уведомления» целиком: блок «Куда доставлять» со строками Кабинет (всегда включён), Почта lena@gippokrat.ru (доставляем), Почта admin@gippokrat.ru с маркером «АДРЕС НЕ ПОДТВЕРЖДЁН» и кнопкой «Прислать подтверждение», Телеграм (бот Worken · Тарас · подключено 28 августа, кнопки «Проверить» и «Отвязать»), Битрикс24 (не подключена, кнопка «Подключить в „Каналах“») и кнопкой «Отправить пробное всем»; ниже строка «Пуш в этом браузере», блок «Правила» с событиями «Разговор завершён» и «Разговор затих» и «Журнал доставки»; в меню слева подсвечен пункт «Настройки → Уведомления»
Весь экран: адресаты, пуш-строка, правила и журнал. Один из адресов почты помечен «адрес не подтверждён».
здесь — проект, в «Профиле» — выУровня два, и их легко перепутать. На этом экране — адресаты и правила проекта: общие для всех, кто в нём работает. Личные каналы каждого человека — моя почта, мой телеграм — живут в «Профиле», вкладка «Уведомления» (о ней — следующая статья). Отвязать телеграм здесь — замолчит проектный бот у всех; личные уведомления каждого продолжат приходить.
2

Куда доставлять: четыре адресата

Кабинет — всегда включён, и выключателя у него нет: счётчики в меню, лента «Сводки» и очередь «Требует решения» — это и есть уведомления кабинета. Отключить его значило бы ослепить сам экран, поэтому строка просто констатирует факт.

Почта — адреса, на которые проект пишет письма. У рабочего адреса подпись «доставляем», а вот адрес, владелец которого не нажал кнопку в письме-подтверждении, помечен жёлтым маркером «адрес не подтверждён» — и на него платформане отправляет ничего, сколько бы правил ни было включено. Кнопка Прислать подтверждение отправляет письмо ещё раз: попросите владельца адреса открыть его и нажать кнопку — с этого момента адрес рабочий.

Телеграм — бот Worken, привязанный к проекту. Кодов и цифр вводить не надо: кнопка «Подключить по ссылке» открывает бота, бот подтверждает привязку — в строке появляется, кто и когда подключил: «бот Worken · Тарас · подключено 28 августа». Рядом два действия: Проверить — прислать в телеграм проверочное сообщение (не пришло за минуту — посмотрите, не остановлен ли бот), и Отвязать — бот замолкает для всего проекта.

Битрикс24 — доставка в портал через интеграцию из «Каналов». Пока интеграция не подключена, строка честно говорит об этом и ведёт кнопкой в «Каналы» — отдельного подключения «только для уведомлений» не существует.

Внизу блока — кнопка Отправить пробное всем: одно пробное уведомление уходит сразу во все подключённые адресаты, а рядом написано, когда пробовали в последний раз. Это проверка всей цепочки разом — после любой перенастройки нажмите её и посмотрите, что дошло, а что нет:

Клик по кнопке «Отправить пробное всем» — в «Журнале доставки» появляются три строки «Пробное уведомление · только что» со статусом «доставлено»: Кабинет, Почта · lena@gippokrat.ru и Телеграм · Тарас; счётчик журнала растёт с 7 до 10
«Отправить пробное всем» — и в журнале сразу три строки «только что»: кабинет, почта, телеграм.

Сноска под блоком отвечает на вопрос технических людей: доставки по вебхуку здесь нет — это инструмент разработчика, он настраивается в разделе «Разработка → API и вебхуки».

3

Пуш браузера — строка вне списка

Между адресатами и правилами — одинокая строка «Пуш в этом браузере». Она нарочно не в списке адресатов: всё в блоке выше — общее для проекта, а пуш — личный и живёт в одном браузере. Включите его на рабочем ноутбуке — всплывающие уведомления появятся только у вас и только там; на телефоне и у коллег ничего не изменится. При первом включении браузер спросит разрешение — без него пуш не заработает.

Строка «Пуш в этом браузере»: подпись «выключен — браузер ещё не спрашивал разрешения» и тумблер справа
Пуш — отдельной строкой: действует только у вас и только в этом браузере.
4

Правила: что и как рассказывать

Пока событий два. «Разговор завершён» — сотрудник закончил разговор с клиентом и подвёл итог: главный сигнал «работа сделана, вот результат». «Разговор затих» — клиент перестал отвечать и разговор остался без развязки: повод вернуться к нему руками. Новые события платформа добавляет постепенно — они появятся в этом же списке.

У каждого события — три режима:

Правило «Разговор завершён» с раскрытым списком режимов: Включено (отмечено галочкой), Только в журнал, Выключено; ниже флажки «включать итог разговора» (включён), «включать память», «скрыть контакты клиента» и лимиты «Не чаще [без ограничения] в час на проект · не чаще [одного раза] на один диалог»
Три режима правила: «Включено», «Только в журнал», «Выключено». Ниже — состав уведомления и лимиты словами.

Включено — событие уходит во все адресаты из блока выше.Выключено — не происходит ничего, даже записи. А между ними — режим, который легко недооценить: «Только в журнал». Событие фиксируется в журнале доставки, но наружу — ни в телеграм, ни на почту — не уходит. Это ответ на ситуацию «знать хочу, дёргаться — нет»: затихшие разговоры не будят вас вечером, но раз в день их список можно просмотреть в журнале. Чтобы режим не выглядел как «сломалось и не приходит», под заголовком правила появляется синий маркер:

Правило «Разговор затих» в режиме «Только в журнал»: под описанием синий маркер «ОСТАЁТСЯ В ЖУРНАЛЕ, НАРУЖУ НЕ УХОДИТ», флажки «включать итог разговора» и «скрыть контакты клиента» включены, лимиты «не чаще двух раз в час на проект · одного раза на один диалог»
«Только в журнал» подписан прямо в правиле: остаётся в журнале, наружу не уходит.

Ниже режима — состав уведомления, три флажка. Включать итог разговора — короткая выжимка «кто пришёл, что хотел, чем кончилось»; без неё уведомление — только факт события.Включать память — что сотрудник запомнил о клиенте за разговор. Скрыть контакты клиента — телефоны и почты клиента в тексте уведомления заменяются заглушкой. Включайте его, когда уведомления падают в общий телеграм-чат, который читает вся смена: итог разговора персоналу полезен, а номер клиента в общем чате — уже утечка.

Последняя строка правила — лимиты, и они написаны словами: «Не чаще двух раз в час на проект · не чаще одного раза на один диалог». Первый лимит спасает от вечера, когда двадцать разговоров завершились подряд и телеграм превратился в пулемёт; второй — от повторов по одному и тому же диалогу. Что не уложилось в лимит, не пропадает — остаётся в журнале.

начните с малогоОдин адресат — телеграм — и два правила как есть: «Разговор завершён» включено, «Разговор затих» только в журнал. Поживите так неделю: станет ясно, чего не хватает — тогда добавите почту, подкрутите лимиты или включите «затих» наружу. Обратный путь — включить всё сразу — кончается тем, что уведомления перестают читать вовсе.
5

Журнал доставки: что дошло на самом деле

Журнал — ответ на разговор «мне ничего не пришло». Каждая отправка — строка: время, событие, адресат и статус.Доставлено — ушло и принято. В очереди — платформа ещё отправляет; обычно статус меняется за минуты. Не доставлено — не ушло, и под строкой написана причина человеческим языком: «адрес не подтверждён — подтвердите адрес в блоке „Куда доставлять“». У недоставленных есть кнопкаПовторить — отправка встаёт в очередь ещё раз. Но повтор не лечит причину: пока адрес не подтверждён, письмо снова не дойдёт — сначала уберите причину, потом повторяйте.

Блок «Журнал доставки», 7 записей: строки за 28 августа — «Разговор затих» в Кабинет (доставлено), «Разговор завершён» в Телеграм · Тарас (доставлено), в Почту lena@gippokrat.ru (в очереди) и в Почту admin@gippokrat.ru — «НЕ ДОСТАВЛЕНО» с кнопкой «Повторить» и строкой «Причина: адрес не подтверждён — подтвердите адрес в блоке „Куда доставлять“»; ниже пробные уведомления в 13:40 и запись за 27 августа
Три статуса: «доставлено», «в очереди» и «не доставлено» — с причиной и кнопкой «Повторить».
молчание выглядит как порядок«Не доставлено · адрес не подтверждён» — самая коварная строка экрана: правила включены, адрес вписан, всё выглядитнастроенным — а уведомления молчат. Снаружи это неотличимо от «просто ничего не происходит». Поэтому после любой смены адресатов нажмите «Отправить пробное всем» и загляните в журнал: одна жёлтая пометка у адреса стоит десяти пропущенных «разговор завершён».