Підтримка X Bot: усунення несправностей, FAQ і контакти

Більшість проблем вирішуються однією дією в /setup. Перша половина цієї сторінки проведе вас через потік самодіагностики; друга половина — FAQ. Якщо жодне з них не допомагає, контактна форма внизу веде напряму до каналу підтримки розробників BWS.

Спершу — потік самодіагностики

Open /setup → ℹ️ About in your chat.
└─ Copy that text. It's everything support needs to triage.

Then ask yourself, in order:

  1. Does the bot reply to /setup at all?
     ├─ No  → bot was kicked or demoted from admin → re-promote and retry
     └─ Yes → continue.

  2. Did /setup → 📊 Reports → ⚡ Generate report now produce something
     within 3 minutes?
     ├─ No DM, no post → check next question.
     ├─ DM "no posts found"  → filter too narrow or no on-topic posts;
                                /setup → 🎯 Filters to see
                                the literal X API query.
     ├─ DM "credit exhausted" → /setup → 💳 Buy Credits → 💰 Buy.
     ├─ Post landed but image looks wrong → re-fire; if persistent,
                                contact support with the chat ID.
     └─ Post landed correctly → you're fine.

  3. Are scheduled reports arriving?
     ├─ No  → /setup top screen shows the cron. Compare to actual UTC time.
              The bot's first scheduled fire happens AFTER the next cron tick,
              not immediately after setup.
     └─ Yes → all good.

Якщо жоден з цих кроків не привів до вирішення, перейдіть повз FAQ до контактного посилання.

FAQ

Налаштування та встановлення

Q. Бот не відповідає, коли я його додаю. Переконайтеся, що він призначений адміном, а не просто "учасником". Telegram → налаштування групи → Administrators. Повторне призначення миттєве; перевстановлення боту не потрібне.

Q. Чи можу я перемістити бота в іншу групу? Так — додайте його в нову групу, запустіть /setup там. Два чати незалежні (різні ID чату = різні налаштування, розклади, оцінки). Міграції даних між чатами немає.

Q. Бот публікує звіти в основну гілку, а в моїй групі є теми — можу я перенаправити? Зсередини потрібної форум-теми надішліть:

/set_topic Reports

Майбутні звіти маршрутизуються в цю тему. Скасувати: /set_topic clear.

Q. Як мені видалити встановлення?

• Спочатку зупиніть звіти: /setup → ⏰ Schedule → ✕ Disable schedule.
• Видаліть бота: Telegram → група → адміни → вигнати @BWS_X_Bot.
• Налаштування залишаються в базі даних. Повторне додавання бота до того самого ID чату відновлює все. Зверніться до підтримки для повного видалення.

Звіти та фільтрація

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

Q. У лідерборді показані користувачі, яких я не очікував відстежувати. Фільтри адитивні. Якщо чат відстежує кештег $YOUR_TOKEN, будь-хто, хто твітить цей кештег, отримує рейтинг, а не лише перелічені вами акаунти. Щоб вимагати і акаунт, і кештег одночасно, скористайтеся формою from:@x cashtags:$YOUR_TOKEN через /set_x_filtering (семантика "І-по-всіх-категоріях" іменованих фільтрів).

Q. У звіті написано "0 постів" — що тепер? Три можливості, за спаданням ймовірності:

1. Фільтр занадто вузький — /setup → 🎯 Filters показує буквальний запит X API. Часта помилка: $BTC (пробіл в кінці) замість $BTC.
2. Період занадто вузький — якщо ви встановили власний період, пости поза цим вікном не рахуються. /setup → 📊 Reports → 🗑 Clear period повертає до плаваючих 24 год.
3. Відстежувані акаунти справді нічого не публікували по темі за 24 год — розширте кештегами чи ключовими словами для резервного сигналу.

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

Q. Чи можу я виключити конкретних користувачів з лідерборду чату (напр., спам-ботів)? Так: /setup → 🎯 Filters → 🙈 Ignore → ➕ Add. Перелічені акаунти відкидаються з результатів після отримання.

Q. Чому мій чат публікує звіти кілька разів на день? Або ви встановили cron із кількома запусками (cron(0 14,22 ? * * *)), або у вас кілька іменованих фільтрів на тому самому розкладі. Кожен іменований фільтр створює власний звіт.

Q. Вибір "Best Tweet" здається дивним. AI-селектор обирає пост із найвищою залученістю, який нещодавно не обирався. Якщо результати постійно відчуваються неправильними, зверніться до підтримки — промпт можна налаштувати.

X Posts Auto-relay

Q. Relay переслав тред з 6 постів одразу. Мені потрібен був лише перший. Це тому, що exclude=replies X API фільтрує лише відповіді іншим користувачам; самовідповіді (продовження треду) обходять цей фільтр. /setup → 📡 X Posts Auto-relay → @account → вимкніть ☐ Thread continuations. Тоді бот залишає лише голову кожного треду.

Q. Relay перестав пересилати в середині дня. Перевірте екран окремого relay — якщо Today: 10/10 forwarded, ви досягли денного ліміту. Торкніться ✏️ Cap, щоб підвищити. Ліміт автоматично скидається опівночі UTC.

Q. Relay показує ⏸ Paused, хоча я не ставив на паузу. Бот автоматично ставить на паузу при помилках Telegram chat-gone (вигнали/заблокували/оновили чат) і зупиняє розклад опитування. /setup → 📡 X Posts Auto-relay показує рядок на випадок, якщо ви повторно додасте бота.

