TG-Staff ビジュアルコマンドフローの例：挨拶から有人対応への完全構築ガイド

Telegram Bot をカスタマーサポートやコミュニティ運営に使う際、最も基本的でありながら頭を悩ませる問題は、「ユーザーがメッセージを送ってきたとき、Bot はどう返信すべきか」です。すべてを手動で返信すると効率が悪くコストがかかり、Bot をコードで構築すると開発リソースと何度もデバッグが必要になります。

TG-Staff のビジュアルコマンドフローディターは、まさにこのジレンマを解決するために生まれました。ブロックを組み立てるように、コード不要のドラッグ＆ドロップで、「ユーザーの初回接触」から「有人オペレーターへの引き継ぎ」までの完全なインタラクションフローを構築できます。この記事では、挨拶、メニュー、予約、有人対応という4つの代表的なノードを通じて、実運用可能な Bot コマンドフローを段階的に構築し、tgstaff コマンドフロー の中核操作を素早く習得できるようにします。

なぜビジュアルコマンドフローが必要か——挨拶から有人対応までの完全な流れ

適切に設計されたコマンドフローは、チームに以下の3つのメリットをもたらします：

自動振り分け：ユーザーは待つことなく、Bot が先に一般的な質問（サービス紹介、価格照会など）に対応し、有人オペレーターの負担を軽減します。
事前情報収集：フォームノードを通じてユーザーの名前、要件、連絡先を収集し、オペレーターが引き継ぐ際には完全なコンテキストが用意されています。
スムーズな有人対応切り替え：ユーザーが実際の人間のサポートを必要とする場合、ワンクリックでカスタマーサービスセッションに切り替え、割り当てルール（順番/オンライン優先）がシステムによって自動実行されます。

TG-Staff のビジュアルエディターは、これらすべてのロジックをノードカードとしてカプセル化しており、ドラッグ、接続、テキスト入力だけで、Telegram Bot の自動応答システムを素早く構築できます。以下では、4つの代表的なシナリオを例に、ゼロから構築していきます。

ノード1：挨拶ノードの構築——ユーザー初回接触の第一印象

ユーザーが初めて /start や任意のメッセージを Bot に送信したとき、挨拶ノードが最初の接点となります。親しみやすい挨拶文は、ユーザーの離脱率を下げ、後続のフローへ導きます。

挨拶文テキストと変数の設定

TG-Staff コンソールの「コマンドフロー」ページで、「ノードを追加」→「挨拶ノード」を選択します。右側の編集パネルで挨拶文を入力し、動的プレースホルダーを挿入して返信をパーソナライズできます。

設定例：

你好 {username}！👋 欢迎来到 [你的品牌名] 的官方客服 Bot。

我是你的智能助手，可以帮你：
- 查看服务与报价
- 预约产品演示
- 联系真人客服

请选择下方菜单开始吧。

ここで {username} は TG-Staff の組み込み変数で、送信時に自動的にユーザーの Telegram 表示名に置き換えられます。{first_name}、{user_id} などの変数も使用できます。詳細はドキュメントを参照してください。

挨拶ノードをメニューノードに接続

挨拶文を編集したら、ノード下部の「次へ」接続ポイントから線をドラッグして、これから作成する「メニューノード」に接続します。これにより、ユーザーが挨拶文を受け取った後、Bot が自動的にメニューオプションを送信します。

ノード2：メニューノードの設計——ユーザー自己照会の入り口

メニューノードを使用すると、ユーザーはボタン選択で素早く必要な情報を見つけられ、複雑なテキスト入力が不要になります。

ボタンオプションとジャンプ先の追加

エディターで「メニューノード」を追加し、「ボタンを追加」をクリックします。あなたのビジネスが B2B SaaS カスタマーサポートの場合、以下のボタンを設定できます：

ボタンテキスト	ジャンプ先ノード	説明
📋 サービスを見る	テキスト返信ノード（サービス一覧表示）	ユーザー自己参照
📅 デモ予約	予約ノード	フォーム収集へジャンプ
💬 カスタマーサービスに連絡	有人対応ノード	直接有人オペレーターへ

各ボタンは「ジャンプ先」に対応しており、事前に対応するノード（予約ノード、有人対応ノードなど）を作成し、ボタン設定で選択する必要があります。

