TG-Staff 分流リンク（マジックリンク）設定ガイド：作成、コピー、配信の完全ステップ

B2B SaaSカスタマーサポートのシナリオでは、Telegram Botはよくユーザーからの問い合わせ対応に使用されます。しかし、ユーザーがどのチャネルからBotに流入したかを追跡することは常に課題でした。Telegramネイティブでは流入元の attribution が提供されず、運用担当者は広告配信、ソーシャルメディアプロモーション、コミュニティ共有によるトラフィックを区別するのが困難です。TG-Staffの分流リンク（マジックリンク） は、まさにこの問題を解決するために生まれました。この記事では、定義、シナリオ、設定から配信まで、公式ドメインの短縮URL https://app.tg-staff.com/{code} を活用した精密な流入 attribution とカスタマーサポートセッションの分流方法を完全に解説します。

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

分流リンク（Diversion Link、マジックリンクとも呼ばれる）は、TG-Staffが提供する公式ドメインの短縮URLで、形式は https://app.tg-staff.com/{code} です。その中核的なワークフローは次の通りです：

1. ユーザーが短縮URLをクリック → 2. システムが訪問者のIPアドレス、ブラウザ情報（User-Agent）、およびURLに付加されたトラッキングパラメータをキャプチャ → 3. 指定されたTelegram Botに自動リダイレクトされ、ユーザーは直接会話を開始します。

通常のBotリンク（例：t.me/YourBot?start=xxx）とは異なり、分流リンクはリダイレクト前に訪問者の流入元情報をインターセプトして記録します。これらのデータはTG-Staffのユーザープロファイルに蓄積され、後続の分析に使用されます。この機能はスタンダードプラン以上でのみ利用可能です（無料トライアル期間中も体験できます）。

なぜ分流リンクが必要なのか？—— 適用シーンと中核的価値

分流リンクが解決する課題は具体的です：Telegram Bot 自体はユーザーがどのチャネルから来たのかを区別できません。Google Ads、Facebook 広告、KOL プロモーション、コミュニティ共有リンクを同時に運用していても、Bot に入ったユーザー全員に同じウェルカムメッセージが表示され、異なる流入元に応じた差別化運用ができません。以下に3つの典型的なシーンを紹介します。

シーン1：広告配信のアトリビューション

例えば、越境 SaaS 製品を運営し、Google Ads、Facebook Ads、Twitter で同時に広告を配信しているとします。分流リンクを使用すれば、チャネルごとに独立した短縮リンクを作成できます（https://app.tg-staff.com/abc は Google Ads、https://app.tg-staff.com/def は Facebook Ads に対応）。ユーザーが広告をクリックして Bot に遷移すると、TG-Staff はユーザープロファイルに流入元チャネルを記録します。これにより、各チャネルのコンバージョン効果を評価し、広告予算の配分を最適化できます。

シーン2：マルチチャネル運用のトラッキング

有料広告の他に、複数の Telegram コミュニティを運営したり、KOL にプロモーションを依頼したり、さまざまなソーシャルメディアに投稿したりする場合があります。分流リンクを使用すると、URL の末尾にカスタムパラメータを追加（?source=telegram-group-a、?source=kol-john など）して、異なるコミュニティからのユーザー流入元を区別できます。これらのパラメータはリクエストとともにキャプチャされ、ユーザープロファイルの「流入元」フィールドに表示されます。

シーン3：ピーク時のカスタマーサポート分流

TG-Staff のセッション分流ルール（ラウンドロビン/オンライン優先）と組み合わせることで、分流リンクは問い合わせピーク時の緩衝材としても機能します。例えば、広告文に分流リンクを埋め込み、大量のユーザーが同時に流入した場合、システムが自動的にルールに従ってオンラインのエージェントに割り振り、一人のエージェントに負荷が集中するのを防ぎます。同時に、流入元情報が記録されるため、エージェントはユーザーがどのキャンペーンから来たかを即座に把握し、より的確な対応が可能です。

前提条件：プラン確認と権限準備

設定を始める前に、以下の条件を満たしていることを確認してください：

