Зачем мы переделали /setup: от 50 команд к одному меню

Если вы добавили X Bot в групповой чат когда-то давно, вы, возможно, помните совсем другого бота. Были /set_x_filtering, /set_calendar, /set_top_count, /set_colors, /set_points, /set_topic и ещё около 45 таких же команд. У каждой функции была своя слэш-команда, потому что это казалось естественным способом раскрыть растущий набор функций в Telegram. Но это было не так.

Этот пост о том, почему мы отказались от такой структуры и заменили её единым меню /setup, что нам сказали цифры до и после, и что мы оставили для тех, кому нравился старый способ.

Проблема: 50 команд — это не список функций, а лабиринт#

Автодополнение команд в Telegram показывает прокручиваемый список сразу, как вы вводите /. Это отлично работает для пяти-шести команд. При 50+ это уже не меню, а стена текста, которую никто не читает от начала до конца. Новые админы — человек в Telegram-группе крипто-проекта, которому только что сказали «эй, настрой бота для трекинга» — вводили /setup, получали стену незнакомых команд и либо угадывали неправильно, либо сдавались.

Мы постоянно слышали это в тикетах поддержки, ещё до того, как у нас появился полноценный флоу ❓ Help & Support для их отлова: «как добавить кэштеги», «где настроить расписание», «а этот бот вообще делает отчёты». Ответом всегда была команда, которую они не нашли, погребённая в списке, который у них не было времени прочитать. У бота была вся нужная людям функциональность. Просто он не объяснял, где что находится.

Слэш-команды также плохо сочетаются друг с другом. Если вы хотели настроить фильтры, расписание и кастомизацию, это было три (или больше) отдельных вызова команд, каждый из которых требовал помнить точный синтаксис — /set_x_filtering @handle1 @handle2 $TOKEN, отформатированный именно так, без опечаток, без прощающих повторных попыток. Один неправильно составленный аргумент — и вы получали лаконичную ошибку и должны были начинать заново. Не было направляющего пути от «я только что добавил этого бота» до «у меня есть рабочий отчёт».

Решение: одна точка входа, всё доступно для обнаружения#

Мы свернули поверхность команд в единую команду /setup, которая открывает инлайн-клавиатуру — меню с нажимаемыми кнопками, которое Telegram поддерживает нативно. Вместо запоминания 50 названий команд вы видите 8 подписанных разделов и нажимаете нужный:

• 🎯 Filters — аккаунты, кэштеги, ключевые слова, упоминания, исключения, список игнорирования, именованные фильтры
• ⏰ Schedule — ежедневные пресеты, произвольное время, конкретные дни или полное cron-выражение
• 📊 Reports — запустить отчёт по требованию, посмотреть историю отчётов
• 🎨 Customization — название проекта, описание, логотип, URL-адреса, заголовок и цвет лидерборда, веса, количество top-N
• 👥 Admins — кто ещё может настраивать бота
• 💳 Buy Credits — пакеты ETH-кредитов или подписка PRO
• 📡 X Posts Auto-relay — пересылка постов выбранных аккаунтов в чат почти в реальном времени
• ❓ Help & Support — открыть тикет, получать ответы в личных сообщениях Telegram

Каждая кнопка ведёт в другое меню, а не в синтаксис, который нужно вспоминать. Настройка кэштегов раньше означала запомнить /set_x_filtering и правильно расставить аргументы. Теперь это /setup → 🎯 Filters → 💵 Cashtags → ➕ Add, и бот сам подсказывает, что ему нужно дальше.

Больше всего изменился опыт первого запуска. Теперь новые чаты получают мастер быстрого старта из 4 шагов: название проекта, затем фильтры, затем расписание, затем экран подтверждения — всё это меньше чем за минуту, без синтаксиса команд, в котором можно ошибиться.

Что реально изменилось: цифры активации#

