getAgentKetersediaan

Saluran Omni untuk Customer Service menawarkan rangkaian keupayaan yang melanjutkan kuasa Dynamics 365 Customer Service Enterprise untuk mendayakan organisasi berhubung dengan segera dan terlibat dengan pelanggan mereka melalui saluran pemesejan digital. Lesen tambahan diperlukan untuk mengakses Saluran Omni untuk Customer Service. Untuk mendapatkan maklumat lanjut, lihat gambaran keseluruhan harga Dynamics 365 Customer Service dan halaman pelan harga Dynamics 365 Customer Service .

Mendapatkan semula ketersediaan ejen untuk baris gilir berdasarkan peraturan penghalaan. Pembangun omnichannel boleh menggunakan API ini untuk menentukan sama ada pilihan mulakan perbualan harus kelihatan kepada pelanggan dan juga untuk memaparkan maklumat seperti masa menunggu dan kedudukan dalam baris gilir.

Nota

  • Dengarkan acara lcw:ready yang dibangkitkan oleh sembang langsung sebelum memanggil kaedah SDK sembang langsung. Kaedah sembang langsung boleh digunakan selepas acara lcw:ready dibangkitkan. Anda boleh mendengar acara ini dengan menambah pendengar acara anda sendiri pada objek tetingkap.
  • Kaedah ini boleh dipanggil beberapa kali dari bahagian pelanggan apabila input pelanggan berubah. Cache bahagian pelanggan dimuat semula setiap 2 minit atau apabila parameter konteks pelanggan berubah.
  • Kaedah ini boleh dipanggil 100 kali seminit bagi setiap organisasi sahaja. Jika anda melebihi had, anda melihat kod status respons http 429 yang menunjukkan bahawa anda menghantar terlalu banyak permintaan dalam tempoh masa yang ditentukan.

Sintaks

Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();

Parameter

Tiada

Nilai pulangan

Nama Jenis Perihalan
queueId Rentetan Baris gilir sasaran di mana permintaan dihalakan berdasarkan konfigurasi peraturan penghalaan dan data input (nilai entiti dan konteks yang merupakan sebahagian daripada peraturan penghalaan disediakan).
isQueueAvailable Boolean Memaparkan:
- BENAR jika barisan berada dalam waktu operasi.
- SALAH jika barisan berada di luar waktu operasi.
StartTimeOfNextOperatingHour TarikhMasa Masa mula (UTC) waktu operasi untuk baris gilir jika ia berada di luar waktu operasi. Semasa waktu operasi, nilai 01-01-0001 dikembalikan.
EndTimeOfNextOperatingHour TarikhMasa Masa (UTC) apabila waktu operasi tamat untuk baris gilir jika ia berada di luar waktu operasi. Semasa waktu operasi, nilai 01-01-0001 dikembalikan.
nexttransitiontime TarikhMasa Masa (UTC) apabila baris gilir beroperasi semula jika ia berada di luar waktu operasi. Masa apabila baris gilir tidak beroperasi dipaparkan semasa waktu operasi.
positionInQueue Nombor Kedudukan dalam barisan untuk pelanggan yang menunggu di belakang pelanggan lain dalam barisan yang sama.
isAgentAvailable Boolean Memaparkan:
- BENAR jika ejen dalam baris gilir pada masa ini tersedia untuk mengambil permintaan berdasarkan peraturan penghalaan dan tugasan yang dikonfigurasikan untuk aliran kerja. API juga mengembalikan benar jika bot dilampirkan pada aliran kerja atau baris gilir. Kami mengesyorkan agar API ini tidak digunakan apabila bot hadir.
- PALSU jika ejen tidak tersedia untuk menerima permintaan.
averageWaitTime Nombor Purata masa menunggu dalam beberapa minit untuk pelanggan dalam baris gilir sasaran berdasarkan data 48 jam yang lalu.

Example

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
               // Gets the agent availability
               Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();
});

Hantar nilai konteks tersuai untuk fungsi untuk memastikan konteks diterima

Kaedah ini melakukan panggilan dalaman kepada fungsi setContextProvider dan kemudian memanggil getAgentAvailability secara serentak untuk memastikan konteks ditetapkan sebelum meneruskan. Oleh kerana sifat fungsi yang tidak selayak apabila ia digunakan secara berasingan, konteks mungkin tidak bersedia apabila ejen perunding tersedia.

Nota

Anda tidak perlu memanggil kaedah setContextProvider sebelum memanggil getAgentAvailability.

Berikut ialah kod sampel yang menunjukkan cara menggunakan kaedah tersebut setContextProvider .

// To set the custom context, pass the custom context object as input parameter to agent availability

    // provider as part of the logic, so there is no need to set custom context before this call.

    Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability({

        customContext : {

                'jwtToken': {'value':'token','isDisplayable':true},

                'Email': {'value':'mae.gibbins@contoso.com','isDisplayable':true},

                'client': {'value':'true','isDisplayable':true},

                'Emailing': {'value':'true','isDisplayable':true}

        }

    }

    );

mulaSembang
setContextProvider
Rujukan SDK sembang langsung

  • Last updated on