View a markdown version of this page

トラブルシューティングのために Connect Customer Client Application ログファイルをダウンロードする - Amazon Connect Customer

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

トラブルシューティングのために Connect Customer Client Application ログファイルをダウンロードする

画面録画に関する問題のサポート AWS チケットを開くときは、エージェントデスクトップから Connect Customer クライアントアプリケーションと共有ワーカーのログファイルを含めます。

Connect Customer クライアントアプリケーションログファイル (Windows)

エージェントのデスクトップで、以下に移動します。

  • C:\ProgramData\Amazon\Amazon.Connect.Client.Service\logs

    このファイルには、ブラウザとクライアントアプリケーション間の Websocket 接続、Amazon.Connect.Client と Amazon.Connect.RecordingSession 間の別の Websocket 接続などのログが含まれています。

  • %USERPROFILE%\AppData\Local\Amazon\Amazon.Connect.Client.RecordingSession\Logs

    このファイルには、画面録画アクティビティのログが含まれています。(バージョン 1.x には該当しません。)

  • %USERPROFILE%\AppData\Local\Amazon\Amazon.Connect.Client.Messaging.NativeHost\Logs

    このファイルには、拡張 IPC メッセージのログが含まれています。(バージョン < 3.x には適用されません)。

共有ワーカーログ (Windows および ChromeOS)

CCP を開きます。ClientAppInterface 共有ワーカーを表示するには、これが開いている必要があります。

Chrome

  1. Chrome ブラウザを開きます。URL タイプ chrome://inspect/#workers の場合。

  2. [共有ワーカー] セクションで、ClientAppInterface という名前の共有ワーカーを探します。

  3. [検査] を選択して DevTools インスタンスを開きます。

  4. コンソールタブを選択し、ログダンプのコンテキストメニューを開き、名前を付けて保存... を選択してログダンプをローカルファイルに保存します。

Firefox

  1. Firefox ブラウザを開きます。URL タイプ about:debugging#workers の場合。

  2. [共有ワーカー] セクションで、/connect/ccp-naws/static/client-app-interface.js を [検査] を選択します。

  3. コンソールタブのコンテキストメニューを開き、すべてのメッセージを保存を選択してログダンプをローカルファイルに保存します。

Edge (Chromium)

  1. Chrome ブラウザを開きます。URL タイプ edge://inspect/#workers の場合。

  2. [共有ワーカー] セクションで、ClientAppInterface という名前の共有ワーカーを探します。

  3. [検査] を選択して DevTools インスタンスを開きます。

  4. コンソールタブを選択し、ログダンプのコンテキストメニューを開き、名前を付けて保存... を選択してログダンプをローカルファイルに保存します。

ルールベースの秘匿化のトラブルシューティング

を使用する場合画面録画のルールベースの秘匿化、以下のセクションでは一般的な問題とその解決方法について説明します。

編集された記録がありません

秘匿化された記録は、問い合わせが終了し、秘匿化されていない記録が確定された後に生成されます。特に Contact Lens 通話録音の秘匿化も有効になっている場合、秘匿化されていないバージョンが表示されるまでに時間がかかることがあります。秘匿化された音声は、秘匿化されたビデオがステッチされる前に使用できる必要があるためです。欠落として扱う前に、余分な時間を確保してください。

編集した録音が妥当な待機時間経過後も表示されない場合は、以下を確認してください。

  • 問い合わせレコードを確認して、問い合わせの画面録画が有効になっていることを確認します。

  • 問い合わせフローが、問い合わせがエージェントにルーティングされる前にルールベースの秘匿化を有効にして、記録、分析、処理動作の設定ブロックを呼び出したことを確認します。手順については、「ルールベースの秘匿化を設定する」を参照してください。

  • 問い合わせ中に Connect Customer ブラウザ拡張機能がインストールされ、エージェントのブラウザで有効になっていることを確認します。「ブラウザ拡張機能をデプロイする」を参照してください。

  • エージェントワークステーションの Connect Customer クライアントアプリケーションがバージョン 3.0.2 以降であることを確認します。

