TG 分流リンク（マジックリンク）完全ガイド：生成、リダイレクトBotと広告帰属

Telegram Botをカスタマーサポートや営業に活用しているなら、ソーシャルメディアや広告、公式サイトにBotのt.me/your_bot?start=xxxリンクをそのまま貼っているかもしれません。しかし、考えたことはありますか？これらのリンクをクリックしたユーザーは、一体どのチャネルから来たのか？IPアドレスやブラウザ情報は？ユーザーがBotにリダイレクトされる前に、これらのデータを取得して広告帰属やセッション振り分けに活用できないか？

これこそがTG分流リンク（マジックリンク / Diversion Link） が解決する核心的な課題です。本記事では、TG-Staffプラットフォームを例に、原理から実践まで、分流リンクの生成、パラメータ取得、セッション割り当て、マルチチャネルトラッキングを詳しく解説し、Telegram Botのカスタマーサポート効率向上を支援します。

TG分流リンク（マジックリンク）とは？

TG分流リンクは、マジックリンクとも呼ばれ、特別な短縮リンク（例：https://app.tg-staff.com/{code}）です。通常のBotリンクが直接Telegram Botにリダイレクトするのとは異なり、分流リンクはまずTG-Staffのサーバーを経由し、リダイレクト前に訪問者のIPアドレス、ブラウザ情報、URLパラメータを取得してから、ユーザーをTelegram Botに誘導します。

簡単に言うと、これはスマートな踏み台です：ユーザークリック → データ記録 → Botリダイレクト → 自動応答 → 有人オペレーター対応。

通常のBotリンクとの核心的な違い：

特性	通常のBotリンク（t.me/...）	分流リンク（app.tg-staff.com/...）
データ取得	なし。Telegramは発信元情報を提供しない	IP、ブラウザUA、URLトラッキングパラメータを取得
広告帰属	チャネルを区別不可	utm_source、campaignなどを区別可能
セッション振り分け	Bot内のロジックに依存	TG-Staffのプロジェクトレベルの振り分けルールをサポート
リダイレクト体験	直接Botにリダイレクト	記録後にリダイレクト、遅延はほぼ感知不可

クロスボーダー、海外展開、Web3チームにとって、分流リンクは広告配信 → Botコンバージョン → 有人サポートを結ぶ重要なツールです。

分流リンクの仕組み：クリックからセッションまでの完全な流れ

ユーザーが分流リンクをクリックすると、以下のイベントシーケンスが発生します：

1. ユーザーが分流リンクをクリック（例：広告内のhttps://app.tg-staff.com/XyZ123）
2. TG-Staffサーバーがリクエストを受信し、以下のデータを記録：
   • ユーザーのIPアドレス
   • ブラウザのUser-Agent（デバイス、OS、ブラウザタイプ）
   • URLに含まれるすべてのクエリパラメータ（例：?utm_source=google&utm_campaign=spring_sale）
3. サーバーが302リダイレクトでBotのt.me/...リンクまたはBot内の指定ディープリンクへ
4. ユーザーがBotにアクセスし、ウェルカムメッセージや自動応答フロー（メニュー、フォームなど）をトリガー
5. セッション振り分けシステムがプロジェクト設定の振り分けルールに基づき、ユーザーをオンラインオペレーターに割り当て（または待機キューへ）
6. オペレーターがTG-Staff Webコンソールでユーザー情報を確認。上記で取得した発信元データを含み、対応を開始

どのパラメータを取得するか？

TG-Staff分流リンクが取得する主なフィールド：

• IPアドレス：おおよその地理的位置の判断用（正確ではない、帰属参考のみ）
• User-Agent：ブラウザ、OS、デバイスタイプ
• URLトラッキングパラメータ：すべての標準UTMパラメータ（utm_source、utm_medium、utm_campaign、utm_term、utm_content）およびカスタムパラメータ（例：campaign_id、channel、ref）をサポート

これらのデータはTG-Staff管理画面のセッション詳細ページやユーザープロファイルに表示され、パラメータ次元でフィルタリングやエクスポートが可能です。

分流リンクと通常のBotリンクの違い

上記の表に加えて、特に強調すべき2点：

