CCPv1: disconnessione automatica degli agenti quando chiudono il CCP

Importante

Questo argomento si applica solo ai clienti che utilizzano CCPv1. L'URL per CCPv1 termina con /ccp#.

Quando si utilizza il CCPv1 predefinito di Amazon Connect, la chiusura della finestra CCP o la disconnessione non modifica lo stato di un agente da Disponibile a Offline. Un agente deve impostare manualmente il proprio stato su Offline e quindi disconnettersi.

Per modificare questo comportamento, puoi procedere in uno dei seguenti modi:

• Usare CCPv2. Quando gli agenti si disconnettono, il loro stato passa automaticamente a Offline. Tuttavia, tieni presente che CCPv2 non imposta automaticamente lo stato degli agenti su Offline se chiudono solo la finestra. Per istruzioni sull'aggiornamento a CCPv2, consulta L'URL del mio CCP termina con /ccp#.

• Utilizza l'API CreateAgentStatus: puoi modificare lo stato dell'agente su Offline.

• Crea un CCP personalizzato. Consulta la documentazione relativa all'API Streams di Amazon Connect e all'API Agent.

• Segui la procedura riportata in questo argomento per aggiornare il CCP in modo che imposti lo stato degli agenti su Offline e li disconnetta automaticamente quando chiudono la finestra CCP.

Passaggio 1: impostare l'API dei flussi

Per le istruzioni, consulta la documentazione sui flussi di Amazon Connect.

Fase 2: aggiornare il codice dell'applicazione per modificare lo stato dell'agente

Integrare le seguenti chiamate API dei flussi nell'applicazione web:

1. Utilizzare connect.agent () per sottoscrivere gli eventi agent e recuperare gli oggetti agent.

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

2. Chiamare Agent.setState () nel gestore di eventi onbeforeunload per modificare lo stato dell'agente. L'agente viene contrassegnato come Offline dopo l'esecuzione della funzione beforeunload.

   L'uso dell'hook beforeunload è l'opzione migliore, ma tieni presente che non funziona in modo coerente.

   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");
           }
       });
     }
   });      

Fase 3: progettare considerando gli errori

Se l'esecuzione di una chiamata API ha esito negativo la prima volta e un contatto prende il ramo di errore del flusso, è possibile che lo stato di un agente non cambi come previsto. Assicurati di includere la logica per tenere conto di questa possibilità. Ad esempio, puoi ritardare lo scaricamento della pagina mentre viene riprovato la chiamata API. In alternativa, puoi inserire un messaggio di avviso come “Chiamata non riuscita” in una finestra di dialogo modale prima dello scaricamento della pagina.