TG分流リンクの生成方法：TG-StaffコンソールでBotに紐付けるステップバイステップチュートリアル

Telegram Botが毎日数十から数百ものユーザーメッセージを受信するようになると、現実的な問題が浮上します：これらのユーザーはどこから来たのか？ Google Adsの広告経由なのか、Twitterのソーシャルメディア投稿からの流入なのか？さらに厄介なのは、問い合わせがピーク時に殺到しても、オペレーターがどれを優先すべきか判断できないことです。

TG分流リンク（Diversion Link）は、まさにこれらのシナリオのために設計されたツールです。これは本質的にTG-Staff公式ドメインの短縮リンク（例：https://app.tg-staff.com/{code}）であり、ユーザーがクリックするとまず訪問者情報（IP、ブラウザ、URLパラメータ）を「キャプチャ」し、その後自動的にあなたのBotにリダイレクトされ、最終的に有人オペレーターが対応します。これにより、広告のアトリビューション（帰属分析）と、問い合わせピーク時の自動振り分けの両方が実現できます。

本記事では、TG-Staffコンソールで分流リンクを作成し、Botにバインドし、セッション振り分けルールを設定する方法を、実行可能な検証チェックリストとともに詳しく解説します。

---

TG分流リンクとは？なぜあなたのBotに必要なのか

まず典型的なシナリオを見てみましょう：

あなたはクロスボーダーカスタマーサポートBotを運営しており、Google Adsに広告を出稿し、Twitterでも投稿で誘導しています。ユーザーが広告をクリックしてBotに入り、製品価格について問い合わせます。しかし、オペレーターはそのユーザーが広告から来たのかソーシャルメディアから来たのか判断できず、どのチャネルのコンバージョン率が高いかもわかりません。さらに悪いことに、同時に5人のユーザーから問い合わせがあった場合、オペレーターは順番にしか対応できず、効率が悪いです。

分流リンクの解決方法は次の通りです：

1. 各チャネルごとに独立した分流リンクを作成します（例：app.tg-staff.com/ad-google と app.tg-staff.com/twitter-post）。
2. ユーザーがリンクをクリック → TG-StaffがIP、User-Agent、URLパラメータをキャプチャ → ユーザーがBotにリダイレクト → 自動的にウェルカムメッセージがトリガー → 有人オペレーターが対応。
3. コンソールのユーザープロファイルで、各ユーザーの流入チャネル、ブラウザ情報、さらにはカスタムパラメータ（例：utm_source）を確認できます。

これにより、「ユーザーの出所不明」と「問い合わせピーク時の対応不能」という2つの痛点を同時に解決できます。

---

準備：分流リンクを作成する前に確認すべき3つのこと

操作を開始する前に、以下の3点が満たされていることを確認してください。

プラン権限の確認

分流リンクはTG-Staffのスタンダードプラン以上の機能です。無料トライアル期間（3日間）でも体験できますが、トライアル終了後はスタンダードプラン（約8.99ドル/月）またはプロフェッショナルプラン（約16.99ドル/月）に加入しないと継続利用できません。具体的な価格は公式サイトのプランページをご確認ください。

BotがTG-Staffに接続されていることを確認

コンソールの「プロジェクト設定」ページで、Bot Tokenが正しく設定され、ステータスが接続済みと表示されていることを確認してください。まだ接続していない場合は、TG-Staffドキュメントを参照してWebhook設定を完了してください。

エージェントアカウントの作成確認

振分リンクは最終的にユーザーをエージェントに割り当てます。まだエージェントアカウントがない場合は、まず「エージェント管理」で少なくとも1つのエージェントを追加してください（無料版では3エージェントまで利用可能）。そうしないと、ユーザーが遷移した後、有人対応ができない可能性があります。

---

ステップバイステップチュートリアル：TG-Staffコンソールで振分リンクを生成する

以下が完全な操作手順です。コンソールを開いて一緒に進めることをお勧めします。

振分リンク管理ページにアクセス

1. TG-Staff コンソールにログインします。
2. 左側のプロジェクトリストから、設定したいBotプロジェクトを選択します。
3. 左側のメニューバーで 「振分リンク」 を見つけ、クリックして管理ページに移動します。
4. ページ右上の 「振分リンクを作成」 ボタンをクリックします。

リンク情報を入力して生成

作成ポップアップで、以下の情報を入力する必要があります：

フィールド	必須/任意	説明
リンク名	必須	内部識別用。あなたとエージェントのみに表示され、遷移動作に影響しません。チャネル名で命名することを推奨（例：「Google Ads-2025Q1」）
備考	任意	広告キャンペーンID、配信期間、予算などの追加情報を記録できます（例：「Campaign ID: 123456、予算 $500」）

入力が完了したら、「生成」 をクリックします。システムはすぐに https://app.tg-staff.com/abc123 のような形式の短いリンクを返します。コピー ボタンをクリックして保存します。

---

振分リンクをBotにバインドする方法

ここでよくある誤解を解消しておきます：振分リンクはBot内部で「バインド」する必要はありません。

BotFatherで設定を行う必要も、Botのフロー編集を変更する必要もありません。振分リンクは 外部からの集客入口 であり、生成後はそのまま広告、ソーシャルメディア、メールなどのチャネルで使用できます。ユーザーがリンクをクリックすると、自動的にあなたのBotに遷移し、有人エージェント対応が開始されます。

例えば、Google Adsの広告文に直接振り分けリンクを設置し、ユーザーがクリックしたらまず情報を取得してからBotにリダイレクトできます。または、Twitterの投稿に振り分けリンクを挿入し、フォロワーがクリックすると自動でカスタマーサービスセッションに入ります。

---

セッション振り分けルールを設定し、リンクを本当に「振り分け」られるようにする