• 通常リンクは帰属不可：Telegram自体は「ユーザーがどのリンクから来たか」のデータを提供しません。どの広告がBotセッションをもたらしたか分かりません。
• 分流リンクは「事前振り分け」をサポート：ユーザーがBotにアクセスする前に、システムがルール（例：全オペレーター/特定オペレーター）に基づいて以降の割り当てロジックを決定するため、純粋なBot内コードより柔軟です。

分流リンクの生成と設定方法（TG-Staff実践）

以下の操作は、TG-StaffコンソールでBotプロジェクトを追加し、オンライン状態であることを前提とします。

ステップ1：プロジェクト設定にアクセス

TG-Staffコンソールにログインし、対象のBotプロジェクトを選択、左メニューの「分流リンク」をクリック。

ステップ2：新しいリンクを生成

「リンク生成」ボタンをクリックすると、システムが自動的にユニークな短縮リンク（例：https://app.tg-staff.com/aBcDeF）を生成します。以下の操作が可能です：

• リンクをそのままコピーして使用
• リンクの末尾にトラッキングパラメータを追加（例：?utm_source=twitter&utm_campaign=post1）
• リンクの有効期限を設定（オプション、期間限定キャンペーンに便利）

ステップ3：コピーしてチャネルに埋め込む

生成されたリンクを広告システム、ソーシャルメディアの投稿、メール署名、または公式サイトのボタンに貼り付けます。後でアトリビューションできるよう、各リンクにUTMパラメータを追加することをお勧めします。

ステップ4：検証

自分でリンクをクリックし、正常にBotにリダイレクトされること、TG-Staff管理画面のセッション詳細にIP、UA、パラメータデータが表示されることを確認します。

セッション振分ルール：問い合わせを正しく割り当てるには？

振分リンクがトリガーされると、ユーザーはBotに入りますが、誰が対応するかはTG-Staffのプロジェクトレベルの振分ルールに依存します。

ラウンドロビン vs オンライン優先：シナリオ別の選択

TG-Staffは2つの主要な振分モードを提供します：

• ラウンドロビン（デフォルト）：権限を持つエージェントを順番に割り当て、1人1件ずつ対応。負荷分散に適しています（例：カスタマーサポートチームが固定席で人数が安定している場合）。
• オンライン優先：現在オンラインのエージェントを優先し、全員オフラインの場合はラウンドロビンにフォールバック。迅速な応答が必要なシナリオに適しています（例：カスタマーサポートチームが固定されておらず、オンラインの人が先に対応してほしい場合）。

選択のアドバイス：

• チームのエージェント数が固定でシフトが明確 → ラウンドロビン
• チームのエージェントが柔軟、リモートワーク、忙しさにばらつきがある → オンライン優先

プロジェクトのカスタマーサポート範囲を設定

プロジェクト設定で、振分リンクのカスタマーサポート範囲を指定できます：

• 全カスタマーサポート：プロジェクト権限を持つすべてのエージェントがセッションを受け取る可能性あり
• 指定カスタマーサポート：特定のエージェントグループ（例：「プリセールスチーム」や「日本語サポートチーム」）のみがそのリンクからのセッションを受け取る

これは複数チームや複数プロジェクトのシナリオで非常に便利です。例えば、1つのBotがプリセールスとアフターサービスの両方を担当する場合、2つの振分リンクを生成し、それぞれ異なるカスタマーサポートグループにバインドすることで、自動振分が可能です。

広告アトリビューション実践：振分リンクで各リードのソースを追跡

例えば、Google Ads、Facebook広告、Twitter投稿を同時に運用しており、各チャネルがどれだけのBotセッションとコンバージョンをもたらしたかを知りたい場合。

操作手順：

1. チャネルごとに独立した振分リンクを生成（または同一リンク＋異なるUTMパラメータを使用）

   • Google Ads: https://app.tg-staff.com/code?utm_source=google&utm_campaign=product_launch
   • Facebook: https://app.tg-staff.com/code?utm_source=facebook&utm_campaign=product_launch
   • Twitter: https://app.tg-staff.com/code?utm_source=twitter&utm_campaign=post1

2. 各チャネルの広告や投稿にリンクを配置

3. TG-Staff管理画面でアトリビューションデータを確認

   • 「セッション」または「ユーザープロファイル」モジュールにアクセス
   • UTMパラメータでフィルタリング、並べ替え可能
   • 各ソースのセッション数、ユーザーIP分布、コンバージョン状況を確認（Bot内の行動と連携）

高度な使い方：

