Telegram Bot

Подключения→Telegram Bot

Подключение даёт агенту полный Telegram Bot API: сообщения и медиа, inline- и reply-клавиатуры, опросы, реакции, команды, меню, платежи, inline mode, Telegram Business и кнопки Web App.

Подключить бота

1. Создайте бота в @BotFather и скопируйте token.
2. Откройте Подключения → Telegram Bot → Добавить.
3. Назовите подключение и вставьте token.
4. При создании MCP-подключения включите Telegram-инструменты в нужную роль.

Token хранится в подключении пользователя. Workflow и агент работают с ботом, но не получают сам token.

Как агент вызывает Bot API

Вместо сотен почти одинаковых инструментов агент получает небольшой динамический набор:

1. search_methods — находит нужный метод;
2. describe_method — возвращает актуальную схему параметров;
3. invoke_read, invoke_write или invoke_destructive — выполняет метод в соответствующей категории безопасности.

Например, для сообщения с inline-кнопками агент описывает sendMessage, затем передаёт стандартный Telegram reply_markup. Тот же механизм работает для любого другого метода Bot API.

WARNING

Удаление сообщений, блокировки, refunds и другие необратимые действия идут через отдельный destructive-инструмент и требуют подтверждения.

Файлы

Передавайте существующий Telegram file_id или публичный HTTPS URL. Для небольшой загрузки агент также может использовать $file_base64 с именем файла. Временный файл на сервере при этом не создаётся.

Входящие события

Workflow получает исходный raw_update без потери полей. Поэтому ему доступны не только текстовые сообщения, но и документы, фото, видео, голосовые, callback query, реакции, опросы, inline query, платежи и business updates.

Что остаётся у BotFather

Создание и удаление самого бота, получение token и отдельные настройки BotFather остаются в Telegram. Mini App тоже является отдельным веб-приложением; бот открывает его кнопкой web_app.