CCPv1: Logout agen secara otomatis ketika mereka menutup PKT mereka

penting

Topik ini hanya berlaku untuk pelanggan yang menggunakan CCPv1. URL untuk CCPv1 diakhiri dengan/ccp #.

Saat menggunakan Amazon Connect CCPv1 default, menutup jendela CCP atau keluar tidak secara otomatis mengubah status agen dari Tersedia menjadi Offline. Agen harus mengubah statusnya secara manual ke Offline dan kemudian keluar.

Untuk mengubah perilaku ini, Anda dapat melakukan salah satu hal berikut:

• Gunakan CCPv2. Ketika agen keluar, status mereka secara otomatis beralih ke Offline. Namun, perhatikan bahwa CCPv2 tidak secara otomatis mengalihkan agen ke Offline jika mereka hanya menutup jendela. Untuk petunjuk tentang upgrade ke CCPV2, lihat. URL CCP saya diakhiri dengan/ccp #

• Gunakan CreateAgentStatusAPI: Anda dapat mengubah status agen ke Offline.

• Buat CCP kustom. Lihat Amazon Connect Streams API dan Agent API

• Gunakan langkah-langkah berikut dalam topik ini untuk memperbarui PKC Anda sehingga mengalihkan agen ke Offline dan mengeluarkan agen secara otomatis ketika mereka menutup jendela CCP.

Langkah 1: Siapkan API Streams

Untuk petunjuk, lihat Dokumentasi Amazon Connect Streams.

Langkah 2: Perbarui kode aplikasi Anda untuk mengubah status agen

Integrasikan panggilan API Streams berikut ke dalam aplikasi web Anda:

1. Gunakan connect.agent () untuk berlangganan acara agen dan mengambil objek agen.

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

2. Panggil agent.setState () di event handler onbeforeunload untuk mengubah status agen. Agen ditandai Offline setelah menjalankan beforeunload fungsi.

   Menggunakan beforeunload hook adalah pilihan terbaik, tetapi perhatikan bahwa itu tidak bekerja secara konsisten.

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

Langkah 3: Desain untuk kesalahan

Jika panggilan API gagal dijalankan pertama kali dan kontak mengambil cabang kesalahan alur Anda, ada kemungkinan status agen tidak akan berubah seperti yang diharapkan. Pastikan untuk memasukkan logika untuk memperhitungkan kemungkinan ini. Misalnya, Anda dapat menunda pembongkaran halaman saat panggilan API dicoba lagi. Atau, Anda bisa memunculkan pesan peringatan “Panggilan gagal” dalam dialog modal sebelum halaman dibongkar.