Telegram マルチBot管理ガイド：TG-Staffでプロジェクト分離、エージェント割り当て、データ独立を実現

複数のTelegram Botを運用するチームは、権限の混乱、データの混在、エージェントが何度も異なる管理画面にログインする手間といった共通の課題に直面することがよくあります。この記事では、TelegramマルチBot管理のベストプラクティスを体系的に解説し、TG-Staffのマルチプロジェクト管理機能を活用して、プロジェクトの分離、きめ細かな権限制御、独立したデータ運用を実現する方法を紹介します。

なぜTelegramマルチBot管理が必要なのか？

チームが複数のTelegram Botを同時に運用するシナリオは非常に一般的です：

• 異なるビジネスライン：ECの販売前、販売後、物流照会にそれぞれ別のBotを使用し、ユーザーの混乱を防ぎます。
• 多言語カスタマーサポート：英語、中国語、日本語にそれぞれBotを用意し、自動翻訳と組み合わせてローカライズサービスを提供します。
• テスト環境と本番環境：開発環境のBotは機能検証用、本番環境のBotは実際のユーザー向け。
• ブランド分離：異なるブランドやサブブランドで独立したBotを使用し、ブランドイメージとデータの独立性を維持します。

統一管理がない場合の一般的な課題：

• 権限の混乱：エージェントは複数の管理画面のアカウントとパスワードを覚える必要があり、誤って他のビジネスラインの会話を操作してしまうことも。
• データの混在：ユーザータグや会話記録が混ざり合い、分析レポートが正確に原因を特定できません。
• 効率低下：エージェントが複数の管理画面を切り替える際に、メッセージを見逃したり、ログインを繰り返したりしがちです。

TG-Staffは「プロジェクト」メカニズムでこれらの問題を解決します：各プロジェクトが1つのBotにバインドされ、プロジェクト間でデータは完全に分離され、エージェントの権限はプロジェクトごとに独立して設定可能です。

TG-Staffのマルチプロジェクト管理：基本概念と前提条件

始める前に、TG-Staffのいくつかの基本概念を理解する必要があります。

プロジェクト、Bot、プランの対応関係

概念	説明
プロジェクト	TG-Staff内の独立した運用単位で、1つのTelegram Botにバインドされます。
Bot	BotFatherで作成したTelegram Botで、各Botは1つのトークンに対応します。
プラン	作成できるプロジェクト数を決定します。無料トライアル期間は1プロジェクトに対応；スタンダード版は複数プロジェクトに対応（詳細は公式サイトのプランページを参照）；プロフェッショナル版はさらに多くのプロジェクトと高度な機能をサポートします。

簡単に言えば：1つのプロジェクト = 1つのBotです。チームが管理するBotの数に応じて適切なプランを選択する必要があります。

開始前の準備：複数のBotをコンソールにバインドする

TG-Staffで複数のBotを管理する手順は非常にシンプルです：

1. Botトークンを取得：Telegramで @BotFather を開き、各Botに対して /newbot コマンドを使用して作成するか、既存のBotで /mybots を使用してトークンを取得します。
2. TG-Staffコンソールにログイン：app.tg-staff.com にアクセスし、登録します（3日間無料トライアル）。
3. 最初のプロジェクトを作成：コンソールに入ったら「プロジェクトを作成」をクリックし、プロジェクト名を入力し、最初のBotのトークンを貼り付けてバインドを完了します。
4. プロジェクトを追加：プロジェクト一覧ページで「新規プロジェクト」をクリックし、上記の手順を繰り返して、2つ目、3つ目のBotをバインドします。

ステップ1：複数のBotプロジェクトを作成・設定する

Bot Tokenをバインドした後、プロジェクト設定で各プロジェクトをさらにカスタマイズできます：

