Чому ми переробили /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 credits або підписка PRO
• 📡 X Posts Auto-relay — пересилати пости обраних акаунтів у чат майже в реальному часі
• ❓ Help & Support — відкрити тікет, отримувати відповіді в особисті повідомлення Telegram

Кожна кнопка веде до іншого меню, а не до синтаксису, який треба пригадувати. Раніше налаштування кештегів означало запам’ятовування /set_x_filtering і правильний порядок аргументів. Тепер це /setup → 🎯 Filters → 💵 Cashtags → ➕ Add, і бот сам підказує, що йому потрібно далі.

Найбільше змінився досвід першого запуску. Нові чати тепер отримують 4-кроковий майстер швидкого старту: назва проєкту, потім фільтри, потім розклад, потім екран підтвердження — усе за менше ніж хвилину, без жодного синтаксису команд, який можна переплутати.

Що реально змінилося: показники активації#

Ми відстежували, який відсоток нових чатів запускав свій перший звіт протягом 24 годин після додавання бота — найчіткіший сигнал того, “чи людина справді пройшла налаштування, чи покинула процес.” До редизайну меню значна частка нових встановлень так і не завершувала конфігурацію: адміни тицяли в кілька слеш-команд, отримували помилку через невірний аргумент і замовкали. Після редизайну більшість нових чатів, які починали майстер швидкого старту, завершували його і мали запланований звіт того ж дня. Найбільша перевага майстра полягала не в навчанні людей новим функціям — а в усуненні можливості ввести щось неправильно.

Тікети підтримки на кшталт “як налаштувати X” також різко зменшилися після випуску меню, поступившись місцем більш конкретним питанням про тонке налаштування (як працює вибір найкращого твіту, наприклад), а не “де тут кнопка для цього.”

Що ми залишили як прямі команди#

Ми не видалили все. Кілька команд достатньо часто використовуються або корисні як швидкий шлях, тож ми залишили їх поза меню:

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

Це команди, які досвідчені користувачі вводять на автоматизмі, і ті, які скрипти чи автоматизації, швидше за все, викликають напряму. Залишивши їх, ми не зламали чийсь наявний робочий процес, водночас виправивши доступність для всіх інших. Інші 40+ застарілих команд технічно все ще працюють для зворотної сумісності, але вони більше ніде не документуються і не пропонуються — тепер підтримуваний шлях це меню.

Чи виправдала себе вартість міграції?#

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

Якщо ви створюєте Telegram-бота з більш ніж жменькою налаштувань, наша порада: не чекайте, поки у вас буде 50 команд, щоб прийняти це рішення. Поріг, після якого список команд перестає бути корисним, нижчий, ніж здається, коли ви самі додаєте функції одну за одною. Якщо ваші користувачі налаштовують те, що роблять не щодня — синтаксис розкладу, комбінації фільтрів, іменовані фільтри — кероване меню завжди переважає запам’ятовану команду. Якщо ж це команда, яку хтось запускатиме десятки разів на день, залиште її швидкою прямою командою.

Щоб детальніше розглянути, як на практиці працює сторона фільтрації /setup, дивіться відстеження активності X для запуску токена та відстеження кештегів для крипто-проєктів — обидва покроково розглядають поточне меню 🎯 Filters. Повний довідник по меню — документація по меню налаштувань — охоплює кожен екран, а огляд X Bot — найкраща відправна точка, якщо ви зовсім новачок у боті.

Готові відстежувати свою спільноту на X? Додайте @BWS_X_Bot у свою Telegram-групу, виконайте /setup, і ваш перший звіт спрацює за налаштованим розкладом. Тариф FREE покриває 100 постів/місяць — картка не потрібна.

Про цю статтю: цей пост був підготовлений за допомогою ШІ з використанням робочого процесу контенту X Bot і перевірений Nacho Coll, засновником і головним керівником Blockchain Web Services (BWS), перед публікацією. Кожне твердження про продукт перевіряється на живому боті. Дізнайтеся як ми використовуємо ШІ в нашому контенті. Помітили помилку? Зв’яжіться з нами через /setup → ❓ Help & Support.

“Це один із багатьох оглядів оновлень продукту — дивіться блог X Bot для нотаток про релізи, кейсів та глибоких розборів.”