Telegram

Как подключить к доске бота Telegram, открыть доску в мини-приложении и получать уведомления в Telegram.

Бот доски

У доски один общий бот. Через него работает вход в мини-приложение, и он присылает уведомления в личные сообщения тем, у кого нет своего бота. Подключается он на вкладке Настройки → Telegram. Её видит тот, у кого есть право «Настройки установки → Правка настроек».

1. Создайте бота у @BotFather командой /newbot.
2. Вставьте выданный токен в поле «Токен бота».
3. Нажмите «Сохранить».

Изменения действуют сразу. После подключения доска покажет «Подключён бот @имя_бота» и поставит боту кнопку меню, которая открывает мини-приложение.

Кнопка меню не встала

Если Telegram не принял кнопку меню, доска покажет причину и адрес мини-приложения. Адрес мини-приложения должен быть на https. Кнопку можно указать у @BotFather вручную, этим адресом.

Чтобы заменить бота, введите новый токен и сохраните. Сохранённый токен доска не показывает. Кнопка «Отключить» отключает бота: вход в мини-приложение и уведомления через общего бота перестают работать.

Мини-приложение

Мини-приложение — та же доска, открытая внутри Telegram. Открывается кнопкой меню бота доски. Работает только в клиенте Telegram, в обычном браузере не откроется.

Привязать Telegram

При первом входе мини-приложение попросит связать Telegram с учётной записью доски:

1. Откройте мини-приложение кнопкой меню бота.
2. Введите «Почта или логин» и «Пароль» от доски.
3. Если доска просит согласие на передачу данных в Telegram, отметьте его.
4. Нажмите «Войти и связать».

Дальше вход в мини-приложение автоматический, без пароля. Привязать Telegram может только сам человек: согласие на передачу данных даёт он.

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

Если вход не проходит

Мини-приложение покажет причину и кнопку повтора. Чаще всего помогает закрыть его и открыть заново из меню бота: строка входа от Telegram действует около пяти минут.

Уведомления в Telegram

Уведомления от бота доски приходят в личные сообщения, если:

• Telegram привязан к вашей учётной записи — см. «Привязать Telegram»;
• вы нажали «Старт» у бота доски;
• вы дали согласие на передачу данных, если доска его запрашивает;
• канал Telegram включён для нужных событий — см. «Уведомления».

Согласие

Если Telegram привязан, а согласия нет, профиль покажет: «Уведомления в Telegram не отправляются, пока вы не дадите согласие на передачу данных.» Отметьте согласие и нажмите «Дать согласие».

В сообщении — название события, ключ и название задачи и ссылка на неё. Текста комментария в сообщении нет: его читают по ссылке, в самой доске.

Свой бот

Вместо бота доски уведомления может присылать ваш собственный бот — например, в топик рабочей группы.

1. Откройте свои настройки уведомлений: «Профиль» → кнопка с колокольчиком «Настроить уведомления пользователя».

2. В поле «Канал» выберите «Telegram». Ниже появится блок «Telegram-бот».

3. Заполните поля:

   Поле	Что указать
   Токен бота	Токен вашего бота от @BotFather
   Chat ID	Чат, куда слать уведомления
   Thread ID	Топик в чате. Необязательно

4. Нажмите «Сохранить Telegram».

Токен хранится зашифрованным и повторно не показывается. Чтобы сменить только чат или топик, оставьте поле «Токен бота» пустым. Бот должен иметь право писать в этот чат.

Пока свой бот подключён и указан чат, уведомления в Telegram идут через него, а не через бота доски. Кнопка «Отключить» убирает своего бота.