メニューのフォールバックとタイムアウト処理の設定

ユーザーが無関係なメッセージを送信したり、選択を行わない可能性があります。メニューノードの「詳細設定」で、以下を構成できます：

デフォルト返信：ユーザーがボタンオプションにない内容を入力した場合、Bot は「下のボタンをクリックしてサービスを選択するか、「人工」と入力してカスタマーサービスに連絡してください。」と返信します。
タイムアウトプロンプト：60秒間操作がない場合、Bot が自動的に「まだいらっしゃいますか？ご用の際はいつでもお声がけください。」と送信します。

これにより、フローが停滞してユーザーが離脱するのを防げます。

ノード3：予約ノードの作成——ユーザー情報を収集する自動フォーム

予約ノードは基本的に「フォームコレクター」であり、ユーザーに名前、電話番号、メールアドレス、備考などの入力を求めるシナリオに適しています。

エディターで「テキスト返信ノード」（または「フォームノード」、エディターの実際の名称に応じて）を追加し、複数の入力フィールドを設定します。例：

フィールド1：名前（必須、テキスト入力）
フィールド2：連絡先メールアドレス（必須、テキスト入力、形式検証のヒントを追加可能）
フィールド3：要件の説明（任意、複数行テキスト）

重要な設定：ノード設定で「送信データをユーザープロファイルに書き込む」にチェックを入れると、オペレーターが引き継ぐ際にサイドバーでユーザーが入力したすべての情報を確認できます。また、「送信後にオペレーターに通知」を設定し、指定したオペレーターに内部通知メッセージを送ることもできます。

予約ノードが完了したら、「成功通知ノード」（「ご予約ありがとうございます。すぐにご連絡いたします。」など）に接続するか、「さらなる相談が必要な場合は、クリックして有人対応へ」ボタンを追加し、ユーザーがいつでも実際の人間のサポートを受けられるようにします。

ノード4：有人対応ノードの設定——Bot 自動応答からオペレーター引き継ぎへ

有人対応ノードはフローの「出口」であり、ユーザーが実際の人間のサービスを必要とする場合、自動的にカスタマーサービスセッションを作成し、オペレーターに割り当てます。

セッション割り当てルールの設定

「有人対応ノード」を追加したら、右側のパネルで設定します：

プロジェクトカスタマーサービス範囲：「すべてのオペレーター」または「特定のオペレーターグループ」を選択。
割り当てルール：「順番割り当て」（権限のあるオペレーターに順番に割り当て）または「オンライン優先」（現在オンラインのオペレーターに優先的に割り当て、全員オフラインの場合は順番割り当てにフォールバック）をサポート。

カスタマーサービスのピーク時には「オンライン優先」を使用し、ユーザーが最も早く実際の人間に接続できるようにすることをお勧めします。チームのオペレーター数が少ない場合（3〜5人など）、「順番割り当て」の方が公平です。

有人対応後のオペレーター体験

ユーザーが有人対応ノードをトリガーすると、オペレーターは TG-Staff Web コンソールの「リアルタイムセッション」リストに新しいセッションを確認できます。クリックして入室すると、セッションサイドバーにユーザーが以前に Bot フローで行った操作（どのメニューボタンをクリックしたか、どのフォームフィールドに入力したか）が自動的に表示されるため、オペレーターは再度質問する必要がなく、直接会話を引き継げます。

ヒント：有人対応に切り替わる一般的なトリガーシナリオ

メニューノードに「カスタマーサービスに連絡」ボタンを設定して有人対応をトリガーし、予約ノード完了後にも「さらに詳しい相談が必要な場合は有人対応へ」オプションを配置することをお勧めします。これにより、ユーザーはいつでも実際の担当者の支援を求められるようになります。

全フロー連携と公開——エディターからBotのリリースまで

4つのノードを作成したら、以下の順序で接続します：

欢迎节点 → 菜单节点 → (按钮分别跳转至) 预约节点 / 转人工节点 / 其他回复节点

接続が完了したら、エディター右上の「テストモード」ボタンをクリックして、ユーザー操作をシミュレーションします：

