Бот в Telegram

Telegram-бот (телеграм-бот Actari) держит команду в курсе проекта, не заставляя открывать облако. Он присылает уведомления о том, что требует внимания, шлёт утреннюю сводку, отвечает на вопросы по проекту и по вашей просьбе отмечает, что фича ждёт чего-то внешнего.

Где в облакеКопировать ссылку на раздел

«Настройки» → вкладка «Уведомления». Там блок «Telegram» (личный чат), «Групповые чаты» и «Сводка и сигналы в Telegram».

Подключить личный чатКопировать ссылку на раздел

1. Откройте «Настройки → Уведомления» и нажмите «Подключить Telegram». Если кнопки нет и написано, что бот не настроен, значит на вашем сервере бот не включён.
2. Откроется Telegram со ссылкой на бота. Нажмите Start.
3. Бот ответит «Подключено к пространству …». В настройках появится «Telegram подключён» и кнопка «Отключить».

Ссылка одноразовая и живёт 15 минут. Если срок вышел, бот предложит подключить заново. Отключиться можно кнопкой «Отключить» или командой /stop в личном чате с ботом. Привязка относится к вам как участнику конкретного пространства; если вы состоите в нескольких, бот в личке отвечает по самому свежему и пишет, по какому именно.

Подключить группуКопировать ссылку на раздел

Группа получает всё то же, что и личка, а выпуски — только в группу, если она подключена. Подключать и отключать группы могут владелец и админ.

1. В «Настройки → Уведомления» в блоке «Групповые чаты» нажмите «Добавить в группу».
2. Выберите группу в Telegram и добавьте бота.
3. Бот напишет в группу, что подключён к пространству.

Одна группа привязана к одному пространству: чтобы перенести её, сначала отключите в старом. Если бота удалить из группы, привязка снимется.

Что бот присылает самКопировать ссылку на раздел

• Отчёты на приёмку, провалы и взятые намерения. Короткое сообщение со ссылкой: «отчёт сдан, ждёт приёмки», «задача провалена», «намерение взято в работу». Содержимое заданий и отчётов в сообщения не попадает.
• Выпуски. «Выпуск …» с блоками «Фичи» (название ссылкой и фраза «что нового») и «Мелкие правки», а в конце ссылка на ленту обновлений, если она публична. Название и фразы берутся из record_release и артефакта released: — см. Выпуски.
• Утренняя сводка по будням. «Доброе утро! Сводка по …» с блоками «Главное», «Застряло», «Ждёт решения», «Ждём внешнего», «В работе», «Вышло вчера» или за неделю и ссылкой «Открыть пульс» на страницу AI-продакта. Если ничего не происходит, бот так и пишет.
• Сигналы. Фича стала «к сдаче» или задача простояла больше суток.
• Вопросы по фичам. «Вопрос AI-продакта по …» или «Вопрос архитектора по …». Ответьте reply на это сообщение, и ответ запишется в фичу (бот подтвердит «Записал в фичу ✓»).
• Сигналы тестировщику. Когда задача с кейсами готова к проверке или кейс провален, см. Тест-план.

Настройки сводки и сигналов меняют владелец и админ, остальные видят значения: переключатели «Утренняя сводка по будням» (с выбором времени от 07:00 до 21:00 по Москве), «Сигналы: фича к сдаче, задача застряла», «Выпуски: что вышло на прод» и «Документы в ответах бота в группах». Сводка уходит в подключённую группу, а если групп нет — владельцу в личку.

Спросить ботаКопировать ссылку на раздел

В личке боту можно написать любой вопрос. В группе он отзывается на упоминание @ бота и на reply на его сообщение; пустое упоминание значит «что нового?». Привязанная группа обязательна, иначе бот молчит.

Бот отвечает по данным пространства: рассказ AI-продакта, сводка проекта, ваши задачи (в личке), оценки фич, ADR и карта системы, а также поиск по документации, фичам, задачам и журналу. Примеры вопросов: «что на мне?», «что у нас стоит?», «что вышло за последний месяц?». Ссылки в ответе ведут на фичи, задачи и решения.

Что важно знать:

• в группе бот показывает только то, что видит обычный участник, и отвечает всем участникам группы;
• по коду репозитория бот не ищет, только по тому, что есть в облаке и журнале;
• память диалога — цепочка ответов до десяти сообщений за последние сутки;
• лимит — 20 вопросов в час на чат;
• ответ строит AI пространства, поэтому он расходует квоту встроенного AI; без AI бот отвечает шаблоном и подсказывает включить AI.

Сам бот ничего не меняет в проекте — кроме одной отметки, описанной ниже.

«Ждём внешнего»Копировать ссылку на раздел

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

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

Бот не ставит отметку молча. Он показывает подтверждение: «Отметить: фича ждёт — причина?» с кнопками «Отметить», «Другая фича» и «Не надо» (для снятия — «Снять» и «Не надо»). Кнопка действует 24 часа, и в группе нажать её может только автор сообщения. Отмечать могут участники пространства с привязанным Telegram и ролью «участник» и выше. Такую же отметку можно поставить в облаке через меню действий фичи — см. Фичи и доска.

Связь с журналом и агентамиКопировать ссылку на раздел

Уведомления рождаются из событий журнала: сдачи отчёта, провала, взятия намерения и выпуска. Они доходят после синхронизации журнала с облаком. Выпуски, записанные давно, не уведомляют. Если Telegram блокирует бота, привязка снимается.