Telegram

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

Что важно знать сразу

• Переписки внутри приложения нет. Список чатов и окно диалога в приложении не открываются: Telegram работает как интеграция и набор сценариев, а сами чаты вы разбираете через агента в чате Promto.
• Аккаунт один на рабочее пространство. Это не отдельная сессия для каждого участника.
• Приложение доступно по умолчанию. Если Telegram не нужен в Dock и на рабочем столе, выключите его в Настройках → раздел Доступные возможности → Телеграм.
• Личный бот CLI-агента — это другое. Связка Codex, Claude Code, Hermes или OpenClaw с собственным ботом описана в статье Telegram для CLI-агентов.

Подключение

1. Откройте приложение Telegram на рабочем столе или в Dock.
2. Нажмите Подключить на карточке подключения (или откройте Настройки внутри приложения).
3. Прочитайте условия общего доступа и поставьте отметку согласия — без неё подключение не начнётся.
4. Выберите способ входа:

• По номеру телефона — введите номер, затем код из Telegram;
• По QR-коду — отсканируйте код в мобильном Telegram: Настройки → Устройства → Подключить устройство.

1. Если на аккаунте включена двухэтапная аутентификация, введите пароль от неё.
2. Дождитесь статуса Синхронизирован.

Код входа, пароль двухэтапной аутентификации и QR-ссылка видны только владельцу подключения. Ни другому участнику, ни агенту они не передаются.

Главный экран

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

Сценарий	Что делает
Разобрать входящие	Находит непрочитанное и требующее ответа, группирует по срочности, готовит сводку
Подготовить ответы	Формулирует ответы в вашем тоне по диалогам, где ждут реакции
Опубликовать пост	Готовит публикацию для канала и показывает предпросмотр до отправки
Обработать лиды	Выделяет обращения, статусы, обещания и следующий шаг, готовит черновики follow-up
Проверить сообщество	Ищет спам, конфликты, повторяющиеся вопросы и сообщения без ответа
Собрать отчёт	Суммирует темы, решения, договорённости и незакрытые задачи за период

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

Настройки и отключение

Экран Настройки внутри приложения — единственное место, где видно, через какой аккаунт действует агент:

• имя, аватар и данные подключённого аккаунта;
• состояние синхронизации: Ожидает, Синхронизируется, Синхронизирован, Ошибка синхронизации;
• Обновить — перечитать состояние подключения;
• Отключить — отвязать аккаунт от рабочего пространства.

Отключение доступно только владельцу рабочего пространства и подтверждается отдельным вопросом. После отключения агент немедленно теряет доступ к аккаунту.

Что умеет агент

Основной агент работает через инструмент promto_telegram, терминальные агенты (Codex, Claude Code, Hermes, OpenClaw) — через команду promto telegram <действие> внутри сессии терминала.

Группа	Действия
Чтение	status, list_dialogs, get_messages, search_messages, get_members, get_contacts, action_logs
Сообщения	send_message, reply, edit_message, delete_messages, forward_messages, react, mark_read, pin_message, unpin_message
Файлы	upload_sandbox_file, send_file, download_file
Чаты	join_chat, join_by_link, leave_chat, mute_chat, unmute_chat, archive_chat, unarchive_chat
Группы и каналы	create_group, create_supergroup, create_channel, add_member, remove_member, ban_member, unban_member, promote_member, demote_member
Контакты и профиль	add_contact, remove_contacts, block_user, unblock_user, set_profile
Прочее	invoke — вызов метода Telegram, не покрытого списком выше

Типичный порядок работы: сначала list_dialogs или search_messages, чтобы получить числовые ID чата и сообщения, затем действие с этими ID. @username вместо ID не принимается.

Чтобы отправить файл из рабочего пространства, агент сначала загружает его командой upload_sandbox_file (путь внутри /home/user), затем отдельным вызовом send_file отправляет полученный upload_id. Вложение из чата сохраняется обратно в /home/user через download_file.

Ограничения

• Каждое изменяющее действие агент выполняет с идентификатором request_id — повтор с тем же идентификатором не приводит к дублю сообщения. Действиям только на чтение он не нужен.
• Передача файлов агентом — до 50 МиБ на файл и только внутри /home/user.
• За один запрос возвращается не более 100 диалогов или сообщений; дальше — постранично по курсору.
• Агенту недоступны код входа, пароль двухэтапной аутентификации, файлы сессии и токены доступа. Управление подключением — только через приложение и только у владельца.
• Через invoke запрещены методы авторизации, выхода из аккаунта, удаления аккаунта, настройки прокси и управления жизненным циклом сессии.
• delete_chat удаляет чат вместе с историей для этого аккаунта и необратим; leave_chat только выходит из группы. В команде терминального агента promto telegram действий delete_chat и clear_chat_history нет вовсе.
• Действия агента и участников пишутся в журнал Telegram на стороне Promto. Отдельного экрана журнала в приложении сейчас нет; агент читает свои записи действием action_logs.

Чего пока нет

• окна переписки, списка чатов и поиска по диалогам внутри приложения;
• экрана журнала действий;
• создания чата и просмотра участников из интерфейса приложения;
• нескольких Telegram-аккаунтов на одно рабочее пространство и персональных аккаунтов для отдельных участников.

Инструкции и CLI для агента

Отдельно включать инструмент не нужно: если аккаунт подключён, promto_telegram доступен агенту сразу. Не просите агента вводить код входа, пароль двухэтапной аутентификации или токены — эти шаги он выполнить не может и не должен.

Готовый промпт для агента

У рабочего пространства подключён общий Telegram-аккаунт, ты работаешь с ним через promto_telegram. Сначала уточни нужные чаты и сообщения через list_dialogs, get_messages или search_messages и используй только числовые ID. Помни, что аккаунт общий: любое изменение видно участникам рабочего пространства. Перед отправкой, редактированием или удалением покажи мне точный текст и список получателей и дождись подтверждения. Каждому изменяющему действию задавай стабильный request_id и проверяй результат перед повтором. Не запрашивай у меня код входа, пароль двухэтапной аутентификации или данные сессии.