Telegram セッション振り分けトラブルシューティング：新規セッション未割り当てとオペレーターがメッセージを受信できない問題の修正ガイド

セッション振り分けは、B2B SaaSカスタマーサポートシステムの中核機能です。新規ユーザーがTelegram Botに参加した後、利用可能なオペレーターに適時に割り当てられるかどうかを決定します。しかし、多くのチームがTG-Staffを設定する際に、「新しいセッションに対応する人がいない」「オペレーターがオンラインなのにメッセージを受信できない」「セッションがずっと未割り当てのまま」といった問題に直面します。

この記事は、運用チームやカスタマーサポートチームの管理者向けのセッション振り分けトラブルシューティングガイドです。最も一般的な障害現象から始めて、設定ロジックを段階的に分解し、印刷可能なチェックリストを提供します。Telegram Botをカスタマーサポートやコミュニティ運用に使用している場合、この記事は問題を迅速に特定し、カスタマーサポートシステムが正常に動作するようにするのに役立ちます。

セッション振り分けの一般的な障害現象一覧

トラブルシューティングを始める前に、どの状況に直面しているかを確認してください。以下の3つの障害が最も頻繁に発生し、それぞれ原因が異なります：

• 新しいセッションがどのオペレーターにも割り当てられない：ユーザーがBotに参加しても、オペレーター側に新しいセッションが表示されない、またはセッションが「未割り当て」状態のままになる。
• オペレーターがオンラインでも新規セッション通知を受信できない：オペレーターがWebポータルにログインし、ステータスがオンライン表示でも、新しいセッションがポップアップせず、手動でリフレッシュする必要がある。
• メッセージの喪失や遅延：オペレーターがメッセージに返信してもユーザーに届かない、またはユーザーのメッセージが会話ウィンドウに表示されない。

この記事では、主に最初の2つのシナリオに焦点を当てます。メッセージの遅延や喪失が発生している場合は、まずBot Tokenが有効か、ネットワークが安定しているか、コンテンツフィルタリングルール（プロ版）がトリガーされていないかを確認してください。

ステップ1：オペレーターのオンラインステータスとアカウントログインを確認する

これは最も見落とされがちな障害の原因です。多くのチームは「オペレーターがTelegramにログインしている」ことをオンラインと見なしますが、TG-Staffでは、**オペレーターはWebポータル（https://app.tg-staff.com/）并保持会话页面打开**，才能接收新会话。）にログインする必要があります**。

トラブルシューティング手順：

1. オペレーターアカウントがWebポータルにログインしていることを確認します（右上のアバターにオンラインステータスが表示されているか確認）。
2. ブラウザがTG-Staffからの通知を許可しているか確認します（Chrome設定→プライバシーとセキュリティ→サイト設定→通知で、app.tg-staff.comがブロックされていないことを確認）。
3. オペレーターに手動でセッションページを更新してもらいます：F5キーを押すか、ブラウザの更新ボタンをクリックし、5秒待って新しいセッションが表示されるか確認します。
4. オペレーターが長時間操作しなかった場合、ログインが期限切れになっている可能性があります。ログアウトしてから再ログインし、一度テストしてください。

よくある誤解：オペレーターがスマートフォンでTG-Staff Bot（例：@tgstaff_robot）にログインし、それでセッションを受信できると思っていること。実際には、オペレーターはユーザーに対応するためにWebポータルを使用する必要があります。

ステップ2：振り分けルールの設定が正しいか確認する

オペレーターがログインしてステータスが正常でも、新しいセッションが割り当てられない場合、次はプロジェクトレベルの振り分けルールを確認します。

TG-Staffコンソールでは、各Botプロジェクトごとに独立して振り分けルールを設定できます。現在、2つのモードがサポートされています：

順番割り当てモードにおけるオペレーターの順序とポーリングロジック

• 順番割り当てはデフォルトモードです。システムはオペレーターリストの順序でポーリングし、次に利用可能なオンラインオペレーターにセッションを割り当てます。
• オペレーターがオフラインの場合、システムはそのオペレーターをスキップし、次のオペレーターをポーリングし続けます。
• 重要なポイント：すべてのオペレーターがオフラインの場合、新しいセッションは「未割り当て」状態のままで、オペレーターがオンラインになって手動で引き取るか、システムが再割り当てするまで待機します。

