リアルタイム翻訳カスタマーサポートシステムトラブルシューティングガイド：翻訳中断、エージェント切断、振り分け失敗

クロスボーダーカスタマーサポートチームがリアルタイム翻訳機能を利用して多言語セッションを処理する際、最も恐れるのは「翻訳の突然の中断」「エージェントの切断」「ユーザーが入れない」という3つのトラブルです。これらの問題は単一の原因によるものではなく、プランクォータ、ネットワーク環境、設定ミス、Telegramプラットフォームの制限が連鎖的に発生します。本記事では、10分以内に問題を特定しサービスを復旧するための体系的なトラブルシューティングフローを提供します。

トラブル1：リアルタイム翻訳の中断——診断と復旧

翻訳の中断はクロスボーダーカスタマーサポートで最も一般的なトラブルです。ユーザーから送信されたロシア語のメッセージが原文のまま表示され、エージェントが返信した英語も翻訳されません。このような状況は通常、翻訳APIクォータの枯渇、プラン変更、または自動翻訳設定の誤変更の3つの原因により発生します。

翻訳クォータとプランステータスの確認

ステップ1：TG-Staffコンソールにログイン（https://app.tg-staff.com/），进入“我的订阅”页面。）

• 現在のプランが「スタンダード」または「プロフェッショナル」であることを確認します。無料トライアル期間が終了すると、翻訳機能は停止します。
• 「翻訳クォータ」の1日あたりの使用量を確認します。スタンダードプランにはAI翻訳が含まれ、1日あたりのクォータ制限があります。プロフェッショナルプランはより高いクォータを提供し、Googleプロ翻訳やDeepLプロ翻訳もサポートします。クォータを使い切ると、翻訳は翌日リセットされるかプランをアップグレードするまで一時停止します。
• プランが「期限切れ」と表示された場合、StripeまたはUSDTで更新後、翻訳機能は通常1〜2分以内に自動的に復旧します。復旧しない場合は、コンソールページをリフレッシュするか、再ログインしてみてください。

自動翻訳設定とネットワーク接続の確認

翻訳中断のもう一つの一般的な原因は、プロジェクト設定の誤変更です。

• 「プロジェクト設定 → 自動翻訳」に移動し、スイッチが「オン」になっていることを確認します。
• 「ソース言語」と「ターゲット言語」が正しいか確認します。例えば、エージェントが主に中国語で返信する場合、ターゲット言語が誤って日本語に設定されていると、エージェントが中国語のメッセージを送信しても翻訳はトリガーされません。
• Telegram APIの接続をテストします。Botで簡単なメッセージ（「/start」など）を送信し、コンソールが正常に受信するか観察します。コンソールが応答しない場合、ネットワークまたはTelegramサービスに変動がある可能性があります。ネットワーク環境を切り替えて（例：プロキシを無効にする）再試行してください。

故障2：エージェントの切断またはWebコンソールへのログイン不可

エージェントが突然「オフライン」状態になったり、ログイン時に「アカウント異常」と表示されるのは、運用チームにとって最も頭の痛い問題の一つです。調査の方向性は以下の点に集中します。

エージェント枠と権限割り当ての確認

TG-Staffはプランごとに固定のエージェント枠を提供しています：標準版3つ、プロフェッショナル版5つまたは20つ。チームですでに全てのエージェント枠を使い切っている場合、新しいエージェントはログインできません。

• コンソールの「メンバー管理」ページで、割り当て済みのエージェント数が上限に達していないか確認します。満杯の場合は、非アクティブなエージェントを削除するか、プランをアップグレードして追加枠を取得します。
• 該当エージェントに対応プロジェクトの操作権限が割り当てられていることを確認します。「プロジェクト設定 → カスタマーサービス範囲」に進み、そのプロジェクトが「全カスタマーサービス」または「特定のカスタマーサービスのみ」に指定されているか確認します。エージェントが指定リストに含まれていない場合、ログインに成功しても会話を表示できません。

ブラウザキャッシュのクリアとネットワーク環境の確認

多くのエージェント切断問題は、実はローカル環境に起因します。

