Поддержка 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

Настройка и установка

В. Бот не отвечает, когда я его добавляю. Убедитесь, что он назначен администратором, а не просто «участником». Telegram → настройки группы → Администраторы. Повторное назначение происходит мгновенно; переустанавливать бота не нужно.

В. Можно ли перенести бота в другую группу? Да — добавьте его в новую группу, запустите там /setup. Два чата независимы (разные ID чатов = разные настройки, расписания, баллы). Переноса данных между чатами нет.

В. Бот публикует отчёты в основном потоке, а в моей группе есть темы — можно ли перенаправить? Изнутри нужной темы форума отправьте:

/set_topic Reports

Будущие отчёты будут направляться в эту тему. Сброс командой /set_topic clear.

В. Как удалить бота?

• Сначала остановите отчёты: /setup → ⏰ Расписание → ✕ Отключить расписание.
• Удалите бота: Telegram → группа → админы → выгнать @BWS_X_Bot.
• Настройки остаются в базе данных. Повторное добавление бота в тот же чат восстанавливает всё. Обратитесь в поддержку для полного удаления.

Отчёты и фильтрация

В. Почему мои цифры отличаются от сторонних трекеров? X Bot берёт данные напрямую из официального X API. Большинство сторонних трекеров парсят страницы или экстраполируют — мы измеряли расхождения 20–50%. Число из X API — источник истины.

В. В лидерборде показаны пользователи, которых я не ожидал отслеживать. Фильтры аддитивны. Если чат отслеживает кэштег $YOUR_TOKEN, в рейтинг попадает любой, кто пишет твит с этим кэштегом, а не только перечисленные вами аккаунты. Чтобы требовать и аккаунт, и кэштег одновременно, используйте форму from:@x cashtags:$YOUR_TOKEN через /set_x_filtering (семантика «И для всего» именованных фильтров).

В. Отчёт говорит «0 постов» — что теперь? Три варианта, по убыванию вероятности:

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

В. Можно ли отслеживать приватный/защищённый аккаунт X? Нет — X API возвращает только публичные посты.

В. Можно ли исключить конкретных пользователей из лидерборда чата (например, спам-ботов)? Да: /setup → 🎯 Фильтры → 🙈 Игнорировать → ➕ Добавить. Перечисленные хэндлы исключаются из результатов после выборки.

В. Почему в моём чате несколько срабатываний отчёта в день? Либо у вас настроен cron с несколькими срабатываниями (cron(0 14,22 ? * * *)), либо у вас несколько именованных фильтров на одном расписании. Каждый именованный фильтр производит собственный отчёт.

В. Выбор «Лучшего твита» кажется странным. ИИ-селектор выбирает пост с наибольшей вовлечённостью, который недавно не выбирался. Если результат стабильно кажется неверным — обратитесь в поддержку, промпт настраиваемый.

Автотрансляция X-постов

В. Трансляция переслала сразу тред из 6 постов. Я хотел только первый. Это связано с тем, что exclude=replies X API фильтрует только ответы другим пользователям; ответы на собственные твиты (продолжения треда) обходят этот фильтр. /setup → 📡 Автотрансляция X-постов → @аккаунт → выключите ☐ Продолжения треда. Тогда бот оставит только начало каждого треда.

В. Трансляция перестала пересылать в середине дня. Проверьте экран отдельной трансляции — если Today: 10/10 forwarded, вы достигли дневного лимита. Нажмите ✏️ Лимит, чтобы увеличить. Лимит сбрасывается в полночь UTC.

В. Трансляция показывает ⏸ Пауза, хотя я её не ставил. Бот автоматически ставит на паузу при ошибках «чат исчез» в Telegram (выгнали / заблокировали / чат обновился) и останавливает расписание опроса. /setup → 📡 Автотрансляция X-постов показывает эту строку на случай, если вы заново добавите бота.

Биллинг и кредиты

В. Что такое «кредит» именно? Один кредит = один пост, возвращённый X API. Чаты FREE получают 100 бесплатных кредитов в месяц; чаты PRO оплачиваются через Stripe (подписка) или ETH (пакет кредитов).

В. Где посмотреть баланс кредитов?/setup → 💳 Покупка кредитов. Показывает использовано / осталось / дату сброса.

В. Я только что заплатил, но баланс / тариф не обновился.

• Путь Stripe (подписка по карте): webhook обычно активирует PRO за секунды. Если через 5+ минут вы всё ещё не видите PRO ✓ в /setup → 💳 Покупка кредитов, обратитесь в поддержку с квитанцией Stripe и ID чата.
• Путь ETH (пакет кредитов): подтверждение в блокчейне может занять 1–3 минуты. Если через 10 минут кредиты не появились, обратитесь в поддержку с хешем транзакции и ID чата.

В. Могу ли я иметь и подписку Stripe, И ETH-кредиты на одном чате? Да — они совмещаются. Чат PRO·кредиты, оформивший подписку, сохраняет существующий баланс ETH, и биллинг за каждую выборку сначала списывает ETH-кредиты, прежде чем включается месячная квота подписки. На практике: если у вас 5 000 ETH-кредитов и вы подписываетесь, первые 5 000 выборок вообще не затрагивают Stripe; последующие выборки используют квоту подписки 1 000/мес; всё сверх этого метрируется по $0.02/пост. Баланс ETH никогда не сгорает.

Единственное ограничение: чат, уже на PRO·подписке, сегодня не может добавить новый пакет ETH из того же процесса покупки (команда покупки это блокирует). Сначала отмените подписку, если хотите вернуться к биллингу только по кредитам.

В. Что происходит, когда мой баланс PRO·кредиты достигает нуля? Лицензия автоматически понижается до FREE. Бот продолжает выборку в рамках лимита FREE 100/месяц, пока и он не исчерпается. Следующий /setup → 💳 → 💰 Купить снова предложит оба пути.

В. Баланс кредитов привязан к чату или к пользователю? К чату. У каждой Telegram-группы свои кредиты и лицензия.

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

В. Мой проект не отображается на xbot.ninja. В текущем месяце должны быть достигнуты все три порога:

• Топ-счёт пользователя ≥ 300
• Отслеживаемых постов ≥ 5
• Активных пользователей ≥ 2

Первый месяц обычно и есть узкое место. Прямой URL https://xbot.ninja/?chatId=<ваш-id> работает независимо от этого.

В. Как узнать ID своего чата?/setup → ℹ️ О чате. Длинное целое число с отрицательным префиксом.

В. Можно ли настроить публичную карточку xbot.ninja?/setup → 🎨 Настройка. Задайте Название, Описание, Логотип, URL. Карточка обновляется при следующем цикле отчёта.

Особенности X API

В. Почему некоторые посты старше, чем ожидалось, попадают в счёт? Бот использует эндпоинт tweets/search/all (полный архив). Когда вы задаёте период, бот может выбирать посты из любого момента внутри него. По умолчанию — скользящие 24 ч, но свой период можно задать задним числом.

В. Иногда пост появляется в трансляции только через 5+ минут. Автотрансляция X-постов опрашивает каждые 5 минут. Задержка — до одного интервала опроса (~2.5 мин в среднем / ~5 мин в худшем случае). Плюс небольшая задержка X API и доставки Telegram.

В. X API вернул ошибку — что видит оператор? Внутренние счётчики ошибок растут, назначенные админы получают личное сообщение (/setup → 👥 Админы, чтобы настроить получателей). Частые коды 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

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