振り分けリンクは単なる「踏み台」であり、実際にどのエージェントにユーザーを割り当てるかを決めるのはセッション振り分けルールです。ルールが適切に設定されていないと、ユーザーがリダイレクトされた後もずっと待機状態になったり、適切でないエージェントに割り当てられたりする可能性があります。

コントロールパネルの「プロジェクト設定」→「セッション振り分け」ページで、以下の2つのコアオプションを設定できます。

振り分けモードの設定：ラウンドロビン vs オンライン優先

モード	動作原理	適用シーン
ラウンドロビン（デフォルト）	権限のあるエージェントを順番にポーリングし、各エージェントが順に新規ユーザーを受け取ります。例：エージェントA、B、Cの場合、ユーザー1→A、ユーザー2→B、ユーザー3→C、ユーザー4→A…	負荷分散に適し、エージェントの作業強度が均一なチームに最適
オンライン優先	現在オンライン状態のエージェントに優先的に割り当てます。全エージェントがオフラインの場合、ラウンドロビンにフォールバックします。	即時応答が必要なシーンに最適。例えば、ユーザーが問い合わせた後にすぐに誰かが返信することを期待する場合、オフラインのエージェントがオンラインになるのを待つ必要はありません

どのモードを選ぶかは、チームのシフト次第です。エージェントが交代制で勤務する場合は「ラウンドロビン」、エージェントが常時オンラインだが人数が不定の場合は「オンライン優先」を推奨します。

対応可能なカスタマーサービスの範囲を指定

デフォルトでは、プロジェクト内の全エージェントが振り分けリンクから来たユーザーを対応できます。しかし、特定の高価値チャネル（例：VIP顧客専用広告）をベテランエージェントのみに担当させたい場合、ここで設定できます：

• 全カスタマーサービス：全エージェントが対応可能。
• 指定カスタマーサービス：特定のエージェントグループまたは個別のエージェントのみを選択して対応させます。

アドバイス：初期は「全カスタマーサービス」を使用し、チーム規模が拡大したら、チャネルの価値に応じて細分化してください。

---

検証とチェックリスト：振り分けリンクが正常に動作することを確認する

設定が完了したら、すぐに公開しないでください。まず以下のチェックリストに従って完全な検証を行ってください。

1. シークレットブラウザでリンクをクリックしてリダイレクトをテスト：シークレットウィンドウを開き（キャッシュの干渉を避けるため）、振り分けリンクをクリックします。ページが正常にBotにリダイレクトされることを確認します。
2. コントロールパネルにセッションが表示されることを確認：リダイレクト後、コントロールパネルの「オンラインセッション」リストに新しいセッションが表示され、ユーザー名が先ほどテストしたTelegramアカウントであることを確認します。
3. ユーザープロファイルに情報が取得されているか確認：そのセッションのユーザープロファイルに入り、IPアドレス、User-Agent、URLパラメータ（存在する場合）が記録されていることを確認します。
4. 振り分けルールが有効か確認：「オンライン優先」を設定した場合、オンラインのエージェントがすぐにセッションを受け取ることを確認します。「指定カスタマーサービス」を設定した場合、指定されたエージェントのみがそのセッションを表示できることを確認します。
5. 複数のエージェントが同時にオンラインの場合の割り当てが正常かテスト：2人のエージェントを同時にログインさせ、複数のTelegramアカウントで振り分けリンクをクリックします。各セッションがルールに従って異なるエージェント（ラウンドロビン）またはオンラインエージェント（オンライン優先）に割り当てられることを確認します。

---

よくある質問

Q：振り分けリンクで追跡できるユーザー情報は？

A：振り分けリンクは、ユーザーがBotにリダイレクトされる前に、自動で訪問者のIPアドレス、ブラウザタイプ（User-Agent）、およびURLに含まれるカスタムパラメータ（utm_source、utm_campaignなど）を取得します。これらの情報はユーザープロファイルに記録され、広告のアトリビューション分析に役立ちます。

Q：1つのBotで複数の振り分けリンクを作成できますか？

A：はい。TG-Staffでは、同じBotプロジェクトに対して複数の振り分けリンクを作成でき、各リンクに独立した名前と備考を設定できるため、異なるチャネル（Google Ads、Twitter、メールキャンペーンなど）を区別するのに便利です。

Q：振り分けリンクに有効期限はありますか？切れることはありますか？

A：TG-Staffが生成する振り分けリンクは永久有効です。ただし、ユーザーがコントロールパネルで手動削除した場合、またはBotプロジェクトが削除されたり、サブスクリプションが期限切れで更新されなかった場合は無効になります。

Q：無料トライアル期間中に振り分けリンクを使用できますか？

A：はい。登録後3日間の無料トライアル期間中は、すべてのスタンダード版機能（振り分けリンクを含む）が正常に使用できます。トライアル終了後は、スタンダード版以上のプランにサブスクライブする必要があります。

Q：振り分けリンクはWeChatやウェブページから直接開けますか？

A：振り分けリンクはTG-Staff公式ドメインの短縮リンク（https://app.tg-staff.com/{code}など）であり、Telegramクライアント内でのみ開いて対象Botにリダイレクトできます。ブラウザでクリックした場合は、Telegramで開くように促されます。Telegramエコシステム内のトラフィック誘導シーンでのみ使用することを推奨します。

---

これで、TG振り分けリンクの生成方法と、それを実際に機能させるための設定方法がわかりました。まだTG-Staffを使い始めていない場合は、3日間の無料トライアルに登録して、Botプロジェクトを追加し、このチュートリアルに従って最初の振り分けリンクを作成してください。問題が発生した場合は、いつでもカスタマーサービスBot @tgstaff_robotまたは公式ドキュメントを参照してください。