編集された録音に音声がない

問い合わせに対してルールベースの秘匿化が有効になっている場合、Connect Customer は、Contact Lens 通話録音秘匿化が問い合わせに対しても有効になっている場合にのみ、秘匿化されたビデオを秘匿化された通話録音にステッチします。Contact Lens 通話録音の編集が有効になっていない場合、編集された録音は音声なしで生成されます。これにより、秘匿化されたビデオと一緒に元のオーディオが公開されるのを防ぎ、設計上です。

  • 秘匿化済み音声を含む秘匿化済み録音を生成するには、ルールベースの画面秘匿化に加えて、問い合わせの Contact Lens 通話録音秘匿化を有効にします。「Contact Lens で機密データ秘匿化を使用する」を参照してください。

  • ユーザーが元の音声を確認する必要がある場合は、画面録画 (編集済み) - アクセス許可を削除し、画面録画 - アクセス許可を付与して、編集されていない録音を再生できるようにします。これにより、元の音声が保持されます。

編集オーバーレイが間違った位置に表示されます

  • エージェントの Connect Customer クライアントアプリケーションがバージョン 3.0.2 以降であることを確認します。以前のバージョンでは、マルチモニター DPI スケーリングに関する既知の問題があります。

  • Connect Customer ブラウザ拡張機能がバージョン 2.1.0 以降であることを確認します。

  • 特定のワークステーションで問題が解決しない場合は、 Connect Customer クライアントアプリケーションログ収集ツールを使用して診断ログを収集し、AWS サポートケースを開きます。

エージェントのワークステーションに Connect Customer ブラウザ拡張機能がない

拡張機能はエンタープライズブラウザポリシーを通じてユーザースコープにデプロイされるため、これは通常、エージェントがターゲットユーザーグループにないか、ポリシーがワークステーションにまだ適用されていないことを示します。

  • エンタープライズ拡張ポリシーがターゲットとするセキュリティグループまたは Entra ID グループにエージェントが含まれていることを確認します。詳細については、「ブラウザ拡張機能をデプロイする」を参照してください。

  • エージェントのワークステーションで、chrome://extensionsedge://extensions、または を開き、拡張機能が存在し、有効になっているabout:addonsかどうかを確認します。

  • ポリシーが最近適用された場合は、ポリシーの更新で新しい拡張機能が取得されるように、ブラウザを再起動するようにエージェントに依頼します。

  • Chrome と Edge の場合、 chrome://policyまたは を開き、ExtensionSettings にステータスが OK の Connect Customer 拡張機能 ID が含まれているedge://policyことを確認することもできます。

承認されたユーザーは、秘匿化された記録を表示できない

  • ユーザーのセキュリティプロファイルに画面録画 (秘匿化) - アクセス許可が含まれていることを確認します。編集済み録画もダウンロードする必要がある場合は、プロファイルに画面録画 (編集済み) - ダウンロードを有効にするボタンが含まれていることを確認します。詳細については、「編集済み録画のアクセス許可」を参照してください。

  • 問い合わせの問い合わせフローがルールベースの秘匿化を有効にしていることを確認します。秘匿化ルールなしで記録された問い合わせは、秘匿化されたファイルを生成しません。

編集された録画には、編集されていないコンテンツが表示されます。

  • Connect Customer ブラウザ拡張機能がインストールされ、問い合わせ中に有効になっていることを確認します。拡張機能がアンインストールまたは無効化されている場合、 Connect Customer クライアントアプリケーションは編集せずに記録します。

  • エージェントワークステーションの Connect Customer クライアントアプリケーションがバージョン 3.0.2 以降であることを確認します。

ブラウザのローカルネットワークアクセス (LNA) の制限など、エージェントの画面録画に関する一般的なトラブルシューティングについては、「」を参照してください画面録画のトラブルシューティング