Начало работы

Telegram Agent — это один интерфейс для всего вашего маркетинга в Telegram. Свои каналы: публикации в удобном редакторе и публикация по расписанию, без рутины. Чужие каналы и чаты: наблюдение за конкурентами и партнёрами через источники. Разбор собранного: лента сообщений, авторы, теги — чтобы ничего ценного не терялось. И ИИ-комментирование чужих каналов, которое вежливо напоминает о вашем канале там, где обсуждают вашу тему.

Для кого

Для владельцев каналов, маркетологов и предпринимателей, которые ведут Telegram без программистов. Если вы публикуете вручную, следите за конкурентами в ленте вручную и мечтаете об одном месте, где видно всё — от расписания постов до того, что говорят чужие каналы, — это ваш инструмент.

Системные требования

Продукт работает на сервере с Linux и разворачивается через Pastukhov MultiAgent — в рамках «Фабрики агентов»: Docker и всё необходимое MultiAgent устанавливает сам. Данные хранятся в двух постоянных папках — /apps/telegram (база, медиа, сессии) и /project/apps/telegram (настройки читаемыми файлами). База данных встроена в продукт и работает из коробки.

Первый вход

Саморегистрация открыта, пока в приложении не создан ни один пользователь: первый зарегистрировавшийся становится администратором. Альтернатива — задать логин и пароль переменными окружения при запуске (пароль передаётся SHA-256-хэшем). Если не задано ничего, приложение само выдаст одноразовый пароль и напечатает его в консоль. Сессия входа живёт 90 дней — повторно входить часто не придётся.

Интерфейс

Продукт открывается на экране «Главная» — это сводка по всем каналам сразу: плитки с общими цифрами — сколько каналов и подписчиков (и насколько их стало больше за день), просмотры за сутки, средняя вовлечённость за неделю, комментарии за 30 дней, — список «Требуют внимания» с каналами, у которых не запланировано ни одного поста, и сетка «Разделы» со всеми разделами продукта. Цифры показываются на момент входа и берутся из раздела «Каналы»: там у каждого канала своя карточка с подписчиками, просмотрами за 24 часа, вовлечённостью, последним опубликованным и следующим запланированным постом, а под карточками — общая лента недели всех каналов. «Вовлечённость» — это доля подписчиков, которые открыли пост: она показывает, насколько контент интересен аудитории.

Разделы продукта собраны в боковой панели по группам: «Главная», затем «Маркетинг» (Каналы, Комментарии, Источники, Авторы), «Подключения» (Боты, Аккаунты) и «Система» (Скрипты). Ширину панели можно менять перетаскиванием, а свернуть её — кнопкой в шапке панели: тексту отведётся больше места. В самом верху боковой панели — поиск по всему продукту: каналы, посты, авторы и комментарии находятся из одного поля, по мере набора (подробнее — в разделе Поиск). Внизу боковой панели — кнопки «Промпты» (очередь заданий агенту) и «Чаты» (раздел «Чаты» появляется, когда подключён Pastukhov Agent). Тема и звуки переключаются кнопками в шапке, а кнопка с шестерёнкой открывает «Настройки» — там же раздел «API-ключи» для внешнего API, по которому с продуктом работают ваши скрипты. Статус лицензии — в подвале экрана «Главная»: имя владельца лицензии, тип ключа или «Нет лицензии».

Первые шаги

  • Создайте бота в @BotFather и вставьте его токен в раздел «Боты». Токен — секретный ключ доступа бота, его выдаёт @BotFather; через бота приложение подключается к каналам. Либо подключите личный Telegram-аккаунт в разделе «Аккаунты» — понадобятся данные приложения Telegram (api_id и api_hash с сайта my.telegram.org), номер телефона и код подтверждения. Если на аккаунте включена двухэтапная аутентификация, приложение попросит ещё облачный пароль — тот, что вы задали в приложении Telegram в разделе «Настройки → Конфиденциальность → Двухэтапная аутентификация»: это не код входа, а отдельный пароль;
  • Подключите свой канал в разделе «Каналы» — через бота (бот должен быть администратором канала) или из списка каналов вашего аккаунта;
  • Настройте слоты расписания — дни недели и времена, когда вы обычно публикуете: дальше даты публикации будут считаться сами;
  • Напишите первый пост в редакторе и опубликуйте его — сразу или в ближайший слот расписания;
  • Добавьте источник — RSS-ленту или чужой канал — и откройте ленту сообщений: собранное уже там.

Язык и тема

Язык интерфейса определяется брендом при установке (TELEGRAM_APP_BRAND=pastukhov — русский, xedant — английский). Тема — тёмная или светлая — переключается в интерфейсе одной кнопкой, так же как и звуки уведомлений.

Ярлык на рабочий стол

Приложение можно установить как PWA — обычный ярлык на рабочий стол или в меню приложений из браузера, без магазинов и установщиков. Открывается как отдельное окно. Интернет при этом нужен: офлайн-режима нет.

Что дальше

Подключение и настройка каналов — в разделе Каналы, написание постов — в Публикации, расписание — в Расписание. Конвейер от идеи до публикации — в Очередь контента. Наблюдение за чужими каналами начинается с Источников, разбор собранного — с Ленты сообщений и Авторов. Автоматический разбор контента — в Маршрутизации, вежливые комментарии под постами других — в Комментарии с ИИ, цифры по каналам — в Аналитике, быстрое нахождение нужного — в Поиске, помощник внутри продукта — в Агент.

← Оглавление документации