/setupを再設計した理由:50個のスラッシュコマンドを1つのメニューに

以前にX Botをグループチャットに追加したことがある方なら、まったく違うボットを覚えているかもしれません。/set_x_filtering、/set_calendar、/set_top_count、/set_colors、/set_points、/set_topicなど、同じような形式のコマンドがさらに45個ほど存在していました。増え続ける機能をTelegramで提供する自然な方法だと思えたため、すべての機能に専用のスラッシュコマンドを割り当てていたのです。しかし、それは間違いでした。

この記事では、なぜその構造を撤廃して単一の/setupメニューに置き換えたのか、前後で数字がどう変化したのか、そして旧来のやり方を好むユーザーのために何を残したのかを解説します。

課題:50個のコマンドは機能一覧ではなく迷路だった#

Telegramのコマンド自動補完は、/を入力した瞬間にスクロール可能なリストを表示します。これはコマンドが5〜6個程度なら問題なく機能します。しかし50個を超えると、それはもはやメニューではなく、誰も最初から最後まで読まない文字の壁になってしまいます。「このトラッキングボットを設定しておいて」と言われたばかりの、暗号資産プロジェクトのTelegramグループの新任管理者は、/setupと入力しても見慣れないコマンドの壁にぶつかり、当てずっぽうで間違えるか、あきらめるかのどちらかでした。

❓ Help & Supportという正式なフローを用意する前は、サポートチケットでこの手の声が絶えませんでした。「cashtagsはどうやって追加するの?」「スケジュールはどこで設定するの?」「このボットにレポート機能はあるの?」といった具合です。答えは常に、彼らが見つけられなかった、そして読む時間もなかったリストの中に埋もれていました。ボットにはユーザーが求める機能がすべて揃っていました。ただ、それがどこにあるかを伝えていなかっただけなのです。

スラッシュコマンドは組み合わせにも向いていません。フィルター、スケジュール、カスタマイズを設定したい場合、それぞれ別々に3つ(あるいはそれ以上)のコマンドを実行する必要があり、しかも/set_x_filtering @handle1 @handle2 $TOKENのように正確な構文をすべて覚えておかなければなりませんでした。フォーマットを正しく守り、タイプミスもなく、やり直しにも寛容ではありません。引数が1つでも不正だと、素っ気ないエラーが返ってきて最初からやり直しです。「ボットを追加したばかり」の状態から「レポートが正常に動いている」状態まで、ガイドされた道筋は存在しませんでした。

解決策:単一のエントリーポイントで、すべてを発見可能に#

私たちはコマンド群を単一の/setupコマンドに集約し、インラインキーボード(Telegramがネイティブでサポートしているタップ可能なボタンメニュー)を開くようにしました。50個のコマンド名を暗記する代わりに、8つのラベル付きセクションが表示され、必要なものをタップするだけです。

• 🎯 フィルター — アカウント、cashtag、キーワード、メンション、除外、無視リスト、名前付きフィルター
• ⏰ スケジュール — 毎日のプリセット、カスタム時刻、特定の曜日、または完全なcron式
• 📊 レポート — オンデマンドでレポートを実行、レポート履歴の確認
• 🎨 カスタマイズ — プロジェクト名、説明、ロゴ、URL、リーダーボードのタイトルと色、重み付け、上位N件の件数
• 👥 管理者 — ボットを設定できる他のユーザー
• 💳 クレジット購入 — ETHクレジットパックまたはPROサブスクリプション
• 📡 X投稿の自動転送 — 選択したアカウントの投稿をほぼリアルタイムでチャットに転送
• ❓ ヘルプ&サポート — チケットを作成し、Telegram DMで返信を受け取る

すべてのボタンは、覚えておくべき構文ではなく、次のメニューへとつながります。以前はcashtagを設定するのに/set_x_filteringを覚え、引数の順序を正しく指定する必要がありました。今では/setup → 🎯 フィルター → 💵 Cashtags → ➕ 追加、とたどるだけで、ボットが次に必要な情報を尋ねてくれます。

最も大きく変わったのは初回利用時の体験です。新規チャットには4ステップのクイックスタートウィザードが用意されており、プロジェクト名→フィルター→スケジュール→確認画面の順に進み、コマンド構文を間違える心配なく1分足らずで完了します。

実際に何が変わったか:アクティベーション率#

