---
title: "Начало работы"
id: "1727"
type: "page"
slug: "getting-started"
published_at: "2026-09-04T11:01:14+00:00"
modified_at: "2026-10-22T16:36:13+00:00"
url: "https://pastukhov.com/agents/telegram/docs/getting-started/"
markdown_url: "https://pastukhov.com/agents/telegram/docs/getting-started.md"
excerpt: "Telegram Agent — это один интерфейс для всего вашего маркетинга в Telegram. Свои каналы: публикации…"
---

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

[https://pastukhov.com/agents/telegram/docs/getting-started/.md](https://pastukhov.com/agents/telegram/docs/getting-started/.md)

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

## Для кого

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

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

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

## Первый вход

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

## Интерфейс

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

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

## Первые шаги

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

## Язык и тема

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

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

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

## Что дальше

Подключение и настройка каналов — в разделе [Каналы](/agents/telegram/docs/channels)
, написание постов — в [Публикации](/agents/telegram/docs/publishing)
, расписание — в [Расписание](/agents/telegram/docs/scheduling)
. Конвейер от идеи до публикации — в [Очередь контента](/agents/telegram/docs/queue)
. Наблюдение за чужими каналами начинается с [Источников](/agents/telegram/docs/sources)
, разбор собранного — с [Ленты сообщений](/agents/telegram/docs/messages)
 и [Авторов](/agents/telegram/docs/authors)
. Автоматический разбор контента — в [Маршрутизации](/agents/telegram/docs/routing)
, вежливые комментарии под постами других — в [Комментарии с ИИ](/agents/telegram/docs/comments)
, цифры по каналам — в [Аналитике](/agents/telegram/docs/analytics)
, быстрое нахождение нужного — в [Поиске](/agents/telegram/docs/search)
, помощник внутри продукта — в [Агент](/agents/telegram/docs/agent)
.

[← Оглавление документации](/agents/telegram/docs)