Amazon Connect CCPを使用してエージェントを閉じると、エージェントを自動的にログアウトする CCPv1

重要

このトピックは、 を使用するお客様にのみ適用されますCCPv1。for は /ccp# でURLCCPv1終了します。

デフォルトの Amazon Connect を使用する場合CCPv1、CCPウィンドウを閉じてもログアウトしても、エージェントのステータスは利用可能からオフライン に自動的に変更されません。エージェントは、手動でステータスを [Offline] に変更した上で、ログアウトする必要があります。

この動作を変更するために、次のいずれかを行うことができます。

• を使用しますCCPv2。エージェントがログアウトすると、ステータスは自動的に [Offline] (オフライン) に切り替わります。ただし、ウィンドウを閉じるだけでは、 CCPv2はエージェントをオフラインに自動的に切り替えません。にアップグレードする手順についてはCCPv2、「」を参照してください/ccp# でCCPURL終了したら、問い合わせコントロールパネル (CCP) をアップグレードします。

• を使用するCreateAgentStatusAPI: エージェントの状態をオフラインに変更できます。

• カスタム を作成しますCCP。Amazon Connect Streams APIと エージェントAPIを参照してください。

• このトピックの次のステップを使用して、エージェントをオフラインに切り替え、CCPウィンドウを閉じるとエージェントを自動的にログアウトCCPするように を更新します。

ステップ 1: ストリームを設定する API

手順については、Amazon Connect Streams のドキュメントを参照してください。

ステップ 2: アプリケーションコードを更新してエージェントの状態を変更する

次の Streams APIコールをウェブアプリケーションに統合します。

1. connect.agent () を使用して、エージェントイベントをサブスクライブし、エージェントオブジェクトを取得します。

   let mAgent;
   
   connect.agent(function(agent) {
     mAgent = agent;
   });    

2. onbeforeunload イベントハンドラーで agent.setState() を呼び出して、エージェントの状態を変更します。beforeunload 関数の実行後、エージェントはオフラインとしてマークされます。

   beforeunload フックの使用が最適なオプションですが、安定して動作するわけではないことに注意してください。

   window.addEventListener("beforeunload", function(event) {
       if (mAgent != null) {
           let states = mAgent.getAgentStates();
           // "states" is an array of changeable states. You can filter the desired state to change by name.
           let offlineState = states.filter(state => state.name === "Offline")[0];
                         
           // Change agent state
           mAgent.setState(offlineState, {
           success: function() {
               console.log("SetState succeeded");
           },
           failure: function() {
           console.log("SetState failed");
           }
       });
     }
   });      

ステップ 3: エラーに備えて設計する

API コールが初めて実行されず、問い合わせがフローのエラーブランチを取得すると、エージェントの状態が期待どおりに変化しない可能性があります。この可能性に対応するためのロジックを必ず含めてください。例えば、API呼び出しが再試行される間、ページのアンロードを遅らせることができます。または、ページのアンロード前に、モーダルダイアログで「呼び出しに失敗しました」という警告メッセージを表示できます。