例：プロジェクトに3人のオペレーター（A、B、C）がいて、順序がA→B→Cの場合。新しいセッションが入ると、システムはまずAがオンラインかどうかを確認します：オンラインなら割り当て、オフラインならBを確認、以下同様。A、B、Cすべてがオフラインなら、割り当ては行われません。

オンライン優先モードにおける「全オフライン」時のフォールバックメカニズム

• オンライン優先モードでは、現在オンラインのオペレーターに優先的にセッションを割り当てます（固定の順序ではなく、ランダムまたは負荷に応じて割り当て）。
• すべてのオペレーターがオフラインの場合、システムは順番割り当てロジックにフォールバックします。つまり、すべてのオペレーターがオフラインの場合、新しいセッションは同様に「未割り当て」状態のままです。
• 推奨：チームに複数のオペレーターがいて、一部のオペレーターが常時オンラインでない場合は、「オンライン優先」モードを使用して、オンラインのオペレーターが迅速にセッションを受信できるようにすることをお勧めします。

トラブルシューティング手順：

1. TG-Staffコンソール→プロジェクト設定→セッション振り分けルールに移動します。
2. 現在のモードが期待するもの（順番割り当て vs オンライン優先）であることを確認します。
3. オペレーターリストが空でないことを確認します——リストにオペレーターがいなければ、誰もセッションを受信できません。
4. 「指定オペレーター」範囲を使用している場合、すべての対象オペレーターが追加されていることを確認します（ステップ3を参照）。

ステップ3：プロジェクトのオペレーター範囲設定を確認する

これは非常に見落とされがちな設定ポイントです。TG-Staffのプロジェクト設定には、「オペレーター範囲」オプションがあり、次のように分かれています：

• すべてのオペレーター：プロジェクト内のすべてのオペレーターがそのBotのセッションを受信できます。
• 指定オペレーター：選択されたオペレーターのみがセッションを受信できます。

「指定オペレーター」を選択したが、対象オペレーターをリストに追加し忘れた場合、そのオペレーターがオンラインでも新しいセッションを受信できません。

トラブルシューティング手順：

1. プロジェクト設定→オペレーター範囲に移動します。
2. 現在が「すべてのオペレーター」か「指定オペレーター」かを確認します。
3. 「指定オペレーター」の場合、リストに対応が必要なすべてのオペレーターアカウントが含まれているか確認します。
4. オペレーターがリストにない場合、「オペレーターを追加」をクリックして追加し、保存します。

第4ステップ：振分リンクとBotの関連性を確認

**振分リンク（マジックリンク）**を使用して広告やソーシャルメディアからユーザーをBotに誘導している場合は、リンク自体が正しく設定されているか確認する必要があります。

振分リンクはTG-Staffが提供する公式ドメインの短縮URL（例：https://app.tg-staff.com/{code}）で、リダイレクト前に訪問者のIP、ブラウザ情報、URLパラメータを取得します。リンクが無効または設定が間違っていると、ユーザーがセッション振分をトリガーできない可能性があります。

確認手順：

1. TG-Staffコンソール → 振分リンク管理で該当のリンクを見つけます。
2. リンクに関連付けられたBot Tokenが有効か確認します。TokenがリセットされたりBotが削除された場合、リンクは無効になります。
3. リンクが期限切れでないことを確認します（振分リンクには有効期限を設定できます）。
4. プライベートブラウザで振分リンクを開き、リダイレクト先が正しいか確認します（Telegram Botの会話ページにリダイレクトされるべきです）。
5. リダイレクト後にBotが応答しない場合、Botが起動しているか確認します（TelegramでBotに/startを送信してテスト）。

クイックテスト方法：Chromeのシークレットウィンドウで振分リンクを開き、アドレスバーの最終リダイレクト先URLを確認します。間違ったBotにリダイレクトされたり404が表示された場合、リンク設定に誤りがあるため再生成が必要です。

第5ステップ：システムログとユーザープロファイルを確認

上記の手順をすべて確認しても問題が解決しない場合は、TG-Staff Pro版のユーザープロファイルとデータ統計機能を使用して詳細な調査を行います。

• ユーザープロファイル：特定のセッションの完全な記録（割り当て時間、オペレーターの操作、コンテンツモデレーションのトリガーなど）を確認できます。これにより、設定の問題か一時的なネットワーク遅延かを判断できます。
• データ統計：セッション割り当ての成功率、オペレーターのオンライン時間、平均応答時間などの指標を確認します。特定の期間に割り当て成功率が急激に低下した場合、バッチ障害が発生した可能性があります。