• プラン要件：TG-Staff アカウントが Standard 版または Professional 版である必要があります（無料トライアル期間中でも分流リンクの作成・使用は可能です。トライアル終了後は利用を継続するために Standard 版（月額$8.99）へのアップグレードが必要です。年額プランの方がお得です。詳細は公式プランページをご覧ください）。
• Bot プロジェクトの接続：TG-Staff に接続済みの Telegram Bot プロジェクトが少なくとも1つあること（Bot Token のバインドが完了していること）。
• エージェント権限：分流リンクを設定するエージェントアカウントに「プロジェクト管理」または「分流リンク」の操作権限があること。不明な場合は、プロジェクト管理者に「エージェント管理」で権限を調整してもらってください。

ステップ詳細：分岐リンクの作成とコピー

以下は完全な設定フローです。順番に操作することをお勧めします。

ステップ1：分岐リンク管理ページにアクセス

TG-Staff アプリコンソールにログインし、左側のナビゲーションバーまたはプロジェクト設定で「分岐リンク」のエントリを見つけます。コンソールのレイアウトはバージョンによって多少異なる場合がありますが、通常は「プロジェクト設定」または「マーケティングツール」グループにあります。クリックして入ると、作成済みの分岐リンク一覧が表示されます（新規アカウントは空のリストです）。

ステップ2：新しい分岐リンクを作成

ページ右上の「リンクを作成」ボタンをクリックし、表示されるフォームに識別名を入力します。「2025年春のプロモーション」「Google Ads 配信」「KOL 張三プロモーション」など、意味のある名前を推奨します。これにより、その後の管理が容易になります。システムが自動的にユニークな code 文字列（例：abc123）を生成し、完全な短縮リンク https://app.tg-staff.com/abc123 に結合します。

• ヒント：名前は内部管理用のみで、外部には表示されません。code はリンクの一意識別子であり、作成後は変更できませんが、いつでも削除して再作成できます。
• オプション操作：一部のバージョンでは、リンクがジャンプする先の Bot プロジェクトを指定できます（アカウントに複数のプロジェクトがある場合）。正しいプロジェクトを選択して、正しくジャンプするようにしてください。

ステップ3：リンクのコピーとトラッキングパラメータの追加

作成が完了したら、リンク横の「コピー」ボタンをクリックして完全な短縮リンクを取得します。この時点で、末尾にカスタム URL パラメータを追加して、トラフィックソースをさらに区別できます。標準の UTM パラメータ形式を推奨します。例：

https://app.tg-staff.com/abc123?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale

または、よりシンプルなカスタムパラメータ：

https://app.tg-staff.com/abc123?source=google-ads&campaign=spring

パラメータ形式の要件：英数字、アンダースコア（_）、ハイフン（-）のみサポート。パラメータ値に日本語や特殊記号（スペース、&など）が含まれる場合は、事前に URL エンコード（encodeURIComponent）を行ってください。そうしないと、ジャンプ失敗やアトリビューションデータの損失が発生する可能性があります。

配信実践：分流リンクを広告・SNSで活用する方法

分流リンクを作成したら、次は配信です。以下はチャネル別のベストプラクティスです。

広告プラットフォームでの配信

• Google Ads：キャンペーンの「最終到達URL」に分流リンク（UTMパラメータを含む）を入力します。同時に「トラッキングテンプレート」を設定してClick IDなどの付加価値パラメータを渡すことを推奨しますが、最終URLがTG-Staffのショートリンクを指していることを確認してください。
• Meta Ads（Facebook/Instagram）：「ウェブサイトリンク」フィールドに分流リンクを入力します。Metaは自動的に fbclid パラメータを追加しますが、ソースを区別するために手動で utm_source=facebook を追加する必要があります。
• Twitter Ads / LinkedIn Ads：同様の操作で、広告のターゲットURLに分流リンクを入力します。

SNS・コミュニティでの配信

• Telegram グループ/チャンネル：分流リンクを直接送信します。Telegramはリンクプレビューを生成するため、説明文に「リンクをクリックしてカスタマーサポートと会話できます」と記載することを推奨します。
• Twitter / LinkedIn の投稿：投稿にショートリンクを埋め込むか、Bio Linkツール（Linktreeなど）を使用して分流リンクを遷移先の一つとして設定します。
• KOLプロモーション：KOLごとに個別の分流リンク（または異なるUTMパラメータ）を作成し、後日の精算と効果測定を容易にします。