/start を送信 → ウェルカムメッセージが返信される → メニューが自動表示される
「デモ予約」をクリック → フォームに入力 → 確認メッセージを受け取る
「カスタマーサポートに連絡」をクリック → 自動的にセッションが作成される → オペレーター画面に新しいセッションが表示される

注意：公開前は必ずテストしてください

ビジュアルエディターで「テストモード」をクリックしてユーザー操作をシミュレートし、各ノードの応答が正確か、遷移が正常に行われるかを確認してください。直接公開後にユーザーがフローの中断に遭遇するのを防ぎます。

確認が完了したら、「保存して公開」をクリックします。公開後、Telegram Bot の自動応答は即座に更新され、Bot の再起動や Webhook の再設定は不要です。後で修正が必要な場合は、エディターでノード設定を調整し、再度保存して公開するだけで古いフローを上書きできます。

応用テクニック：分流リンクとユーザープロファイルを組み合わせてフローを最適化

TG-Staff の分流リンク（Diversion Link） を使用すると、Google 広告、Twitter の投稿、Telegram グループなど、異なるチャネル向けの専用短縮リンクを生成できます。ユーザーが分流リンク経由で Bot にアクセスすると、システムは流入元チャネル、IP、ブラウザなどの情報を取得し、ユーザープロファイルに書き込みます。

コマンドフローでは、これらのプロファイルデータを利用して条件分岐を行うことができます：

ユーザーが「広告_A」から来た場合、挨拶文に「A キャンペーン限定特典」を表示
ユーザーが「コミュニティ_B」から来た場合、メニューにコミュニティ専用サービスを優先表示

これには、ノード間に「条件分岐ノード」を追加し、ユーザープロファイルフィールド（例：source_channel）に基づいて遷移先を判断します。具体的な設定方法は TG-Staff ドキュメントをご参照ください。

よくある質問

Q：TG-Staff のビジュアルコマンドフローでは、何種類のノードタイプがサポートされていますか？
A：現在は、ウェルカムノード、メニューノード、テキスト返信ノード、有人転送ノード、条件分岐ノードなどをサポートしています。具体的なノードタイプは、エディター内の実際のリストをご確認ください。

Q：1つの Bot に対して複数のコマンドフローを作成できますか？
A：はい。TG-Staff ではプロジェクトごとに複数のフローを設定でき、異なるシナリオ（例：販売前問い合わせ、アフターサポート）に応じてそれぞれ設計し、切り替えて有効化できます。

Q：フローを公開した後、Bot の古い応答はすぐに上書きされますか？
A：はい。「保存して公開」を実行すると、Telegram Bot の自動応答は新しいフロー設定に即座に更新され、Bot の再起動や Webhook の再設定は不要です。

Q：有人転送ノードで、オペレーターはユーザーが以前にどのメニューオプションを選択したかをどのように把握しますか？
A：TG-Staff は、ユーザーが Bot フローで行った操作履歴（クリックしたメニューボタン、入力したフォームフィールドなど）を会話サイドバーのユーザープロファイルに同期するため、オペレーターが引き継いだ後、直接コンテキストを確認できます。

Q：無料トライアル期間中に、コマンドフローを完全にテストできますか？
A：はい。3日間の無料トライアル期間中は、標準版の全機能（ビジュアルコマンドフローエディターと有人転送ノードを含む）をご利用いただけます。トライアル期間内にフローの構築とテストを完了することをお勧めします。

次のステップ：初めての tgstaff コマンドフローを実際に構築してみましょう

まだ TG-Staff に登録されていない場合は、今すぐ始められます：https://app.tg-staff.com/ にアクセスして登録し、3日間無料でお試しください。コントロールパネルで新しいプロジェクトを作成し、この記事の4つのノード例に従って、ドラッグ＆ドロップで最初の Bot コマンドフローを構築しましょう。

問題が発生した場合は、公式ドキュメントを参照するか、カスタマーサポート Bot @tgstaff_robot に直接連絡してリアルタイムのヘルプを入手してください。構築が完了したら、フローのスクリーンショットを共有したり、サポートチームに最適化の提案を求めたりすることを歓迎します。

TG-Staff ビジュアルコマンドフロー例：ウェルカムメッセージから有人対応までの完全構築ガイド

关于作者