• ブラウザのキャッシュとCookieをクリア：ChromeまたはEdgeユーザーは Ctrl + Shift + Delete を押し、「全期間」を選択してクリアします。
• ブラウザプラグインを無効化：一部の広告ブロッカーやセキュリティプラグインがWebSocket接続を妨害し、エージェント状態の同期ができなくなる可能性があります。
• ネットワーク環境を切り替え：エージェントがプロキシやVPNを使用している場合、オフにしてから再ログインしてみてください。TG-Staffコンソールは安定したWebSocket接続を必要とし、不安定なプロキシは頻繁な切断を引き起こします。
• 複数デバイスでのログインを確認：同じエージェントアカウントはシングルサインオン（SSO）のみサポートしています。エージェントがスマートフォンとPCの両方で同時にログインしている場合、先にログインしたデバイスが強制的にログアウトされます。

故障3：セッション振り分けの失敗——ユーザーが正しくエージェントに割り当てられない

ダイバージョンリンク（Diversion Link）は、広告トラフィック誘導とチャネルアトリビューションの中核ツールです。しかし、ユーザーがリンクをクリックした後、白いページに飛んだり、Botに入った後ずっと有人エージェントの応答を待ち続けたりすることがあります。

ダイバージョンリンクと対象Botの対応関係の検証

ダイバージョンリンクはTG-Staff公式ドメインのショートリンクで、形式は https://app.tg-staff.com/{code} です。

• コンソールの「ダイバージョンリンク」ページで、そのリンクが正しいBotを指しているか確認します。Botが変更されたりプロジェクトが削除されたりすると、リンクは無効になります。
• 対象BotがTG-Staffの「Bot追加」フローを通じてプロジェクトに関連付けられていることを確認します。Botが関連付けられていない場合、ダイバージョンリンクはジャンプをトリガーできません。
• カスタムドメインを使用している場合、DNS解決が正常か確認します。ターミナルで nslookup コマンドを使用してドメイン解決をテストするか、カスタムドメインに直接アクセスして404が返らないか確認します。

振り分けルール設定とエージェントのオンライン状態の確認

ユーザーがBotに入った後にエージェントが割り当てられないのは、通常振り分けルールに関係します。

• 「プロジェクト設定 → セッション振り分け」に進み、現在のルールが「順番割り当て」か「オンライン優先」かを確認します。順番割り当ては、エージェントのオンライン状態に関わらず、権限のあるエージェントに順番にユーザーを割り当てます。オンライン優先は、現在オンラインのエージェントにのみ割り当てます。全てのエージェントがオフラインの場合、オンライン優先モードは順番割り当てにフォールバックしますが、ユーザーは依然として待機する必要があるかもしれません。
• 対象となる全エージェントのオンライン状態を確認します。コンソールの「エージェント管理」ページで、各エージェントの状態インジケーターを確認します。複数のエージェントがオフライン表示の場合、ユーザーが同じオンラインエージェントに割り当てられ、混雑を引き起こす可能性があります。
• 「カスタマーサービス範囲」が特定のエージェントに制限されていないか確認します。振り分けルールが「カスタマーサービスのみ」と指定しているが、そのカスタマーサービスAがオフラインの場合、ユーザーは割り当てられません。

故障4：メッセージの遅延または送信失敗

エージェントがWebコンソールでメッセージに返信したのに、ユーザーがなかなか受信できない。または、ユーザーが送信したメッセージが長時間コンソールに表示されない。これは通常、Telegramのレート制限とWebSocket接続の問題に関係します。

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

• コンソールの「メッセージログ」で送信ステータスを確認します。「送信済み」と表示されているのにユーザーが受信していない場合は、ユーザーにTelegramのプライバシー設定でBotからのメッセージを許可しているか確認してもらってください（設定 → プライバシーとセキュリティ → メッセージ → 連絡先以外からのメッセージを許可）。
• 「コンテンツリスク管理」ログを確認します。プロフェッショナル版ユーザーが内部統制管理を有効にしている場合、エージェントが送信するメッセージはリスクワードの検出を受けます。リスクワード（特定のウォレットアドレスなど）にヒットすると、メッセージがブロックされ、エージェントに再確認ダイアログが表示されます。「リスク管理ログ」ページで具体的なトリガー記録を確認できます。
• WebSocket接続状態を検証します。ブラウザの開発者ツール（F12）の「ネットワーク」タブで、ws:// または wss:// の接続を探します。接続が切れている場合は、ページを更新するか再ログインして復旧します。

