TG Bot カスタマーサポートシステム障害対応ガイド：エージェントログイン、セッション同期、分配機能の不具合解決策

Telegram Botをカスタマーサポートに利用しているチームは、おそらく次のような苛立たしい瞬間に遭遇したことがあるでしょう：エージェントが突然コンソールにログインできなくなる、顧客からのメッセージは確かに送信されたのにエージェント側で全く反応がない、または慎重に設定したセッション分配ルールが突然機能しなくなり、顧客がオフラインのエージェントに割り当てられてしまう。これらの問題はカスタマーサポートの効率に影響を与えるだけでなく、顧客離れを直接引き起こす可能性もあります。

本記事では、TG-Staff プラットフォームを参考に、TG Botカスタマーサポートシステムでよく発生する障害のトラブルシューティング手順をまとめました。TG-Staff を使用している場合でも、他のSaaSツールを使用している場合でも、これらの手順で問題を迅速に特定し、運用を復旧し、顧客の待ち時間を短縮できます。

エージェントのログインとアクセス障害のトラブルシューティング

エージェントがWebコンソールにログインできない、「権限が不足しています」と表示される、またはセッション画面の読み込みに失敗する場合は、以下の順序でトラブルシューティングを行います。

ネットワークとブラウザの互換性を確認

ブラウザの選択：TG-Staff コンソールは、Chrome および Firefox の最新バージョンとの互換性が最も高いです。Safari や Edge を使用している場合は、まず Chrome に切り替え、最新バージョンに更新することをお勧めします。
キャッシュとCookie：ブラウザのキャッシュとCookieをクリアし、再度 https://app.tg-staff.com/ にアクセスしてください。一部のブラウザ拡張機能（広告ブロッカーなど）がWebSocket接続を妨害する可能性があるため、シークレットモードでログインしてみてください。
企業ネットワークの制限：エージェントが社内ネットワークで作業している場合、VPNやファイアウォールが app.tg-staff.com のWebSocketポートをブロックしていないか確認してください。モバイルホットスポットに切り替えてテストすることもできます。

アカウント権限とプランステータスを確認

ログイン失敗の最も一般的な原因は、権限設定の誤りやプランの期限切れです。

権限割り当て：プロジェクト管理者アカウントでログインし、「プロジェクト設定」→「カスタマーサポート管理」で、該当エージェントが追加され、少なくとも1つのプロジェクトの操作権限が割り当てられていることを確認してください。エージェントがどのプロジェクトにも関連付けられていない場合、ログイン後に空白のページしか表示されません。
プランステータス：コンソール右上のアバター →「マイサブスクリプション」で、現在のプランが有効かどうかを確認してください。無料トライアルは3日間のみで、期限が切れるとすべてのエージェントがログインできなくなります。復旧するには、標準版またはプロフェッショナル版にアップグレードする必要があります。
エージェント枠：使用済みのエージェント数がプランの上限を超えていないか確認してください。

注意：エージェント数の制限

無料トライアルとスタンダード版ではエージェント数は3つまで、プロフェッショナル版では20まで対応しています。チーム人数がプランの上限を超えると、新しいエージェントはログインできなくなります。管理画面の「マイサブスクリプション」ページで現在のプランとエージェントの使用状況をご確認ください。

セッションの非同期とメッセージ遅延の問題

オペレーター側とTelegramユーザー側でメッセージが同期しない、履歴が失われる、またはメッセージが遅延する場合、通常はネットワーク接続または機能設定に関連しています。

セッションリストの更新とネットワーク接続の確認

手動更新：コンソールのセッションリストページで、右上の更新ボタン（またはF5）をクリックし、セッションリストが更新されるか確認します。更新後も新しいセッションが表示されない場合は、ブラウザの右下に「WebSocketが切断されました」というメッセージが表示されていないか確認します。
ページを開いたままにする：長時間操作しなかったコンソールページはサスペンド状態になり、リアルタイムメッセージのプッシュが中断される可能性があります。オペレーターは30分ごとにページの任意の場所をクリックするか、ブラウザの「ページをアクティブに保つ」機能を有効にすることをお勧めします。
ネットワーク安定性：ping app.tg-staff.com を使用してネットワーク遅延をテストします。パケットロス率が5%を超える場合はネットワークが不安定ですので、ネットワーク環境を切り替えることをお勧めします。

自動翻訳とコンテンツモデレーションの影響を確認

自動翻訳またはコンテンツモデレーション（プロフェッショナル版）が有効になっている場合、一部のメッセージに異常が発生する可能性があります：

