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

Работа в Promto

Общий Telegram-аккаунт рабочего пространства: подключение, сценарии и действия агента.

6 мин чтения

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

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

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

Подключение

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

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

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

Код входа, пароль двухэтапной аутентификации и 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 и проверяй результат перед повтором. Не запрашивай у меня код входа, пароль двухэтапной аутентификации или данные сессии.

← Документация

Работа в Promto

Общий Telegram-аккаунт рабочего пространства: подключение, сценарии и действия агента.

6 мин чтения

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

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

Подключение

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

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

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

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

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

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

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

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

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

Группа	Действия
Чтение	`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, не покрытого списком выше

Ограничения

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

Чего пока нет

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

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

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

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