Что такое Telegram Agent и кому он нужен?
Telegram Agent — это инструмент для тех, кто ведёт каналы в Telegram и занимается маркетингом. Свои каналы публикуются по расписанию без рутины, чужие каналы и чаты отслеживаются как источники контента, а ИИ помогает писать комментарии и отвечать на вопросы простым языком. Всё в одном интерфейсе, на русском.
Нужно ли уметь программировать?
Нет. Бота для канала создаёт @BotFather в Telegram за минуту — токен вставляется в интерфейс и проверяется автоматически. Личный аккаунт подключается по данным приложения Telegram (api_id и api_hash с сайта my.telegram.org), номеру телефона и коду; если на аккаунте включена двухэтапная аутентификация — понадобится ещё облачный пароль из приложения Telegram. Очередь, расписание и аналитика устроены наглядно, без кода. Программирование нужно только тем, кто захочет свои скрипты для маршрутизации через API.
Безопасно ли подключать личный Telegram-аккаунт?
Сессии хранятся только в вашем контейнере (том /apps/telegram/sessions) и переживают перезапуски. Ключи доступа к аккаунту тоже остаются у вас — в томе данных, в файле account-secrets.yml. Облачный пароль нужен только в момент подключения — как пароль он нигде не сохраняется. Отключение аккаунта удаляет сессию, повторное подключение требует новый код Telegram. Аккаунт используется ровно для того, что вы настроили: источники и каналы, к которым у него есть доступ.
В чём разница между «каналом» и «источником»?
Каналы — ваши: ими вы управляете, в них публикуете. Источники — чужие каналы, чаты и RSS-ленты, за которыми вы наблюдаете: их сообщения собираются в ленту, разбираются тегами и могут попадать в вашу очередь контента.
Как ИИ помогает с комментариями?
ИИ предлагает три варианта комментария к посту из чужого канала, вы выбираете и правите перед публикацией. Есть шаблоны с подстановкой названия канала и имени автора, а лимиты (сколько комментариев в день на аккаунт) защищают канал от ошибок.
Можно ли пользоваться без Pastukhov Agent?
Да. Каналы, публикации, расписание, очередь, источники, лента, авторы, комментарии и аналитика работают самостоятельно. Интеграция добавляет кнопки «Вызвать агента» и чат с агентом — для этого нужен адрес и API-ключ вашего Pastukhov Agent.
Как активировать лицензию и что она даёт?
Ключ вводится в диалоге лицензии (подвал главного экрана) или передаётся переменной AGENT_LICENSE. Лицензия нужна только для отправки сообщений в чат агента; всё остальное работает и без неё. Ключ общий для продуктов этого семейства: один ключ может покрывать как Telegram Agent, так и Pastukhov Agent — в диалоге видно, какие продукты он покрывает. Лицензия входит в подписку «Фабрика агентов».
Где хранятся данные?
В двух постоянных томах вашего контейнера. Данные приложения — база, сессии Telegram-аккаунтов, доступы к ним (api_id и api_hash), медиа и ключи защиты данных — в томе /apps/telegram. А то, что вы настроили сами — каналы, источники, шаблоны постов, расписание, теги и правила комментирования, — в томе /project/apps/telegram обычными читаемыми файлами. Тома переживают пересоздание контейнера: файлы настроек можно скопировать на другой сервер или положить в git. Для полного переезда и резервной копии берите оба тома — доступы к аккаунтам лежат в томе данных, а не в папке настроек.
Можно ли не печатать задание агенту, а наговорить его?
Да: в поле ввода есть кнопка микрофона — нажмите, проговорите задание, нажмите ещё раз, и распознанный текст появится в поле готовым сообщением. Кнопка появляется, когда распознавание речи включено в настройках вашего Pastukhov Agent, и работает в панели чата и в строках очереди промптов. Подробнее — в разделе Голосовой ввод.
Можно ли передать агенту файл прямо из чата?
Да: в поле ввода есть вставка из буфера обмена (кнопка на компьютере, сочетание Ctrl+V, скрепка на телефоне). Скриншот, картинка или файл загрузятся в папку проекта, а в сообщение подставится путь к ним — агенту будет понятно, о каком файле речь. Подробнее — в разделе Агент.
Можно ли управлять продуктом из своих скриптов?
Да, для этого есть внешний API: каналы, боты, аккаунты, источники, очередь, сообщения, авторы, комментарии, расписание и аналитика доступны программам. Ключи создаются в настройках — полный ключ показывается один раз, отозвать его можно в любой момент, и он тут же перестаёт работать. Рядом со списком ключей есть интерактивная документация со всеми командами: запросы можно пробовать прямо в браузере. Ошибка приходит с понятным текстом и подсказкой, что исправить. Подробнее — в разделе Агент.
Как быстро найти нужное среди каналов, постов и комментариев?
В самом верху боковой панели есть одно поле поиска: начните печатать — и увидите совпадения по каналам, постам, авторам и комментариям сразу, сгруппированные со счётчиками. Ничего нажимать не нужно: результат появляется по ходу набора, а первыми идут совпадения по названию. Enter открывает верхний результат, Esc возвращает на страницу, где вы были; с любой страницы в поле поиска переносит Ctrl+K (на Mac — ⌘K). Поиск работает и без лицензии. Подробнее — в разделе Поиск.