私たちは、ボット追加から24時間以内に最初のレポートを実行した新規チャットの割合を追跡しました。これは「実際にセットアップを完了できたのか、それとも離脱してしまったのか」を示す最も明確な指標です。メニューを再設計する前は、新規インストールのかなりの割合が設定を完了しないままでした。管理者はいくつかのスラッシュコマンドを試し、不正な引数でエラーが出ると、そのまま音沙汰がなくなっていました。再設計後は、クイックスタートウィザードを開始した新規チャットのほとんどがそれを完了し、同日中にレポートのスケジュールを設定できるようになりました。ウィザードの最大の効果は、新機能を教えることではなく、何かを間違って入力する余地をなくしたことでした。

メニューをリリースしてからは、「Xの設定方法は?」といったサポートチケットも大幅に減り、代わりに「このボタンはどこにあるの?」ではなく、チューニングに関するより具体的な質問(例えばベストツイート選定の仕組みなど)が増えました。

ダイレクトコマンドとして残したもの#

すべてを削除したわけではありません。使用頻度が高い、あるいは近道として便利ないくつかのコマンドは、メニューの外に残しました。

• /setup — メニューを開く(エントリーポイントそのもの)
• /report — メニュー操作なしで即座にレポートを実行
• /buy — クレジット購入に直接ジャンプ
• /subscription — PROサブスクリプションの確認・管理
• /add_admin — 👥 管理者メニューを掘り下げずにボット管理者を追加
• /set_topic — フォーラムモードのグループで対象トピックを設定
• /status — クイックヘルスチェック(有効なフィルター、スケジュール、プラン)
• /get_chatid — サポートチケットやAPIデバッグの際に時々必要

これらはパワーユーザーが体で覚えて入力するコマンドであり、スクリプトや自動化ツールが直接呼び出す可能性が高いコマンドでもあります。これらを残すことで、既存のワークフローを壊すことなく、他のすべてのユーザーに対する発見しやすさも改善できました。それ以外の40以上のレガシーコマンドは後方互換性のために技術的には今も動作しますが、どこにもドキュメント化されておらず、案内もされていません。今ではメニューが公式にサポートされた方法です。

移行コストに見合う価値はあったか?#

答えはイエスですが、タダではありませんでした。すべてのメニュー画面で、ユーザーがボタンをタップした後にTelegramを閉じ、3日後に同じ状態を期待して戻ってくるケースに対応する必要がありました。インラインキーボードは会話コンテキストを無期限に保持しないため、線形的なフローを前提とするのではなく、各ステップを再入力可能にする必要があったのです。権限についてもより慎重に考える必要がありました。メニューは、調べて入力する必要があったコマンドよりも多くのクリックを誘発するため、同時に👥 管理者とロールチェックも厳格化しました。

設定項目がいくつもあるTelegramボットを作っているなら、私たちの考えはこうです。50個のコマンドになるまでこの判断を待つべきではありません。コマンドリストが使い物にならなくなる閾値は、機能を1つずつ追加している当事者が感じるよりもずっと低いところにあります。スケジュール構文、フィルターの組み合わせ、名前付きフィルターなど、ユーザーが日常的には行わない設定であれば、ガイド付きメニューは暗記したコマンドに常に勝ります。逆に1日に何十回も実行するようなコマンドであれば、素早く直接使えるコマンドのままにしておくべきです。

/setupのフィルター機能が実際にどう動作するかをより詳しく知りたい方は、トークンローンチ向けのX活動トラッキングと暗号資産プロジェクト向けのcashtagトラッキングをご覧ください。どちらも現在の🎯 フィルターメニューをステップごとに解説しています。メニュー全体のリファレンスについては、セットアップメニューのドキュメントですべての画面を網羅しており、ボット自体が初めての方にはx-bot-overviewが最適な出発点です。

Xでコミュニティをトラッキングする準備はできましたか? @BWS_X_BotをTelegramグループに追加し、/setupを実行すれば、設定したスケジュールで最初のレポートが届きます。FREEプランは月100投稿までカバーし、カード登録は不要です。

この記事について:本記事はX Botのコンテンツワークフローを使用してAIの支援を受けて作成され、公開前にBlockchain Web Services(BWS)の創業者兼プリンシパルであるNacho Collがレビューしています。製品に関する主張はすべて実際のボットで確認済みです。コンテンツにおけるAIの活用方法をご覧ください。誤りを見つけた場合は、/setup → ❓ ヘルプ&サポートからご連絡ください。

「これは私たちが取り上げる数多くのプロダクトアップデートの1つです。リリースノート、ケーススタディ、詳細な解説についてはX Botブログをご覧ください。」