UTCA · ГАЙД

Руководство пользователя

Полный гид по UTCA — Telegram-боту, который ведёт твой канал почти без тебя. Бот ищет материал, пишет посты в твоём стиле, генерирует картинки и публикует их по расписанию. Дальше — детально, по шагам.

ВИДЕО-ОБЗОР

Обзор функционала. И инструкция по настройке.

Полный гайд по UTCA в видеоформате — что умеет, как подключить канал, как настроить рубрики и стиль. 15 минут и вы готовы.

UTCA — обзор функционала и инструкция по настройке
01 · ВВЕДЕНИЕ

Что это и для кого

UTCA — Telegram-бот для автоматизации публикаций в каналах любой тематики.

Что умеет

  • 🔎 Реальный ресерч. Ищет свежие материалы в RSS-лентах + живой Google-поиск через Gemini. Скачивает оригинальные статьи и пересказывает их в твоём стиле, без выдумок.
  • 🎯 Твой стиль. Задаёшь Tone of Voice (формальность, юмор, сарказм), ключевые слова, запрещённые фразы — бот пишет именно так.
  • 📚 Любая ниша за минуту. Описываешь канал одной фразой — Gemini генерирует профиль: тему, аудиторию, тональность, рубрики.
  • 📑 Рубрики и баланс. News / Longread / Tools / Humor / Tips. Бот не выпустит три юмора подряд — держит пропорцию.
  • 📋 Контент-план в Google Doc/Sheets. Бот берёт следующую тему сам, отмечает опубликованные ✅ прямо в твоей таблице.
  • 🎨 Фирменные картинки. Загружаешь референсы и лого — AI генерирует в твоём стиле через Nano Banana / Imagen 4 / FLUX.
  • 🤖 3 режима автоматизации. Ручной апрув / Полный авто / Off.
  • 🌐 Несколько каналов в одном боте, каждый со своим профилем и расписанием.
  • 🛡 Защита от дублей. Не запостит одну статью дважды — помнит историю за 14 дней + семантический дедуп.
  • 🔑 Свои API-ключи — Gemini (бесплатно), OpenAI, Anthropic, DeepSeek. Хранятся зашифрованно (AES-128 + HMAC).

Для кого

  • Маркетологам и SMM — автоматизация контент-плана, посты в стиле бренда
  • Бизнесу — канал работает 24/7 без редактора в штате
  • Энтузиастам — собери канал по любой теме и забудь о ручной публикации
02 · СТАРТ

Быстрый старт (3 минуты)

От нуля до первого поста — три минуты.

  1. Открой бота: @AutoPosting_REPRESIDIUM_bot
  2. Нажми /start. Получишь 7 дней бесплатно.
  3. Слева от поля ввода → 🟦 menu-button «Настройки» → откроется Mini App.
  4. 🔑 API ключи → добавь свой Gemini key (бесплатно): зайди на aistudio.google.com/apikeyCreate API Key → скопируй → вставь в поле «Gemini» → 🔎 Проверить💾 Сохранить.
  5. ➕ Новый канал → опиши канал одной фразой. Gemini сгенерирует профиль автоматически.
  6. 🌐 Telegram-канал → введи @your_channelдобавь бота админом канала с правом «Публиковать сообщения». Подробнее — в следующей секции.
  7. 🚀 Опубликовать пост сейчас → бот пришлёт шортлист → выбери материал → пост опубликуется.

Готово. Дальше — настроишь расписание, и оно будет работать само.

03 · ВАЖНО

Бот должен быть админом канала

⚠️ Без этого бот не сможет публиковать. Это требование Telegram, обойти его нельзя. На этом шаге чаще всего застревают — поэтому он вынесен отдельно.

Как добавить бота админом

  1. Открой свой Telegram-канал.
  2. Нажми на название канала сверху → Управление каналом (Manage Channel).
  3. Раздел Администраторы (Administrators) → Добавить администратора (Add Admin).
  4. В поиске введи @AutoPosting_REPRESIDIUM_bot → выбери его.
  5. Включи право «Публикация сообщений» (Post Messages). Остальные права можно не давать.
  6. Сохрани изменения.

Что проверить если бот не публикует

  • Бот действительно добавлен в список администраторов канала.
  • У бота включено право «Публикация сообщений».
  • Username канала в Mini App совпадает с реальным (без опечаток, начинается с @).
  • Для приватных каналов — добавляй бота админом так же, и используй числовой ID канала вместо @username в Mini App.
💡 Не нужно давать боту лишних прав (удаление сообщений, бан пользователей и т. п.). Минимум — только «Публикация сообщений».
04 · ТАРИФЫ

Тарифы и оплата

🎁 Trial — 7 дней бесплатно

  • Со своим Gemini API ключомбез ограничений, как платный.
  • На общем ключе (без своего) — 9 генераций и 3 публикации в день.

