CCPv1: Melden Sie Agenten automatisch ab, wenn sie ihr CCP schließen

Wichtig

Dieses Thema gilt nur für Kunden, die CCPv1 verwenden. Die URL für ccPv1 endet mit /ccp #.

Wenn Sie das standardmäßige Amazon Connect CCPv1 verwenden, ändert das Schließen des CCP-Fensters oder das Abmelden nicht automatisch den Status eines Agenten von Verfügbar in Offline. Ein Agent muss seinen Status manuell auf Offline ändern und sich dann abmelden.

Um dieses Verhalten zu ändern, können Sie einen der folgenden Schritte ausführen:

• Verwenden Sie CCPv2. Wenn sich Agenten abmelden, wird ihr Status automatisch auf Offline umgestellt. Beachten Sie jedoch, dass CCPv2 Agenten nicht automatisch in den Offline-Modus versetzt, wenn sie nur das Fenster schließen. Anweisungen zum Upgrade auf CCPv2 finden Sie unter. Meine CCP-URL endet mit /ccp#

• Verwenden Sie die CreateAgentStatusAPI: Sie können den Status des Agenten auf Offline ändern.

• Erstellen Sie ein benutzerdefiniertes CCP. Siehe Amazon Connect Streams-API und Agenten-API

• Verwenden Sie die folgenden Schritte in diesem Thema, um Ihr CCP so zu aktualisieren, dass es Agenten auf Offline umschaltet und Agenten automatisch abmeldet, wenn sie das CCP-Fenster schließen.

Schritt 1: Einrichten der Streams-API

Anweisungen finden Sie in der Amazon Connect Streams-Dokumentation.

Schritt 2: Aktualisieren Ihres Anwendungscodes, um den Agentenstatus zu ändern

Integrieren Sie die folgenden Streams-API-Aufrufe in Ihre Webanwendung:

1. Verwenden Sie connect.agent(), um Agentenereignisse zu abonnieren und Agentenobjekte abzurufen.

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

2. Rufen Sie agent.setState() in der onbeforeunload-Ereignisbehandlungsroutine auf, um den Agentenstatus zu ändern. Der Agent wird nach der Ausführung der beforeunload Funktion als Offline markiert.

   Die Verwendung des beforeunload Hooks ist die beste Option, aber beachten Sie, dass er nicht konsistent funktioniert.

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

Schritt 3: Entwurf für Fehler

Wenn ein API-Aufruf beim ersten Mal nicht ausgeführt werden kann und ein Kontakt den Fehlerzweig Ihres Flows übernimmt, besteht die Möglichkeit, dass sich der Status eines Agenten nicht wie erwartet ändert. Gehen Sie logisch vor, um diese Möglichkeit zu berücksichtigen. Beispielsweise können Sie das Entladen der Seite verzögern, während der API-Aufruf erneut versucht wird. Sie können vor dem Entladen der Seite auch eine Warnmeldung „Anruf fehlgeschlagen“ in einem modalen Dialogfeld einfügen.