翻訳の遅延：標準版では1日あたりの翻訳クォータに制限があります。クォータを使い切ると、新しいメッセージは原文で表示され、翻訳結果が数分遅れることがあります。コンソールの「プロジェクト設定」→「自動翻訳」で残りのクォータを確認できます。
コンテンツモデレーションによるブロック：プロフェッショナル版では、オペレーターが送信したメッセージにリスクワード（暗号通貨ウォレットアドレスなど）が含まれている場合、確認ダイアログが表示されるか、送信が直接ブロックされます。顧客から「メッセージを送ったのにオペレーターが受け取っていない」と報告があった場合、コンテンツモデレーションのトリガーログ（コンソール「内部管理」→「トリガーログ」）を確認して、ブロックされていないか確認します。

簡単なテスト方法：自動翻訳とコンテンツモデレーションを一時的に無効にし、テストメッセージを送信します。問題が解決した場合は機能設定が原因であるため、設定を段階的に調整します。

セッション振り分けの失敗と振り分けリンクのトラブルシューティング

振り分けルールが適用されない、振り分けリンクがジャンプできない、またはアトリビューションデータが失われることは、運用チームにとって最も頭の痛い問題の1つです。以下のトラブルシューティング手順は、TG-Staffの「セッション振り分け」および「振り分けリンク」機能に適用されます。

振り分けルールの設定とオペレーターのオンライン状態の確認

TG-Staffは2種類の振り分けルールをサポートしています：ラウンドロビン（デフォルト）とオンライン優先。顧客が誤って割り当てられた場合は、以下の手順で確認します：

ルールタイプの確認：「プロジェクト設定」→「セッション振り分け」に移動し、現在のルールを確認します。「オンライン優先」を選択した場合、システムはオンラインのオペレーターに優先的に割り当てます。すべてのオペレーターがオフラインの場合、ラウンドロビンにフォールバックします。
オペレーターのオンライン状態：権限を持つすべてのオペレーターが実際にオンラインかどうかを確認します。オペレーターがコンソールページを開いているが長時間操作しない場合、システムは「アイドル」とマークし、「オンライン」とは見なさない場合があります。オペレーターは勤務中はページをアクティブに保つことをお勧めします。
カスタマーサービス範囲：振り分けルールでは「すべてのカスタマーサービス」または「指定のカスタマーサービス」を設定できます。「指定のカスタマーサービス」を選択したがオペレーターを選択しなかった場合、振り分けは機能しません。

振り分けリンク（マジックリンク）の有効性の確認

振り分けリンク（Diversion Link）は、TG-Staffが提供する公式ドメインのショートリンクで、広告トラフィックのアトリビューションに使用されます。リンクがジャンプできない、またはアトリビューションデータが失われる場合：

リンクの有効期限：振り分けリンクはデフォルトで長期間有効ですが、プロジェクトが削除されるかリンクが手動で無効にされた場合、アクセス時に404が表示されます。「プロジェクト設定」→「振り分けリンク」でステータスを確認できます。
Telegramクライアントの互換性：一部のサードパーティ製Telegramクライアント（Plus Messengerなど）はURLジャンプをサポートしない場合があります。ユーザーには公式のTelegramクライアントでリンクを開くよう推奨します。
アトリビューションデータの損失：振り分けリンクは訪問者のIP、ブラウザ情報、URLパラメータをキャプチャします。アトリビューションデータが欠落している場合、ブラウザがサードパーティCookieをブロックしていないか確認します（一部のプライベートモードでは無効になります）。広告配信時には一意の振り分けリンクを使用し、コンソールの「データ統計」でアクセス記録を確認することをお勧めします。

ヒント：分流リンクの使用に関するアドバイス

分流リンク（Diversion Link）は広告トラフィックの帰属に使用されます。広告を配信する際には、一意の分流リンクを使用し、コンソールでアクセス記録を確認することをお勧めします。リンクが無効になった場合は、「プロジェクト設定」で再生成できます。

その他の一般的な操作トラブルと注意点

以下のエッジケースも留意すべきです：