💎 DIY

  • Свои API-ключи (Gemini / OpenAI / Anthropic / DeepSeek)
  • Платишь подписку нам + сам платишь AI-провайдеру напрямую
  • Без платформенных лимитов — генерируй хоть весь день
  • Бесплатный план Gemini тоже подойдёт
  • Кому: технарям, тем кто уже работает с AI

🛡 Managed

  • На наших API-ключах — никаких регистраций
  • Дневной лимит генераций и публикаций на 1 канал
  • Кому: «не хочу разбираться — просто включил и работает»
⚠️ Цена — за 1 канал. Каждая покупка добавляет +1 канал к твоему лимиту. Хочешь 3 канала — купи 3 слота.
ℹ️ Стоимость зависит от страны. Оплата проходит через Telegram Stars, курс которых к доллару немного отличается в зависимости от страны покупателя. Точную цену в местной валюте увидишь в Mini App в разделе «💳 План и оплата» — там же оплата в один тап.

Как оплачивать

  • Telegram Stars (рекомендуется) — нативно через Telegram, в Mini App тапни «💳 План и оплата».
  • Карта — только для UA / EU. Напрямую через @zvon_off.
  • USDT / TON — для всех остальных регионов. Также через @zvon_off.
ℹ️ Telegram Stars не работают на аккаунтах в РФ, РБ и ряде других стран — это ограничение Telegram. Используй карту (UA/EU) или USDT/TON.
05 · MINI APP

Mini App — настройки канала

Всё управление каналом — через удобный интерфейс в Telegram, без команд. Открывай через 🟦 menu-button слева от поля ввода в чате с ботом.

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

  • Каналы — список твоих каналов. Тап → редактор.
  • 🔑 API ключи — управление подключёнными провайдерами.
  • 💳 План и оплата — текущий план, использование, кнопки покупки.
  • 🤝 Приглашай друзей — реферальная ссылка и статистика.
  • ➕ Новый канал — создать канал, Gemini сгенерирует профиль по описанию.

Контент-стратегия

📌 Тема и ключевые слова

  • Тема канала — основная ниша
  • Подтемы — связанные направления
  • Boost-ключи — слова, повышающие релевантность
  • Exclude (стоп-слова) — материалы с этими словами игнорируются
  • Аудитория — описание, боли, интересы

🎨 Тональность (ToV)

Слайдеры формальности / юмора / сарказма (0..1), плотность эмодзи, длина поста, лицо повествования, запрещённые фразы, эталонные примеры стиля.

🧠 Промпт редактора

Текстовое поле с глобальными инструкциями для AI. Применяется к каждой генерации поверх ToV.

Пример: «Пиши конкретно, без воды. Каждое утверждение должно опираться на факты из источника. Не используй штампы вроде "стремительно развиваются".»

📑 Рубрики

Дефолтный набор: news (50%) · longread (20%) · tools (15%) · humor (10%) · tips (5%).

  • Доля — какая часть постов должна быть этой рубрики
  • Max подряд — не более N подряд (балансировщик переключит)
  • Промпт-хинт — как именно писать в этой рубрике
  • Игнорировать контент-план — для этой рубрики бот идёт в research, не в план
  • RSS приоритетнее Google — если RSS даёт достаточно материалов, Gemini не вызывается

Источники материала

🔎 Поиск в интернете (Gemini)

Тогл включения веб-поиска. Можно задать свои поисковые запросы — каждый с новой строки. Поддерживаются плейсхолдеры {topic} и {today}.

📰 RSS источники

Список URL-фидов. + Добавить RSS / × на каждом для удаления.

Публикация и расписание

🌐 Telegram-канал

  • @username канала (или числовой ID для приватных)
  • Язык канала (для перевода заголовков)
  • Часовой пояс (для расписания)
⚠️ Не забудь: добавь бота администратором канала с правом «Публиковать сообщения». Подробнее — в секции «Бот должен быть админом канала».

🤖 Автоматизация и расписание

  • ⏸ ПАУЗА — расписание выключено, постит только вручную
  • ✋ APPROVE — бот шлёт шортлист в личку, ты выбираешь и подтверждаешь
  • 🤖 АВТО — бот публикует самостоятельно без подтверждения
  • Частота: 1/нед · 3/нед · 1/день · 2/день · 3/день · 5/день
  • Авто-картинка — генерить AI-картинку для каждого поста
  • Источник по умолчанию — добавлять «Источник: domain.com» в публикацию
  • Хештеги по умолчанию — добавлять хештеги в публикацию

Визуальный стиль

  • Описание стиля — текст (например «минимализм, тёмный фон, неоновый зелёный»)
  • Референсы стиля — 2–5 фото бренда, AI учитывает палитру и композицию
  • Лого / бренд-ассеты — AI вшивает в композицию

Поддерживается JPEG / PNG / GIF / WEBP, до 8 MB. × на превью — удалить файл.

