Встановлення

Налаштуйте X Bot у своїй групі Telegram за три кроки. Більшість команд завершують встановлення менш ніж за три хвилини; майстер бере на себе всю важку роботу.

Найшвидший шлях — @BWS_X_Bot → додати в групу → /setup → 🚀 Quick Start. Чотири наступні запити — це все, що вам потрібно.

Підготуйте ці 5 елементів перед початком

Перш ніж почати, підготуйте:

Для покрокового огляду кожної опції, яку ви налаштуєте нижче, дивіться Меню /setup.

Вам потрібно	Звідки це береться
Акаунт Telegram	telegram.org
Права адміна в групі Telegram	Створіть, якщо у вас її немає: Telegram → New Group
Акаунт(и) X, кештег(и) або ключові слова, які хочете відстежувати	Напр., @your_username, $YOUR_TOKEN, "#YourCampaign"
(Опційно) Логотип проєкту + список URL	Для публічної вітрини xbot.ninja
(Опційно) Часовий пояс	Розклад у UTC; оберіть годину UTC, яка припадає на пік активності вашої спільноти

Не впевнені, який тариф вам потрібен? Перегляньте Тарифи — більшість команд починають з рівня FREE (100 постів/місяць) і апгрейдяться пізніше.

Якщо не впевнені, який сценарій вам підходить, перегляньте 4 сценарії використання в Огляді — оберіть найближчий і скористайтеся його рекомендацією щодо фільтрів у кроці 2 нижче.

Крок 1 — Додайте бота у свою групу

1. Відкрийте Telegram і знайдіть @BWS_X_Bot.
2. Додайте бота у свою групу.
3. Призначте його адміном. Жодних особливих дозволів понад стандартні права адміна не потрібно (боту потрібен статус адміна лише для того, щоб Telegram дозволив йому читати повідомлення групи і публікувати звіти).

Група, не DM

Аналітичні функції бота працюють лише в групах, не в приватних DM. Якщо ви почнете DM з @BWS_X_Bot, ви побачите, що /help і /buy працюють, але більшість меню налаштувань — ні.

Крок 2 — Запустіть /setup

У своїй групі введіть:

/setup

Бот відповість інтерактивним меню. Натисніть 🚀 Quick Start, щоб відкрити майстер з чотирьох кроків.

Майстер по черзі задає чотири питання:

Крок	Запит	Приклади
1	Назва проєкту	MyToken, KOL Campaign Q2, @your_username Performance
2	Що відстежувати в X	📢 Accounts + акаунти, 💵 Cashtags + тікери, або 🔍 Keywords + фрази
3	Коли боту запускатися	Оберіть щоденний пресет (09:00 / 14:00 / 18:00 / 22:00 UTC) або надішліть власний час
4	Готово	Підсумок збереженого

Skip і Exit завжди доступні — частково пройдений майстер ніколи вас не блокує, налаштування просто залишаються за замовчуванням.

Навіщо /setup? Він огортає кожну адмін-команду в клікабельний інтерфейс редагування на місці, тож не треба запам'ятовувати команди. Налаштування зберігаються миттєво. Досвідчені користувачі й далі можуть вводити slash-команди напряму — обидва інтерфейси еквівалентні, а поведінка ідентична. Повний огляд: Меню /setup.

Крок 3 — Перевірка

Коли майстер завершено, відкрийте /setup → 📊 Reports → ⚡ Generate report now, щоб отримати звіт негайно (наступний запланований звіт вийде у час, обраний вами в кроці 2).

Бот публікує зображення лідерборду в групі протягом ~1–3 хвилин. Менші чати (кілька акаунтів, низький обсяг постів) завершують швидше; чати спільнот з сотнями постів для отримання можуть зайняти 2–3 хвилини.

Дочекайтеся першого запланованого запуску

Після ручного Generate report now наступний автоматичний запуск відбудеться у налаштований вами час cron. Ви отримаєте один звіт на кожен запуск — без подвійних публікацій.

Вартість і кредити

X Bot використовує офіційний X API для отримання всіх даних. Кожен чат стартує на FREE; звідти можна додати один або обидва платні шляхи:

Тариф	Скільки платите	Що включено
FREE	$0	100 постів/місяць з жорстким лімітом. Бот призупиняє запити на 100; скидається 1-го числа наступного місяця.
PRO підписка (Stripe)	$19/місяць + $0.02/пост понад 1000/місяць (тарифікується через Stripe)	Автопродовжується. Перші 1000 постів/місяць включені як безкоштовний поріг (не кредитний баланс — без перенесення).
PRO кредити (ETH)	$0.02/кредит, пакети по 1000 / 2000 / 3000 / 4000 / 5000 / 10 000 / 50 000 / 100 000	Одноразово. Кредити ніколи не згорають. Поповнюють наявний баланс.

Чат може одночасно мати і PRO·sub, і PRO·credits — тарифікація за кожен запит списує спочатку кредити ETH, потім місячний ліміт підписки, потім тарифікований перевитрат. Дивіться тарифи для повної матриці переходів між тарифами та процесу купівлі.

Тариф і баланс завжди видно в /setup → 💳 Buy Credits. Призначені адміни отримують Telegram DM, коли кредити досягають 80%, і знову — коли вичерпуються повністю.

Рекомендовані наступні кроки за сценарієм

Оберіть рядок, що відповідає вашому сценарію, і перейдіть за посиланням до відповідного розділу Огляду для повного рецепту:

Сценарій	Що додати після майстра	Деталі
KOL-агенція відстежує 5 KOL	Уточнення кештегу + хештегу кампанії, розклад 22:00 UTC	Сценарій 1
Проєкт залучає спільноту	Логотип + URL у 🎨 Customization для публічної картки xbot.ninja	Сценарій 2
Портфоліо соло-KOL	Особисте фото + URL LinkedIn у Customization, поділіться URL xbot.ninja з потенційними клієнтами	Сценарій 3
Мультиклієнтська агенція	/setup → 🎯 Filters → ⤴ Named filters → ➕ Add named filter — один на клієнта	Сценарій 4
Отримання постів акаунта X у реальному часі	/setup → 📡 X Posts Auto-relay → ➕ Add Account	Меню /setup

Що налаштовується

Розділ у /setup	Що ви налаштовуєте	Чому це важливо
🎯 Filters	Акаунти, кештеги, ключові слова, згадки для відстеження в X	Визначає, які пости бот отримує
⏰ Schedule	Час доби для автоматичного звіту	На цьому cron бот запускає отримання + рендер
📊 Reports & Period	Опційне часове вікно (напр., період змагання)	Обмежує звіт конкретним проміжком
🎨 Customization	Назва проєкту, опис, логотип, URL, ваги та кольори лідерборду	Брендинг зображення звіту та публічної вітрини xbot.ninja
👥 Admins	Хто отримує приватні DM про проблеми з кредитами / запитами	Операційна видимість
💳 Subscription	Тариф, баланс кредитів, точка входу для апгрейду	Видимість витрат і оплата
📡 Auto-relay	Акаунти X для пересилання в чат у реальному часі (кожні 5 хв)	Живі оновлення між запланованими звітами

Публічна вітрина (опційно)

Якщо ваш проєкт відповідає порогам публічного лістингу (≥ 300 top score, ≥ 5 постів, ≥ 2 активних користувачі за поточний місяць), він з'являється на xbot.ninja. Додайте метадані проєкту через /setup → 🎨 Customization (Name, Description, Logo, URLs).

Налаштування соло-KOL (один акаунт) не проходять правило "≥ 2 активних користувачі" і залишаються доступними лише за прямим URL — це задумано.

Перевірка встановлення

Більшість діагностики видно безпосередньо в /setup (кожен екран показує поточний стан чату вгорі). Швидкий контрольний список:

Перевірка	Як
Бот — адмін	Telegram → налаштування групи → Administrators
Відстеження налаштоване	/setup → 🎯 Filters → перегляньте перелік акаунтів/кештегів/ключових слів
Фільтр рендериться коректно	/setup → 🎯 Filters
Розклад встановлено	/setup (вгорі меню показано поточний розклад)
Кредити доступні	/setup → 💳 Buy Credits
Ручний звіт працює	/setup → 📊 Reports → ⚡ Generate report now