標準版ユーザー：高度な統計機能が利用できない場合は、TG-StaffカスタマーサポートBot（@tgstaff_robot）に直接連絡し、プロジェクトIDと障害の説明を提供してください。テクニカルサポートチームが調査を支援します。

セッション振分トラブルシューティングチェックリスト（クイック版）

以下は印刷可能なチェックリストです。迅速に一つずつ確認できます：

番号	確認項目	ステータス（✓ / ✗）
1	オペレーターがWebポータルにログインしている（https://app.tg-staff.com/）？）	☐
2	オペレーターのステータスが「オンライン」と表示されている？	☐
3	ブラウザがTG-Staffからの通知を許可している？	☐
4	振分ルールが空に設定されていない（プロジェクト設定に少なくとも1人のオペレーターがいる）？	☐
5	振分ルールのモードが正しい（順番割り当てまたはオンライン優先）？	☐
6	プロジェクトのカスタマーサービス範囲に該当オペレーターが含まれている（「指定オペレーター」の場合）？	☐
7	Bot Tokenが有効でBotが稼働中？	☐
8	振分リンクが期限切れでなく、正しいBotを指している？	☐
9	オペレーターが手動でセッションを「完了」とマークしていない（新しいセッションを受信できなくなる）？	☐
10	セッションページをリロードするか、ログアウト後に再ログインしてみた？	☐

上記10項目すべてをクリアしても問題が解決しない場合は、TG-Staffカスタマーサポートに連絡するか、公式ドキュメント（https://docs.tg-staff.com/）获取更多配置细节。）を参照してください。

よくある質問

Q：新しいセッションが「未割り当て」と表示されるが、オペレーターはオンラインになっている。どうすればよいか？

A： まず、オペレーターがTG-Staff Webポータルにログインしているか確認します（Telegramのみにログインしているだけではないか）。次に、プロジェクトのカスタマーサービス範囲に該当オペレーターが含まれているか、振分ルールが「指定オペレーター」に設定されていて該当オペレーターが追加されていないかを確認します。最後に、セッションページをリロードするか、ログアウト後に再ログインしてみてください。

Q：オペレーターがオフラインの場合、新しいセッションは自動的に誰に割り当てられるか？

A： 振分ルールに依存します。「順番割り当て」モードでは、システムはオフラインのオペレーターをスキップし、次の利用可能なオンラインオペレーターにセッションを割り当てます。すべてのオペレーターがオフラインの場合、新しいセッションは「未割り当て」状態のままで、オペレーターがオンラインになり手動で引き取るか、システムが再割り当てするのを待ちます。「オンライン優先」モードでも、同様に順番割り当てロジックにフォールバックします。

Q：振分リンクが無効になった。どうやって確認すればよいか？

A： 振分リンクが正しいBot Tokenを使用しているか、そのTokenに対応するBotが稼働中かを確認します。プライベートブラウザでリンクを再度開き、リダイレクト先が正しいか観察します。リンクが期限切れの場合は、TG-Staffコンソールで再生成する必要があります。

Q：オペレーターが新しいセッション通知を受信できない（ポップアップ/音なし）。なぜか？

A： ブラウザがTG-Staff Webポータルからの通知を許可しているか確認します（Chrome/Safari設定）。また、オペレーターはセッションページを開いたままにしておく必要があります（最小化したり他のタブに切り替えたりしない）。そうしないと、ブラウザが通知を抑制する可能性があります。

Q：無料トライアル版はセッション振分をサポートしているか？

A： はい。無料トライアル期間中は、セッション振分機能（順番割り当てとオンライン優先の両方）が完全に利用可能です。トライアル終了後は、標準版またはプロ版をサブスクライブして継続利用する必要があります（詳細な価格は公式サイトのプランページをご覧ください）。

---

安定したセッション振分機能を今すぐ体験：TG-Staffの3日間無料トライアルに登録（クレジットカード不要）し、実際のプロジェクトですべての設定をテストできます。解決できない障害が発生した場合は、@tgstaff_robot までお問い合わせください。詳細な設定については、公式ドキュメント（https://docs.tg-staff.com/）。）を参照してください。