Контент-план (Google Doc / Sheets)

Подключи Google Doc или Google Sheets — бот берёт темы оттуда и сам помечает опубликованные.

Google Doc

  • Каждая тема — отдельная строка без отступа
  • Опциональный готовый текст поста — строки с отступом под темой

Google Sheets

  • Колонка A — тема
  • Колонка B — опциональный готовый текст
  • Колонка C — ✅ после публикации (нужен Apps Script webhook)
  • Колонка D — дата + ID сообщения

Подключение

  1. Открой документ → Поделиться → «Anyone with the link → Viewer»
  2. В Mini App → 📋 Контент-план → вставь URL
  3. (Опционально) для авто-отметки ✅: открой Apps Script, вставь код от бота через /gplan webhook, деплой как Web App, верни URL боту
06 · РЕФЕРАЛЫ

Реферальная программа

Как работает

  1. Открой Mini App → 🤝 Приглашай друзей
  2. Скопируй свою реферальную ссылку
  3. Делись с теми, кому может быть полезен бот
  4. Когда приглашённый оплачивает первую подписку — 50% его платежа идёт тебе в виде Stars-кредитов. Кредиты ждут 21 день (период возврата Telegram), затем поступают на твой баланс.

Карточка реферала

  • Перешло по ссылке — все, кто запустили бота по твоей ссылке
  • Пригласило (оплатили) — те, кто реально оплатил подписку
  • Stars · hold 21д — в холде
  • Выплачено — итоговый Stars-баланс

Кредиты применяются к будущим оплатам подписки. Хочешь вывести напрямую — напиши @zvon_off.

07 · БЕЗОПАСНОСТЬ

Безопасность и приватность

Что мы храним

  • Telegram ID и username — для авторизации
  • Профили каналов (тема, ToV, ключи и т. д.) — в JSON на нашем сервере
  • API-ключи — в зашифрованном виде (AES-128 + HMAC, мастер-ключ изолирован)
  • История публикаций — для дедупликации и аналитики
  • Embedding'и опубликованных постов — для семантического дедупа

Что мы НЕ делаем

  • Не передаём твои данные третьим лицам
  • Не используем твой контент для тренировки моделей
  • Не подсматриваем в твои API-ключи — они зашифрованы

Удаление аккаунта

Напиши @zvon_off — удалим всё в течение 24 часов: профили каналов, ключи, историю.

Защита от взлома

  • HTTPS + Telegram WebApp HMAC-авторизация на каждый запрос
  • CSP / SSRF-защита, валидация всех URL пользователей
  • Шифрование секретов через cryptography.fernet
08 · КОМАНДЫ

Команды бота

Видны при тапе / слева от поля ввода:

  • /start — приветствие и краткая справка
  • /app — открыть Mini App (через menu-button слева)
  • /billing — текущая подписка и тарифы
  • /whoami — твой ID, план, оставшиеся лимиты
  • /help — полная справка
09 · FAQ

Частые вопросы

Сколько каналов можно подключить?

По умолчанию 1 канал на Trial и на один платёж. Каждая дополнительная покупка увеличивает лимит на +1.

Что если кончатся темы в Google Doc?

Бот пришлёт уведомление за 1 день до того как тем станет меньше чем на сутки. Добавь новые строки — бот подхватит автоматически.

Можно ли публиковать в нескольких каналах одновременно?

Каждый канал — отдельный профиль с собственным расписанием. Они работают независимо.

Что если AI выдаст странный пост?

В режиме APPROVE ты увидишь шортлист до публикации — можешь выбрать другой материал, перегенерировать, сменить рубрику. В AUTOforbidden_phrases и prompt_hint помогают избегать нежелательных формулировок.

Можно ли отключить картинки?

Да, тогл «Авто-картинка» в разделе Автоматизация. Или жми «📤 Без картинки» на каждом черновике вручную.

Что делать если бот не публикует?

  1. Проверь что режим не на ПАУЗА
  2. Проверь что бот админ канала с правом публиковать (см. секцию «Бот должен быть админом канала»)
  3. Проверь что не закончился trial / план
  4. Проверь API ключи — если на общем ключе закончился лимит, бот пришлёт уведомление
  5. Не помогло — напиши @zvon_off

Stars не работают — что делать?

Telegram Stars недоступны в РФ, РБ и ряде стран. Используй раздел «✉️ Связаться для оплаты» в Mini App — оплатишь картой или криптой через @zvon_off.

Можно ли отказаться от подписки?

Telegram Stars позволяют возврат в течение 21 дня через @PremiumBot. Бот автоматически обработает refund.

Как сменить язык интерфейса?

В Mini App — селектор RU / UA / EN в правом верхнем углу.

10 · ПОДДЕРЖКА

Поддержка

Реагируем в рабочее время (UTC+3) обычно в течение 1–2 часов.

Открыть бота →

@AutoPosting_REPRESIDIUM_bot