Рахунки та кредити

Q. Що таке "кредит"? Один кредит = один пост, повернутий X API. Чати FREE отримують 100 безкоштовних кредитів/місяць; чати PRO тарифікуються через Stripe (підписка) або ETH (пакет кредитів).

Q. Де я бачу баланс своїх кредитів?/setup → 💳 Buy Credits. Показує використано / залишок / дату скидання.

Q. Я щойно заплатив, але мій баланс/тариф не оновився.

• Шлях Stripe (підписка карткою): webhook зазвичай активує PRO протягом секунд. Якщо через 5+ хвилин ви не бачите PRO ✓ в /setup → 💳 Buy Credits, зверніться до підтримки з квитанцією Stripe та ID чату.
• Шлях ETH (пакет кредитів): ончейн-підтвердження може зайняти 1–3 хвилини. Якщо через 10 хвилин кредити не з'являються, зверніться до підтримки з хешем транзакції та ID чату.

Q. Чи можу я мати одночасно підписку Stripe ТА кредити ETH на одному чаті? Так — вони поєднуються. Чат PRO·credits, що підписується, зберігає наявний баланс ETH, і тарифікація за кожен запит спочатку списує кредити ETH, перш ніж задіяти місячний ліміт підписки. Практичний ефект: якщо у вас 5000 кредитів ETH і ви підписуєтеся, перші 5000 запитів взагалі не торкаються Stripe; наступні запити використовують місячний ліміт підписки на 1000; все понад тарифікується $0.02/пост. Баланс ETH ніколи не згорає.

Єдине обмеження: чат, що вже на PRO·sub, не може додати новий пакет ETH з того самого процесу покупки сьогодні (команда покупки це блокує). Скасуйте підписку спочатку, якщо хочете повернутися до тарифікації лише кредитами.

Q. Що станеться, коли мій баланс PRO·credits досягне нуля? Ліцензію автоматично знижують до FREE. Бот продовжує отримувати дані в межах ліміту 100/місяць FREE, поки і його не вичерпає. Наступний /setup → 💳 → 💰 Buy тоді знову пропонує обидва шляхи.

Q. Баланс кредитів прив'язаний до чату чи до користувача? До чату. Кожна група Telegram має власні кредити та ліцензію.

Публічний дашборд

Q. Мій проєкт не показується на xbot.ninja. Всі три пороги мають бути досягнуті в поточному місяці:

• Top user score ≥ 300
• Відстежені пости ≥ 5
• Активні користувачі ≥ 2

Перший місяць зазвичай є вузьким місцем. Прямий URL https://xbot.ninja/?chatId=<ваш-id> працює незалежно.

Q. Як мені знайти свій ID чату?/setup → ℹ️ About. Довге ціле число з мінусом на початку.

Q. Чи можу я налаштувати публічну картку xbot.ninja?/setup → 🎨 Customization. Встановіть Name, Description, Logo, URLs. Картка оновлюється на наступному циклі звіту.

Особливості X API

Q. Чому деякі пости старіші, ніж я очікував, враховуються? Бот використовує повнотекстовий пошуковий ендпоінт tweets/search/all. Коли ви встановлюєте період, бот може отримати пости з будь-якого моменту в ньому. За замовчуванням — плаваючі 24 год, але власний період може бути заднім числом.

Q. Іноді пост з'являється в relay через 5+ хвилин. X Posts Auto-relay опитує кожні 5 хвилин. Затримка становить до одного інтервалу опитування (~2.5 хв у середньому / ~5 хв у найгіршому випадку). Плюс невелика затримка X API + доставки Telegram.

Q. X API повернув помилку — що бачить оператор? Внутрішні лічильники помилок зростають, призначені адміни отримують приватний DM (/setup → 👥 Admins, щоб налаштувати кому). Часті коди 4xx: 401/403 (проблема з обліковими даними на боці оператора), 402 (кредити вичерпані), 429 (обмеження частоти запитів — бот повторює зі зростаючою затримкою).

Що вказати в запиті підтримки

Скопіюйте та вставте цей шаблон:

Project: <your project name>
Chat ID: <from /setup → ℹ️ About>
Plan: FREE / PRO·credits / PRO·sub
What's wrong: <1–2 sentences>
What you tried: </setup → … → … steps you ran>
When it broke: <approx UTC time>
Recent change: <any new filter / schedule / payment in the last 24 h>

Сам по собі ID чату дає підтримці 80% інформації для розбору — будь ласка, завжди його вказуйте.

Очікуваний час відповіді

• Критично: бот офлайн на всій платформі, збої з рахунками → відповідь протягом 1 робочої години в перетині бізнес-годин ЄС+США
• Високо: звіт не доставляється для одного чату → того ж робочого дня
• Звичайно: питання щодо функцій, допомога з налаштуванням → 1–2 робочих дні

Корисні посилання

• Telegram-бот: @BWS_X_Bot
• Публічний дашборд: xbot.ninja
• Документація: /docs/
• GitHub issues: blockchain-web-services/bws-api-telegram-xbot
• Пряма підтримка: bws.ninja — контактна форма веде до розробницької підтримки BWS

Перед зверненням до підтримки пройдіть потік самодіагностики в розділі Усунення несправностей — більшість проблем вирішуються на перших двох перевірках.