Telegram — Документация AI Team

Интеграции

Интеграция с Telegram превращает переписку с AI-командой в привычный мессенджер: не нужно держать открытым сайт, чтобы получать ответы агентов или отвечать им — всё происходит в Telegram, а история остаётся синхронизированной с сайтом в обе стороны.

How it works — step by step

Agents

Telegram bot — Backend

Connected: @backend_agent_bot

1. Go to "Agents" and click "Connect Telegram bot"

There's also — the whole project's Telegram forum

Projects

Telegram forum — Corner Cup

Group chat_id

-1001234567890

Admin bot token

123456789:AAE••••••••••••

1. Go to "Projects" and click "Telegram"

Manage a task right from Telegram

Go on, add the password check

⏳ Working on it...

⏹ Stop

📌 Task #42 · Login form

🔵 In progress · 💰 $0.37 · 🌿 feature/42-login

⏹ Stop🧹 Clear🗜 Compact🚦 Status🗣 Detail🌿 Branch🙈 Hide🗑 Delete🌐 Web

⚪ To do🔵 In progress ✓🟡 Awaiting your decision🟢 Done🔴 Waiting for agent« Back

⏹ Stop🚦 Status📌 Panel📋 Tasks⏰ Queue❓ Commands

1. While the agent is replying, “⏳ Working on it…” carries a “⏹ Stop” button

The AI Team mini app in Telegram

AI Team PM

Done — open the app whenever you need something

anna@cornercup.io

Password

••••••••

Corner Cup ▾

Active 3Awaiting decision 1

#42 Login form: password check🟡 Awaiting your decision

#47 Checkout screen on mobile layout🔵 In progress

#45 Cart regression before release⚪ To do

New task

#42 Login form: password check🟡 Awaiting your decision

Checked the form — all tests pass:npm run test -- login› Steps · 3

👍 1

Message QA Engineer... (@ to mention)

Task status

⚪ To do

🔵 In progress

🟡 Awaiting your decision✓

🟢 Done

🔴 Waiting for agent

1. In a chat with the bot, tap the Menu button — AI Team opens

Что можно делать

Завести отдельного Telegram-бота для каждого агента и общий форум (группу с темами) для проекта.

Переписываться с агентом в Telegram точно так же, как на сайте — с тем же результатом и той же историей.

Видеть отдельную тему в форуме под каждого агента и под каждую задачу — переписка не мешается в одну кучу.

Отправлять агенту файлы и картинки прямо из Telegram — он получит их так же, как вложение с сайта.

Получать реакции на сообщения синхронизированными в обе стороны.

Ответить агенту нативным «Reply» Telegram на его сообщение — тогда отвечает именно он, без необходимости писать его имя через «@».

Открыть тему нужной задачи в Telegram прямо по кнопке с сайта.

Ограничить круг людей, которым отвечает бот агента, списком доверенных Telegram-аккаунтов.

Как попасть

Настройка доступна администратору в двух местах: форум проекта подключается на странице «Проекты», бот конкретного агента — на странице «Агенты».

Проекты

иконка Telegram у проекта

Экраны раздела

Подключение форума проекта

только для администраторов

На карточке каждого проекта — иконка Telegram: серая и полупрозрачная, если форум не подключён, цветная — если подключён (наведите курсор, чтобы увидеть название и chat_id подключённой группы).

Раздел «Проекты» — иконка подключения форума

chat_id группы — числовой идентификатор Telegram-супергруппы с включённым режимом «Темы» (Topics). Узнать его можно, переслав любое сообщение из группы боту вроде @userinfobot.
Токен сервисного бота — токен отдельного бота от @BotFather, который создаёт темы в форуме. Этот бот должен отличаться от ботов агентов и быть добавлен в группу с правами администратора.
После подключения AI Team автоматически создаёт общую тему проекта и по одной теме на каждого уже подключённого активного агента.

Подключение бота агента

только для администраторов

Иконка Telegram рядом с агентом в списке — серая, если бот не подключён, цветная — если подключён (подсказка при наведении покажет @username бота).

Раздел «Агенты» — иконка подключения бота

Токен бота — получите у @BotFather командой /newbot. Важно: в настройках бота (Bot Settings → Group Privacy) выключите Group Privacy — иначе бот в группе будет видеть только команды и упоминания, а не обычные сообщения.
Доверенные Telegram-аккаунты — необязательный список username через запятую (с «@» или ссылкой t.me/username, либо числовой ID). Пустой список — бот отвечает всем.
Кнопка «Отключить бота» в этом же диалоге снимает бота с агента.

Открыть задачу в Telegram

У активной задачи в чате есть кнопка с иконкой Telegram — она открывает тему этой задачи в форуме в новой вкладке, создавая тему, если она ещё не появилась.

Кнопка перехода в тему задачи

Если у проекта не подключён форум или у агента задачи — бот, вместо перехода появится всплывающее сообщение с подсказкой.

Типичные действия

Подключить проект к Telegram

Откройте «Проекты» → иконку Telegram у проекта.
Введите chat_id группы и токен сервисного бота, нажмите «Подключить».

Подключить агента к Telegram

Откройте «Агенты» → иконку Telegram у агента.
Вставьте токен от @BotFather, при необходимости — список доверенных аккаунтов.
Нажмите «Подключить».

Написать агенту в Telegram

Откройте форум проекта в Telegram, найдите тему агента («Имя // роль»).
Напишите сообщение — агент ответит в этой же теме; ответ появится и в чате на сайте.

Частые вопросы и ограничения

Ограничения

Форуму нужен отдельный бот-администратор — тот же бот, что уже подключён к какому-то агенту, использовать нельзя.
У бота агента должен быть выключен режим приватности группы, иначе он не увидит обычные сообщения в группе.
В одном сообщении темы отвечают не более трёх агентов одновременно — как и в чате на сайте.
Если тему в Telegram удалить вручную, при следующем обращении к ней AI Team создаст новую — старая история восстановится, но ссылка на тему обновится.
История переписки импортируется в новые темы только если администратор не выключил импорт при подключении форума.

Аккаунты и ключи провайдеров Тарифы и подписка