障害予防とベストプラクティス

障害の発生確率を減らすことは、緊急時のトラブルシューティングよりも重要です。以下の日常運用のアドバイスを参考にしてください。

• 定期的なプランと割り当ての確認：毎週月曜日にコンソールにログインし、サブスクリプションの有効期限と翻訳割り当ての使用状況を確認します。カレンダーリマインダーを設定し、プラン期限の3日前に更新してサービス中断を防ぎます。
• 監視アラートの設定：TG-StaffはBotを介したシステム通知（割り当て枯渇、エージェントオフラインなど）をサポートしています。コンソールの「通知設定」でこれらのアラートを有効にし、問題を早期に発見します。
• エージェント引き継ぎプロセスの策定：エージェントが交代制の場合、交代の10分前にセッションを移行することを推奨します。「セッション転送」機能を使用して、未処理のセッションを交代のエージェントに割り当て、ユーザーの待機を防ぎます。
• 分流リンクのバックアップ：重要な広告チャネルについては、複数の予備の分流リンクを生成し、定期的にテストします。メインリンクが無効になった場合、迅速に予備リンクに切り替えられます。
• トラブルシューティングドキュメントの作成：上記のトラブルシューティング手順をチーム内のSOPとしてまとめ、障害発生時に手順に従って対応することで、コミュニケーションコストを削減します。

よくある質問

質問： リアルタイム翻訳が突然停止しましたが、プランは期限切れではありません。考えられる原因は？

回答： 翻訳APIの割り当て枯渇（スタンダード版は日次制限あり）、ネットワーク変動による接続断、またはプロジェクト設定で自動翻訳スイッチが誤ってオフになった可能性があります。まずコンソールの「翻訳設定」ページで割り当て使用量とスイッチの状態を確認してください。

質問： エージェントアカウントが「オフライン」と表示されますが、ネットワークは正常です。どう解決すればよいですか？

回答： まず、そのエージェントが現在のプロジェクトに割り当てられ、権限を持っていることを確認してください。次に、ブラウザのキャッシュをクリアするか、シークレットモードで再ログインしてみてください。問題が続く場合は、複数のデバイスに同時ログインしていないか確認してください。TG-Staffの同一エージェントアカウントはシングルサインオンしかサポートしていません。

質問： 分流リンクをクリックしてもBotに遷移せず、空白ページが表示されます。どうすればよいですか？

回答： 分流リンクが期限切れまたは削除されていないか確認してください。コンソールの「分流リンク」ページで新しいリンクを再生成し、正しいBotプロジェクトを指していることを確認してください。カスタムドメインを使用している場合は、DNS解決が正常かも確認してください。

質問： ユーザーのメッセージがWebコンソールに表示されますが、エージェントが返信しても相手に届きません。原因は？

回答： よくある原因として、Botがユーザーによって手動でブロックされている、メッセージがTelegramのコンテンツ審査やレート制限に引っかかっている、またはエージェントの返信にリスク管理ルールでブロックされるキーワードが含まれていることがあります。「コンテンツリスク管理」ログでブロックが発生していないか確認し、ユーザーにTelegramのプライバシー設定でBotからのメッセージを許可しているか確認してもらってください。

質問： TG-Staffはどの翻訳エンジンをサポートしていますか？切り替え方法は？

回答： スタンダード版はAI翻訳を提供します。プロフェッショナル版はGoogleプロフェッショナル翻訳とDeepLプロフェッショナル翻訳を追加でサポートします。コンソールの「プロジェクト設定 → 自動翻訳」でデフォルトの翻訳エンジンを選択できます。エンジンごとに割り当てと課金方法が異なりますので、詳細はプランページをご覧ください。

---

安定した拡張可能なTelegramリアルタイム翻訳カスタマーサービスシステムをお探しなら、ぜひTG-Staffをお試しください。登録すると3日間の無料トライアルが利用でき、リアルタイム双方向チャット、セッション分流、コンテンツリスク管理、自動翻訳機能を体験いただけます。問題が発生した場合は、いつでも公式カスタマーサポートBot（https://t.me/tgstaff_robot）或查阅文档（https://docs.tg-staff.com）。」までご連絡ください。