# Бот в Telegram

Бот в Telegram отвечает по проекту, присылает уведомления и отмечает «ждём внешнего».

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

## Где в облаке

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

## Подключить личный чат

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

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

## Подключить группу

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

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

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

## Что бот присылает сам

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

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

## Спросить бота

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

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

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

- в группе бот показывает только то, что видит обычный участник, и отвечает всем участникам группы;
- по коду репозитория бот не ищет, только по тому, что есть в облаке и журнале;
- память диалога — цепочка ответов до десяти сообщений за последние сутки;
- лимит — 20 вопросов в час на чат;
- ответ строит AI пространства, поэтому он расходует [квоту встроенного AI](/docs/cloud/ai-settings); без AI бот отвечает шаблоном и подсказывает включить AI.

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

## «Ждём внешнего»

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

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

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

## Связь с журналом и агентами

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