Установка

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

Самый быстрый путь — @BWS_X_Bot → добавить в группу → /setup → 🚀 Быстрый старт. Четыре следующих шага — это всё, что вам нужно.

Соберите эти 5 пунктов перед началом

Прежде чем начать, подготовьте следующее:

Пошаговый обзор каждой опции, которую вы настроите ниже, — в разделе Меню /setup.

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

Не уверены, какой тариф вам понадобится? Смотрите Тарифы — большинство команд начинают с тарифа FREE (100 постов в месяц) и позже переходят на более высокий уровень.

Если не уверены, какой сценарий вам подходит, просмотрите 4 сценария использования в Обзоре — выберите ближайший и используйте его рекомендацию по фильтрам на шаге 2 ниже.

Шаг 1 — Добавьте бота в свою группу

1. Откройте Telegram и найдите @BWS_X_Bot.
2. Добавьте бота в свою группу.
3. Назначьте его администратором. Особых прав сверх стандартных админ-прав не требуется (боту нужен статус администратора исключительно для того, чтобы Telegram позволял ему читать сообщения группы и публиковать отчёты).

Группа, а не личные сообщения

Аналитические функции бота работают только в группах, а не в личных сообщениях. Если вы начнёте личный диалог с @BWS_X_Bot, увидите, что /help и /buy работают, но большая часть меню настройки — нет.

Шаг 2 — Запустите /setup

В своей группе введите:

/setup

Бот ответит интерактивным меню. Нажмите 🚀 Быстрый старт, чтобы открыть мастер из четырёх шагов.

Мастер задаёт четыре вопроса по порядку:

Шаг	Вопрос	Примеры
1	Название проекта	MyToken, KOL Campaign Q2, @your_username Performance
2	Что отслеживать в X	📢 Аккаунты + хэндлы, 💵 Кэштеги + тикеры или 🔍 Ключевые слова + фразы
3	Когда боту запускаться	Выберите ежедневный пресет (09:00 / 14:00 / 18:00 / 22:00 UTC) или отправьте своё время
4	Готово	Сводка того, что было сохранено

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

Зачем нужен /setup? Он оборачивает каждую административную команду в кликабельный интерфейс с редактированием на месте, так что запоминать команды не нужно. Настройки сохраняются мгновенно. Опытные пользователи по-прежнему могут вводить слэш-команды напрямую — оба способа равнозначны, поведение идентично. Полный обзор: Меню /setup.

Шаг 3 — Проверьте

Когда мастер завершён, откройте /setup → 📊 Отчёты → ⚡ Сформировать отчёт сейчас, чтобы получить отчёт немедленно (следующий запланированный отчёт выйдет во время, которое вы выбрали на шаге 2).

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

Дождитесь первого запланированного запуска

После ручного «Сформировать отчёт сейчас» следующий автоматический запуск произойдёт в настроенное время cron. Вы получите один отчёт за срабатывание — без дублирования публикаций.

Стоимость и кредиты

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

Тариф	Сколько вы платите	Что включено
FREE	$0	100 постов в месяц по жёсткому лимиту. Бот приостанавливает выборку на 100; сброс 1-го числа следующего месяца.
Подписка PRO (Stripe)	$19/месяц + $0.02/пост сверх 1 000/месяц (метрируется Stripe)	Автопродление. Первые 1 000 постов в месяц включены как бесплатный порог (не кредитный баланс — переноса нет).
Кредиты PRO (ETH)	$0.02/кредит, пакеты по 1 000 / 2 000 / 3 000 / 4 000 / 5 000 / 10 000 / 50 000 / 100 000	Разовая покупка. Кредиты никогда не сгорают. Пополняют существующий баланс.

Чат может одновременно иметь и PRO·подписку, и PRO·кредиты — биллинг за каждую выборку сначала списывает ETH-кредиты, затем месячную квоту подписки, затем метрируемый перерасход. Полную матрицу переходов между тарифами и процесс покупки смотрите в разделе тарифы.

Тариф и баланс всегда видны в /setup → 💳 Покупка кредитов. Назначенные администраторы получают личное сообщение в Telegram, когда кредиты достигают 80% использования и когда они полностью исчерпаны.

Рекомендуемые следующие шаги по сценарию

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

Сценарий	Что добавить после мастера	Подробности
Агентство KOL отслеживает 5 KOL	Уточнение по кэштегу + хэштегу кампании, расписание 22:00 UTC	Сценарий 1
Проект вовлекает сообщество	Логотип + URL в 🎨 Настройке для публичной карточки xbot.ninja	Сценарий 2
Портфолио соло-KOL	Личное фото + URL LinkedIn в Настройке, делитесь URL xbot.ninja с потенциальными клиентами	Сценарий 3
Мультиклиентское агентство	/setup → 🎯 Фильтры → ⤴ Именованные фильтры → ➕ Добавить именованный фильтр — по одному на клиента	Сценарий 4
Получение постов X-аккаунта в реальном времени	/setup → 📡 Автотрансляция X-постов → ➕ Добавить аккаунт	Меню /setup

Что настраивается