• プロジェクト名：業務シナリオに基づいて命名することを推奨します。例：「プリセールスサポート - 英語版」「テスト環境Bot」。
• Botプロフィール編集：コンソール内で直接Botのアイコン、名前、説明を変更できます。BotFatherに移動する必要はありません。これはブランドイメージを迅速に反復するのに非常に便利です。
• チャット背景：スタンダード版は単色背景をサポート。プロフェッショナル版はTGテーマのチャット背景（ライト/ダーク）を設定でき、ユーザー体験を向上します。
• 翻訳設定：プロジェクトが多言語サポートを伴う場合、プロジェクト設定で自動翻訳を有効にできます（スタンダード版はAI翻訳を含む。プロフェッショナル版はさらにGoogleプロフェッショナル翻訳、DeepLプロフェッショナル翻訳をサポート）。

各プロジェクトは独立して設定され、互いに干渉しません。

ステップ2：各プロジェクトに独立したエージェントと権限を設定する

複数Bot管理の核心は権限の分離にあります。TG-Staffはエージェントのプロジェクトアクセス範囲を制御する2つの方法を提供しています。

エージェントを追加し、プロジェクト権限を割り当てる

1. 「エージェント管理」ページに移動し、「エージェントを招待」をクリックします。
2. エージェントのメールアドレスを入力するか、招待リンクを送信します。
3. エージェント詳細ページの「プロジェクト権限」エリアで、そのエージェントがアクセスできるプロジェクトにチェックを入れます。
   • 例：エージェントAは「プリセールスサポート」プロジェクトのみにチェック、エージェントBは「アフターサポート」と「配送問い合わせ」の2つのプロジェクトにチェック。
4. 保存後、エージェントがコンソールにログインすると、権限が与えられたプロジェクトのセッションのみを表示できます。

これにより、エージェントAはプロジェクトBのセッションデータを完全に見ることができず、厳格な権限分離が実現します。

「指定オペレーター」を使用したより細かい権限制御

プロジェクト設定では、誰がそのBotのセッションを処理できるかをさらに制限できます：

• 全オペレーター：デフォルトオプション。そのプロジェクトにアクセス権限を持つすべてのエージェントがセッションを処理できます。
• 指定オペレーター：選択した特定のエージェント（またはエージェントグループ）のみがそのプロジェクトのセッションを処理できます。

適用シナリオ：コアビジネスBotや機密プロジェクト（例：財務相談Bot）は、経験豊富なエージェントのみが操作でき、一般エージェントは介入できません。

「プロジェクトレベルのオペレーター範囲」と「エージェントのプロジェクト権限」を組み合わせることで、非常に細かい多層権限システムを構築できます。

ステップ3：ダイバージョンリンクを活用してチャネル別のトラフィック帰属を区別する

TG-Staffのダイバージョンリンクは、複数プロジェクト管理のためのもう一つの強力なツールです。各プロジェクトは専用の短縮リンク（例：https://app.tg-staff.com/{code}）を生成でき、異なる広告チャネルやソーシャルメディアプラットフォームからのトラフィック誘導に使用できます。

操作方法：

1. プロジェクトの「ダイバージョンリンク」設定ページに移動します。
2. 各チャネル（Facebook広告、Google Ads、Twitterプロモーションなど）ごとに異なるリンクを生成します。
3. ユーザーがリンクをクリックすると、自動的にそのプロジェクトのTelegram Botにリダイレクトされ、セッションが開始されます。

核心的価値：

• 帰属トラッキング：ダイバージョンリンクは自動的に訪問者のIP、ブラウザ情報、URLパラメータをキャプチャし、どのチャネルがより多くの問い合わせをもたらしたかを分析するのに役立ちます。
• トラフィック振り分け：「セッション振り分け」ルール（ラウンドロビンまたはオンライン優先）と組み合わせて、問い合わせのピーク時に自動的にユーザーをオンラインのエージェントに割り当て、待ち時間を削減します。

複数プロジェクト管理では、異なるプロジェクトのダイバージョンリンクデータは完全に独立しており、各Botのトラフィック効果を個別に確認できます。

データの独立性と統計：各プロジェクトは独立した運用ユニット

TG-Staffはデータレベルで完全な分離を実現しています：