データの確認

ユーザーが分流リンクからBotにアクセスすると、そのソース情報は自動的にTG-Staffのユーザープロファイルに記録されます。「ユーザー管理」で個々のユーザーのIPアドレス、ブラウザ情報、URLパラメータ（utm_source、source など）を確認できます。プロフェッショナル版では、より詳細なソース分析レポートも利用可能です。

よくある質問とトラブルシューティング

設定中に以下の問題が発生する可能性があります。対処方法を確認してください：

• リンクが遷移しない：Botがオンラインか確認してください（Bot Tokenが有効か、プロジェクトが停止されていないか）。分流リンク自体はBotのオンライン状態に依存しません（リダイレクトのみ行います）が、BotがBANされたりTokenが無効になったりすると、ユーザーがクリックしても会話を開始できません。
• パラメータが反映されない：パラメータの形式が正しいか（日本語、スペース、特殊記号がないか）確認し、適切にエンコードされているか確認してください。ブラウザで分流リンクを直接開き、アドレスバーに完全なパラメータが表示されるか確認します。表示されない場合、パラメータが正常に渡されていません。
• エージェントにセッションが届かない：セッション振り分けルールが正しく設定されているか確認してください。「オンライン優先」を使用していて全エージェントがオフラインの場合、システムは順番割り当てにフォールバックします。それでもエージェントが対応しない場合は、エージェントアカウントがオンラインで、プロジェクトの対応権限を持っているか確認してください。
• ユーザープロファイルのソースが空：分流リンクで取得した情報は、ユーザーが初回クリックした時のみ記録されます。ユーザーが再度クリックしたり、別の方法でBotにアクセスしたりすると、ソースフィールドが上書きされたり空になったりする可能性があります。ユーザーセッションごとに個別のリンクを作成することを推奨します。

よくある質問

Q：分流リンクの有効期限はどのくらいですか？手動での更新は必要ですか？
A： 分流リンクは作成後、コントロールパネルで手動削除するかプロジェクトが削除されない限り、長期間有効です。更新は不要ですが、管理を明確にするために使用しなくなったリンクは定期的に削除することを推奨します。

Q：1つのプロジェクトで複数の分流リンクを作成できますか？
A： はい。TG-Staffは1つのプロジェクトあたりの分流リンク数に制限を設けていません。キャンペーン、チャネル、期間に応じて複数のリンクを作成し、個別にトラッキングできます。

Q：分流リンクはHTTPSに対応していますか？ユーザーのプライバシーは安全ですか？
A： はい、すべての分流リンクはHTTPS暗号化通信を強制します。取得する情報（IP、ブラウザ、URLパラメータ）は帰属分析のみに使用され、他の目的には使用されません。一般的なプライバシー保護要件に準拠しています。

Q：ユーザーが分流リンクからBotに遷移した際にオンラインのエージェントがいない場合、どうなりますか？
A： ユーザーは通常通りBotの自動応答フローに入ります。「オンライン優先」の振り分けルールを設定していてエージェントがオンラインでない場合、システムは順番割り当てモードにフォールバックします。全エージェントがオフラインの場合、セッションはキューに保持され、エージェントがオンラインになり次第対応します。

Q：スタンダード版とプロフェッショナル版で分流リンク機能に違いはありますか？
A： コアの作成・配信機能は同じです。プロフェッショナル版では、ユーザープロファイルでより詳細なソース分析データを表示できるほか、分流リンクを内部統制ルールに関連付ける（特定のリンクを指定エージェントのみ対応可能にするなど）機能が追加で利用できます。

---

今すぐTG-Staffの分流リンクを体験：app.tg-staff.com にアクセスして無料トライアルに登録し、この記事の手順に従って最初の魔法のリンクを作成しましょう。高度な設定（UTMパラメータ管理、内部統制連携など）については、公式ドキュメントをご参照ください。設定中に問題が発生した場合は、@tgstaff_robot までお気軽にご連絡ください。リアルタイムサポートを提供します。