Мы отслеживали, какой процент новых чатов запускал свой первый отчёт в течение 24 часов после добавления бота — самый чёткий сигнал того, «действительно ли человек прошёл настройку или отвалился». До редизайна меню значительная часть новых установок так и не завершала конфигурацию: админы тыкали в пару слэш-команд, получали ошибку из-за неправильно составленного аргумента и замолкали. После редизайна большинство новых чатов, начавших мастер быстрого старта, завершали его, и отчёт был запланирован в тот же день. Главным успехом мастера было не обучение людей новым функциям — а устранение возможности что-то ввести неправильно.

Тикеты поддержки о «как настроить X» тоже резко сократились после запуска меню, уступив место более конкретным вопросам о тонкой настройке (как работает алгоритм выбора лучшего твита, например), а не «где кнопка для этого».

Что мы оставили как прямые команды#

Мы не удалили всё. Несколько команд достаточно частые или достаточно полезные как быстрый путь, поэтому мы оставили их вне меню:

• /setup — открывает меню (сама точка входа)
• /report — запустить отчёт немедленно, без навигации по меню
• /buy — сразу перейти к покупке кредитов
• /subscription — проверить или управлять подпиской PRO
• /add_admin — добавить админа бота без захода в 👥 Admins
• /set_topic — задать целевую тему в группах в режиме форума
• /status — быстрая проверка состояния (активные фильтры, расписание, план)
• /get_chatid — иногда нужна для тикетов поддержки и отладки API

Это команды, которые опытные пользователи вводят на автомате, и те, которые скрипты или автоматизации с большей вероятностью вызывают напрямую. Оставив их, мы не сломали существующие рабочие процессы, при этом решив проблему обнаруживаемости для всех остальных. Остальные 40+ устаревших команд технически всё ещё работают ради обратной совместимости, но они больше нигде не документированы и не предлагаются — теперь поддерживаемый путь это меню.

Стоила ли эта миграция затраченных усилий?#

Да, но не бесплатно. Каждый экран меню должен был обрабатывать случай, когда пользователь нажимает кнопку, затем закрывает Telegram, а потом возвращается через три дня, ожидая то же состояние — инлайн-клавиатуры не хранят контекст разговора бесконечно, поэтому нам пришлось сделать каждый шаг заново вводимым, а не полагаться на линейный поток. Нам также пришлось серьёзнее подумать о правах доступа: меню провоцирует больше кликанья, чем команда, которую человеку нужно было искать и вводить вручную, поэтому 👥 Admins и проверки ролей были одновременно ужесточены.

Если вы создаёте Telegram-бота с более чем несколькими настраиваемыми параметрами, наш совет: не ждите, пока у вас будет 50 команд, чтобы принять это решение. Порог, после которого список команд перестаёт быть полезным, ниже, чем кажется, когда вы сами добавляете функции по одной. Если ваши пользователи настраивают что-то, чем не занимаются каждый день — синтаксис расписания, комбинации фильтров, именованные фильтры — направляющее меню всегда побеждает запоминаемую команду. Если это команда, которую кто-то будет выполнять десятки раз в день, оставьте её быстрой прямой командой.

Более подробный разбор того, как на практике работает сторона фильтрации /setup, смотрите в статьях отслеживание активности X для запуска токена и отслеживание кэштегов для крипто-проектов — обе пошагово разбирают текущее меню 🎯 Filters. Полный справочник по меню — в документации меню setup, а x-bot-overview — лучшая отправная точка, если вы совсем новичок в этом боте.

Готовы отслеживать своё сообщество в X? Добавьте @BWS_X_Bot в свою Telegram-группу, запустите /setup, и ваш первый отчёт придёт по настроенному расписанию. Бесплатный план покрывает 100 постов в месяц — без привязки карты.

Об этой статье: этот пост был составлен с помощью ИИ с использованием контент-процесса X Bot и проверен Nacho Coll, основателем и главным специалистом Blockchain Web Services (BWS), перед публикацией. Каждое заявление о продукте сверяется с работающим ботом. Читайте как мы используем ИИ в нашем контенте. Заметили ошибку? Свяжитесь с нами через /setup → ❓ Help & Support.

«Это лишь одно из многих обновлений продукта, которые мы освещаем — смотрите блог X Bot для заметок о релизах, кейсов и глубоких разборов».