Раздел в /setup	Что вы задаёте	Почему это важно
🎯 Фильтры	Аккаунты, кэштеги, ключевые слова, упоминания для отслеживания в X	Определяет, какие посты бот выбирает
⏰ Расписание	Время суток для автоматического отчёта	По этому cron бот запускает выборку и рендер
📊 Отчёты и период	Опциональное временное окно (например, период соревнования)	Ограничивает отчёт конкретным промежутком
🎨 Настройка	Название проекта, описание, логотип, URL, веса лидерборда и цвета	Брендинг изображения отчёта и публичной витрины xbot.ninja
👥 Админы	Кто получает личные сообщения о проблемах с кредитами / выборкой	Операционная видимость
💳 Подписка	Тариф, баланс кредитов, точка входа для апгрейда	Прозрачность стоимости и оплаты
📡 Автотрансляция	X-аккаунты для пересылки в чат в реальном времени (каждые 5 минут)	Живые обновления между запланированными отчётами

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

Если ваш проект соответствует порогам публичного листинга (≥ 300 максимальный счёт, ≥ 5 постов, ≥ 2 активных пользователя в текущем месяце), он появляется на xbot.ninja. Добавьте метаданные проекта в /setup → 🎨 Настройка (Название, Описание, Логотип, URL).

Настройки соло-KOL (один аккаунт) не проходят правило «≥ 2 активных пользователя» и остаются доступны только по прямому URL — так и задумано.

Проверка установки

Большинство диагностики видно прямо в /setup (каждый экран показывает текущее состояние чата вверху). Быстрый чек-лист:

Проверка	Как
Бот — администратор	Telegram → настройки группы → Администраторы
Отслеживание настроено	/setup → 🎯 Фильтры → список аккаунтов/кэштегов/ключевых слов
Фильтр рендерится корректно	/setup → 🎯 Фильтры
Расписание задано	/setup (вверху меню показано текущее расписание)
Кредиты доступны	/setup → 💳 Покупка кредитов
Ручной отчёт работает	/setup → 📊 Отчёты → ⚡ Сформировать отчёт сейчас

Первый отчёт не появился — устранение неполадок

Если «Сформировать отчёт сейчас» не производит публикацию в течение 3 минут:

Симптом	Вероятная причина	Решение
Личное сообщение бота: «постов не найдено»	Фильтр слишком узкий ИЛИ нет недавних подходящих постов	/setup → 🎯 Фильтры — проверьте буквальный запрос к X API на опечатки. Попробуйте расширить (уберите период, если он задан).
Личное сообщение бота: «кредиты исчерпаны»	Чат на FREE достиг лимита 100/месяц	Дождитесь следующего месяца или /setup → 💳 Покупка кредитов → 💰 Купить, чтобы оформить подписку / купить пакет кредитов
Ничего не происходит, нет сообщения	Бот не администратор ИЛИ webhook остановлен	Повторно назначьте бота администратором. Если всё ещё ничего — обратитесь в поддержку.
Изображение рендерится, но текст пустой	Тайм-аут ИИ-комментария	Повторите запуск; это временно. Если повторяется — обратитесь в поддержку, у ИИ-провайдера иногда бывают сбои.
Ошибка «Unauthorized» / «Forbidden»	Проблема с токеном X API (на стороне оператора)	Обратитесь в поддержку; пользователь ничего не может исправить

Самостоятельная диагностика

/setup → ℹ️ О чате показывает ID чата, тариф и расписание на одном экране. Скопируйте этот текст в любой запрос в поддержку — это сокращает время разбора примерно на 80%.

FAQ — частые вопросы об установке

В. Могу ли я установить бота в Telegram-канал (не группу)? Нет, только группы и супергруппы. Каналы не поддерживают контекст ответов на сообщения, который использует поток отчётов.

В. Можно ли запустить бота в группе-форуме с темами? Да. Используйте /set_topic изнутри темы, в которую нужно публиковать отчёты. Далее бот публикует в эту тему; если не задано — в основной поток.

В. Нужен ли боту доступ на чтение сообщений моей группы? Боту нужно только получать командные сообщения (например, /setup). Обычный чат он не читает. Данные со стороны X поступают из официального X API, а не из ваших сообщений в Telegram.

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

В. Удаляет ли удаление бота из группы мои данные? Нет. Настройки, история, баллы и отчёты остаются в базе данных бота. Если вы повторно добавите бота в тот же чат, всё восстановится. Для полной очистки обратитесь в поддержку.

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

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

В. Как отменить подписку?

• Чаты FREE: просто удалите бота из группы.
• Подписка PRO: /setup → 💳 Покупка кредитов → 🛠 Управление подпиской открывает портал клиентов Stripe, где можно отменить. Отмена вступает в силу в конце текущего оплаченного периода.
• Кредиты PRO (ETH): кредиты не продлеваются автоматически — чат сам переходит на FREE, когда баланс достигает нуля. Бота можно удалить в любой момент.

Нужна помощь?

Смотрите Поддержку или откройте /setup → ℹ️ О чате в своём чате для диагностической информации, которой можно поделиться с командой.

Прочтите обзор X Bot для полного разбора того, что каждая аудитория — крипто-проекты, агентства KOL, соло-KOL, инвесторы — получает от бота, прежде чем начинать настройку.