• セッション記録：各プロジェクトのセッションリストとチャット履歴は互いに見えません。
• ユーザータグとプロファイル：プロジェクトAでユーザーに付与されたタグ（例：「高意向顧客」）はプロジェクトBには表示されません。
• 統計ダッシュボード：プロフェッショナル版ユーザーは、各プロジェクトの独立したデータダッシュボードを表示でき、セッション数、応答時間、ユーザーアクティビティなどの指標を含みます。
• 一括配信：プロジェクトごとにメッセージを配信するため、他のBotのユーザーに誤って送信することはありません。

この設計により、各プロジェクトは独立した運用ユニットとなり、業務ラインごとの管理やチームごとの評価が必要なシナリオに適しています。

ベストプラクティス：複数プロジェクト管理における注意点

• 定期的にエージェント権限設定を確認する：エージェントの異動やプロジェクトの追加があった場合、エージェントのプロジェクト権限を速やかに更新し、権限外の操作を防ぎます。
• コンテンツリスク管理を活用してプロジェクトリスクを区別する：プロフェッショナル版はコンテンツリスク管理（内部統制管理）をサポートし、プロジェクトごとに異なるリスクワードを設定できます。例えば、金融プロジェクトではウォレットアドレスキーワードを監視し、カスタマーサポートプロジェクトでは機密ワードを監視します。
• Botコマンドの競合を避ける：複数のBotが同じコマンド（例：/start、/help）を共有する場合、各プロジェクトのビジュアルコマンドフロー設定がビジネスロジックに適合し、ユーザーが混乱しないようにします。
• プロジェクト数を適切に計画する：すべての細かいシナリオに対して個別のプロジェクトを作成しないでください。業務ラインやユーザーグループごとに分類し、プロジェクトが多すぎて管理コストが増加するのを避けます。
• 「オンライン優先」振り分けルールを活用する：迅速な応答が必要なプロジェクト（例：プリセールス問い合わせ）では、「オンライン優先」振り分けを設定し、ユーザーが常にオンラインのエージェントに引き継がれるようにします。

よくある質問

Q：1つのエージェントで複数プロジェクトの会話を同時に管理できますか？ A：はい。TG-Staffでは、1つのエージェントアカウントに複数のプロジェクトへのアクセス権限を付与できます。エージェントはコンソールにログイン後、プロジェクトスイッチャーで異なるBotの会話ウィンドウを選択でき、複数回ログインする必要はありません。

Q：異なるプロジェクトの会話データは互いに干渉しますか？ A：いいえ。各プロジェクトの会話記録、ユーザータグ、統計データ、一括配信タスクは完全に独立して保存されます。エージェントはアクセス権限のあるプロジェクトのデータのみ表示できます。

Q：無料トライアル期間中にマルチプロジェクト管理をテストできますか？ A：無料トライアル期間は1プロジェクトのみ作成可能です。マルチプロジェクト管理フローをテストする場合は、スタンダードプラン（複数プロジェクト対応）にアップグレードし、3日間のトライアル期間を活用して十分に体験することをお勧めします。

Q：既存のBotを他プラットフォームからTG-Staffのマルチプロジェクト管理に移行するにはどうすればよいですか？ A：コンソールで新規プロジェクトを作成し、Bot Tokenをバインドするだけです。TG-Staffが自動的にそのBotの会話を引き継ぎ、過去のメッセージはBot側に残ります。詳細な移行ガイドは公式ドキュメントをご参照ください。

Q：マルチプロジェクト管理時、一括配信が誤って他プロジェクトのユーザーに送信されることはありますか？ A：いいえ。一括配信機能はプロジェクト単位で厳密に実行されます。現在のプロジェクト内でそのプロジェクトのユーザーセグメントを選択してのみ配信でき、プロジェクトをまたいだ操作はできません。

---

さらにサポートが必要な場合は、カスタマーサポートBot：@tgstaff_robotまでご連絡ください。詳細な技術ドキュメントはdocs.tg-staff.comをご覧ください。