• 流入振り分け機能と組み合わせる：特定のチャネルのトラフィックが急増した場合、一部のユーザーを自動的に指定されたエージェントグループに誘導し、単一エージェントの過負荷を防ぎます。
• ユーザープロファイルを活用する：キャプチャしたIPやパラメータをユーザータグに書き込み、後でソースに基づいて差別化された運用を行います（例：Googleからのユーザーに割引コードをプッシュ）。

振り分けリンクの制限、よくある問題とトラブルシューティング

振り分けリンクは強力ですが、万能ではありません。以下はよくある問題とその解決方法です：

問題	考えられる原因	解決方法
リンクがジャンプしない	Botプロジェクトが削除またはオフライン	Botのオンライン状態を確認し、リンクを再生成
パラメータがキャプチャされない	パラメータ形式が間違っている（例：?がない）、または特殊文字を使用	パラメータ形式が?key=value&key2=value2であることを確認
セッションがエージェントに割り当てられない	すべてのエージェントがオフラインで、振り分けルールが「オンライン優先」	オフライン時のフォールバックを「ローテーション割り当て」に設定するか、少なくとも1人のエージェントをオンラインにする
ユーザーがジャンプ後に空白ページに移動する	リンクがサードパーティプラットフォーム（例：WeChat内蔵ブラウザ）にブロックされる	短縮URLサービスを使用してから埋め込むか、ユーザーにリンクを手動でコピーしてブラウザで開くよう促す
アトリビューションデータが不正確	ユーザーがVPNまたはプライベートモードを使用	IPデータは参考値としてのみ使用し、UTMパラメータを主なアトリビューションに使用することを推奨

一般的なトラブルシューティング手順：

1. シークレットブラウザでリンクをクリックし、正常にジャンプすることを確認
2. TG-Staff管理画面で該当セッションの「詳細」を確認し、IPとUAの記録があるか確認
3. 振り分けルールの設定を確認し、エージェントがオンラインで権限があることを確認
4. TG-Staff カスタマーサポートBotに連絡してテクニカルサポートを受ける

よくある質問

Q：振り分けリンクで生成された短縮URLに有効期限はありますか？

A：TG-Staffで生成された振り分けリンクに固定の有効期限はなく、対応するBotプロジェクトが削除されていない限り継続して使用できます。特にプラン変更やBot設定変更後は、定期的にリンクの有効性を確認することをお勧めします。

Q：振り分けリンクを複数の異なるチャネルで使用できますか？

A：はい。同じ振り分けリンクを広告、ソーシャルメディア、メールなどのチャネルで同時に使用し、URLパラメータ（utm_sourceなど）でソースを区別できます。TG-Staff管理画面ではパラメータごとにアトリビューションデータが表示され、各チャネルの効果を比較できます。

Q：ユーザーが振り分けリンクをクリックした後、セッションは必ずエージェントに割り当てられますか？

A：必ずしもそうではありません。すべてのエージェントがオフラインで振り分けルールが「オンライン優先」の場合、ユーザーはまずBotの自動応答を受け取ります。エージェントがオンラインになると、セッションは自動的に割り当てられます。オフライン時のフォールバック戦略として「ローテーション割り当て」を設定し、ユーザーが忘れられないようにすることをお勧めします。

Q：振り分けリンクでキャプチャされたIPデータはコンプライアンスに準拠していますか？

A：TG-Staffはアトリビューション統計のためにユーザーのIPのみをキャプチャし、長期記録は保存しません。運営者は地域のプライバシー規制（GDPRなど）に従い、プライバシーポリシーでデータの使用目的を説明することをお勧めします。金融や医療などのセンシティブな業界では、IPキャプチャを無効にするか、匿名化データのみをキャプチャすることを検討してください。

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

A：振り分けリンクはスタンダードプラン以上の機能です。無料トライアル期間（3日間）では全機能をお試しいただけます。トライアル終了後も使用するには、スタンダードプランまたはプロフェッショナルプランにご加入ください。プランの詳細はTG-Staff公式サイトのプランページをご参照ください。

---

今すぐTG振り分けリンクを体験してみませんか？ TG-Staff無料トライアルに登録すると、3日間全機能（振り分けリンク生成、セッション振り分け、アトリビューションデータ表示を含む）をお試しいただけます。詳細な設定方法は公式ドキュメントをご覧ください。ご質問があれば、@tgstaff_robotまでお気軽にお問い合わせください。