Перший звіт не з'явився — усунення несправностей

Якщо Generate report now не публікує звіт протягом 3 хвилин:

Симптом	Ймовірна причина	Виправлення
DM бота каже "no posts found"	Фільтр занадто вузький АБО немає нещодавніх постів, що відповідають критеріям	/setup → 🎯 Filters — перевірте буквальний запит X API на помилки. Спробуйте розширити (приберіть період дат, якщо встановлений).
DM бота каже "credit exhausted"	Чат FREE досяг ліміту 100/місяць	Зачекайте наступного місяця, або /setup → 💳 Buy Credits → 💰 Buy, щоб оформити підписку / купити пакет кредитів
Нічого не відбувається, без DM	Бот не адмін, АБО webhook зупинився	Повторно призначте бота адміном. Якщо все ще нічого, зверніться до підтримки.
Зображення рендериться, але текст порожній	AI-коментар не встиг вчасно	Перезапустіть; тимчасова проблема. Якщо повторюється, зверніться до підтримки — у AI-провайдера іноді бувають перебої
Помилка "Unauthorized" / "Forbidden"	Проблема з токеном X API (з боку оператора)	Зверніться до підтримки; користувач це виправити не може

Самостійна діагностика

/setup → ℹ️ About показує ID чату, тариф і розклад на одному екрані. Скопіюйте цей текст у будь-який запит підтримки — це скорочує розбір приблизно на 80%.

Часті запитання про встановлення

Q. Чи можу я встановити бота в Telegram-канал (не групу)? Ні, лише групи та супергрупи. Канали не підтримують контекст відповіді на повідомлення, який використовує потік звітів.

Q. Чи можу я запустити бота у груповому форумі з темами? Так. Скористайтеся /set_topic зсередини теми, куди хочете публікувати звіти. Далі бот публікуватиме в цю тему; якщо не встановлено — публікує в основну гілку.

Q. Чи потрібен боту доступ на читання до повідомлень моєї групи? Боту потрібно лише отримувати командні повідомлення (напр., /setup). Він не читає звичайний чат. Дані по стороні X надходять з офіційного X API, а не з ваших повідомлень Telegram.

Q. Чи можу я відстежувати приватний/захищений акаунт X? Ні — X API повертає лише публічні пости. Відстеження захищеного акаунта мовчки повертає порожній результат.

Q. Чи видаляє видалення бота з групи мої дані? Ні. Налаштування, історія, оцінки та звіти залишаються в базі даних бота. Якщо ви повторно додасте бота до того самого ID чату, все відновиться. Якщо потрібне повне видалення — зверніться до підтримки.

Q. Чи можу я змінити назву проєкту пізніше? Так — /setup → 🎨 Customization → 🏷 Name. Оновлює наступний звіт і слаг URL публічної сторінки xbot.ninja.

Q. Чому я бачу інші показники постів, ніж у [інший інструмент]? X Bot отримує дані напряму з офіційного X API. Більшість сторонніх трекерів скрейпять або екстраполюють. Ми виявляли розбіжності 20–50% на практиці. Число з X API — джерело істини.

Q. Як мені скасувати?

• Чати FREE: просто видаліть бота з групи.
• PRO підписка: /setup → 💳 Buy Credits → 🛠 Manage subscription відкриває Клієнтський портал Stripe, де можна скасувати. Скасування набуває чинності наприкінці поточного оплаченого періоду.
• PRO кредити (ETH): кредити не поновлюються автоматично — чат сам переходить на FREE, коли баланс досягає нуля. Видаляйте бота в будь-який момент.

Потрібна допомога?

Дивіться Підтримку, або відкрийте /setup → ℹ️ About у своєму чаті для діагностичної інформації, якою можна поділитися з командою.

Прочитайте огляд X Bot для повного розбору того, що отримує кожна аудиторія — крипто-проєкти, KOL-агенції, соло-KOL, інвестори — перш ніж почати налаштування.