Посібник користувача

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 без редактора у штаті
• Ентузіастам — збери канал на будь-яку тему й забудь про ручну публікацію

Від нуля до першого посту — три хвилини.

1. 01 Відкрий бота: @AutoPosting_REPRESIDIUM_bot
2. 02 Натисни /start. Отримаєш 7 днів безкоштовно.
3. 03 Зліва від поля вводу → 🟦 menu-button «Налаштування» → відкриється Mini App.
4. 04 🔑 API ключі → додай свій Gemini key (безкоштовно): зайди на aistudio.google.com/apikey → Create API Key → скопіюй → встав у поле «Gemini» → 🔎 Перевірити → 💾 Зберегти.
5. 05 ➕ Новий канал → опиши канал однією фразою. Gemini згенерує профіль автоматично.
6. 06 🌐 Telegram-канал → введи @your_channel → додай бота адміном каналу з правом «Публікувати повідомлення». Детальніше — у наступній секції.
7. 07 🚀 Опублікувати пост зараз → бот надішле шортлист → обери матеріал → пост опублікується.

Готово. Далі — налаштуєш розклад, і воно буде працювати само.

🎁 Trial — 7 днів безкоштовно

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

💎 DIY — $4.9/міс ($49/рік)

• Свої API-ключі (Gemini / OpenAI / Anthropic / DeepSeek)
• Платиш підписку нам + сам платиш AI-провайдеру напряму (~$0–5/міс)
• Без платформенних лімітів — генеруй хоч весь день
• Безкоштовний план Gemini теж підійде
• Для кого: технарям, тим хто вже працює з AI

🛡 Managed — $9.9/міс

• На наших API-ключах — жодних реєстрацій
• Ліміт: 150 генерацій + 60 публікацій на день на 1 канал
• Для кого: «не хочу розбиратись — просто увімкнув і працює»

⚠️ Ціна — за 1 канал. Кожна покупка додає +1 канал до твого ліміту. Хочеш 3 канали — купи 3 слоти.

Як оплачувати

• Telegram Stars (рекомендується) — нативно через Telegram, у Mini App тапни «💳 План і оплата».
• Картка (RU/UA/EU) / USDT / TON — напряму через @zvon_off.

ℹ️ Telegram Stars не працюють на акаунтах у РФ, РБ та низці інших країн — це обмеження Telegram. Використовуй другий варіант.

Усе керування каналом — через зручний інтерфейс у 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. 01 Відкрий документ → Поділитись → «Anyone with the link → Viewer»
2. 02 У Mini App → 📋 Контент-план → встав URL
3. 03 (Опційно) для авто-✅: відкрий Apps Script, встав код від бота через /gplan webhook, задеплой як Web App, поверни URL боту

Як працює

1. 01 Відкрий Mini App → 🤝 Запрошуй друзів
2. 02 Скопіюй своє реферальне посилання
3. 03 Ділись із тими, кому бот може бути корисним
4. 04 Коли запрошений оплачує першу підписку — 50% його платежу йде тобі у вигляді Stars-кредитів. Кредити чекають 21 день (період повернення Telegram), потім надходять на твій баланс.

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

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

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

Що ми зберігаємо

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

Що ми НЕ робимо

• Не передаємо твої дані третім особам
• Не використовуємо твій контент для тренування моделей
• Не підглядаємо у твої API-ключі — вони зашифровані

Видалення акаунта

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

Захист від злому

• HTTPS + Telegram WebApp HMAC-авторизація на кожен запит
• CSP / SSRF-захист, валідація всіх URL користувачів
• Шифрування секретів через cryptography.fernet

Видно при тапі / зліва від поля вводу:

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

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

За замовчуванням 1 канал на Trial і на один платіж. Кожна додаткова покупка збільшує ліміт на +1.

Що якщо закінчаться теми в Google Doc?

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

Чи можна публікувати в кількох каналах одночасно?

Кожен канал — окремий профіль із власним розкладом. Вони працюють незалежно.

Що якщо AI видасть дивний пост?

У режимі APPROVE ти побачиш шортлист до публікації — можеш обрати інший матеріал, перегенерувати, змінити рубрику. У AUTO — forbidden_phrases та prompt_hint допомагають уникнути небажаних формулювань.

Чи можна вимкнути картинки?

Так, тогл «Авто-картинка» в розділі Автоматизація. Або тисни «📤 Без картинки» на кожному чернетці вручну.

Що робити якщо бот не публікує?

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

Stars не працюють — що робити?

Telegram Stars недоступні у РФ, РБ та низці країн. Використовуй розділ «✉️ Зв’язатися для оплати» у Mini App — оплатиш карткою або криптою через @zvon_off.

Чи можна відмовитись від підписки?

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

Як змінити мову інтерфейсу?

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

• Telegram: @zvon_off — особистий контакт автора
• Сайт: represidium.com
• Бот: @AutoPosting_REPRESIDIUM_bot

Відповідаємо в робочий час (UTC+3) зазвичай протягом 1–2 годин.