Botプロフィールの編集失敗：コンソールでBotのアイコン、名前、説明を直接編集する際に「更新失敗」と表示された場合、Telegram APIのレート制限が原因である可能性があります。5分後に再試行してください。
一括メッセージ配信の到達率低下：一括送信時に多くのユーザーがメッセージを受信していない場合、ユーザーセグメント条件が正しいか確認してください（例：「アクティブユーザーのみ」にチェックが入っているか）。また、Telegram自体がBotからの能動的メッセージ送信に頻度制限を設けており、TG-Staffはキューで送信しますが、極端なケース（例：同時に10万人に送信）では数時間遅延する可能性があります。
暗号ウォレットアドレス監視の誤検知：プロフェッショナル版のコンテンツリスク管理機能は、エージェントが送信したメッセージにリスクワードが含まれているか監視します。通常のメッセージ（例：TRC20の技術的詳細の議論）を誤検知した場合、「内部統制管理」→「リスクワードグループ」でそのアドレスを監視リストから削除するか、トリガールールを「送信を阻止」ではなく「確認のみポップアップ表示」に調整できます。

TG-Staff テクニカルサポートへの連絡方法

上記のトラブルシューティング手順で問題が解決しない場合は、以下のチャネルからサポートを受けてください：

公式カスタマーサポートBot：@tgstaff_robot に直接連絡し、問題を説明してください（コンソールのスクリーンショットや操作手順を添付することをお勧めします）。
ドキュメントセンター：https://docs.tg-staff.com/ にアクセスし、キーワード（例：「振り分けリンク」、「コンテンツリスク管理」）で検索して詳細な設定ガイドを確認してください。
コンソール内フィードバック：コンソールにログイン後、右下の「ヘルプ」ボタンをクリックしてチケットを送信できます。通常1〜2営業日以内に返信があります（スタンダード版とプロフェッショナル版は優先的に処理されます）。

よくある質問

Q：エージェントがログイン時に「アカウントが存在しない」または「権限が不足しています」と表示されます。どうすればよいですか？

A：まず、エージェントアカウントがコンソール内で追加され、プロジェクト権限が割り当てられているか確認してください。次に、プランが期限切れでないか確認してください（無料トライアルは3日間で終了後、更新が必要です）。問題が続く場合は、プロジェクト管理者に連絡してエージェント枠が満杯でないか確認することをお勧めします。

Q：オンライン優先振り分けを設定したのに、顧客がオフラインのエージェントに割り当てられるのはなぜですか？

A：オンライン優先モードでは、権限のあるすべてのエージェントがオフラインの場合、システムは自動的にラウンドロビン割り当てルールにフォールバックします。少なくとも1人のエージェントがオンラインであることを確認するか、振り分けルールで「特定のスタッフ」ではなく「全スタッフ」が選択されているか確認してください。

Q：会話履歴が突然失われました。復元できますか？

A： TG-Staffは会話記録を保存しますが、永久保存はしません（保存期間はプラン説明に従います）。重要な会話データは定期的にエクスポートすることをお勧めします。会話の同期が取れない場合は、ページをリフレッシュするか、コンソールに再ログインしてください。

Q：自動翻訳機能が原因でメッセージ送信に失敗します。どうすれば無効にできますか？

A：コンソールの「プロジェクト設定」で「自動翻訳」スイッチを見つけ、オフにしてください。オフにしても問題が続く場合は、翻訳クォータが使い切られていないか確認してください（スタンダード版には1日あたりのクォータ制限があります）。

Q：暗号ウォレットアドレス監視が通常のメッセージを誤検知しました。どのように調整すればよいですか？

A：プロフェッショナル版の「コンテンツリスク管理」設定で、リスクワードグループを編集し、誤検知されたアドレスを監視リストから削除するか、トリガールールを調整してください（例：ポップアップ確認ではなくブロックのみ）。定期的にトリガーログを確認し、リスクワード辞書を最適化することをお勧めします。

まとめとアクション提案

TG Botカスタマーサポートシステムのトラブルシューティングの核心は、「ネットワーク → 権限 → 設定 → 機能」の階層的な確認です。この記事で挙げた手順は、ログイン、会話同期、振り分けの3大頻出トラブルシナリオをカバーしており、チームの運用迅速な回復に役立つことを願っています。

安定した高機能なTG Botカスタマーサポートプラットフォームをお探しなら、ぜひ TG-Staff をお試しください：

今すぐ3日間の無料トライアルに登録：https://app.tg-staff.com/
完全なドキュメントを確認：https://docs.tg-staff.com/
問題が発生した場合、カスタマーサポートBotに連絡：https://t.me/tgstaff_robot

顧客の待ち時間を減らすには、正しいトラブルシューティングから始めましょう。

TG Bot カスタマーサービスシステム障害トラブルシューティングガイド：ログイン、セッション非同期、分流失敗

关于作者