getAgentAvailability

Multisaluran untuk Customer Service menawarkan serangkaian kemampuan yang memperluas kekuatan Dynamics 365 Customer Service Enterprise untuk memungkinkan organisasi terhubung dan berinteraksi secara instan dengan pelanggan mereka di seluruh saluran olahpesan digital. Lisensi tambahan diperlukan untuk mengakses Multisaluran untuk Customer Service. Untuk informasi selengkapnya, lihat Ikhtisar harga Dynamics 365 Customer Service dan halaman Paket harga Dynamics 365 Customer Service.

Mengambil ketersediaan agen untuk antrean berdasarkan aturan perutean. Pengembang omnichannel dapat menggunakan API ini untuk menentukan apakah opsi mulai percakapan harus terlihat oleh pelanggan dan juga untuk menampilkan informasi seperti waktu tunggu dan posisi dalam antrean.

Nota

  • Dengarkan peristiwa lcw:ready yang diangkat oleh obrolan langsung sebelum memanggil metode SDK obrolan langsung. Metode obrolan langsung dapat dipanggil setelah peristiwa lcw:ready diangkat. Anda dapat mendengarkan peristiwa ini dengan menambahkan pemroses peristiwa Anda sendiri pada objek jendela.
  • Metode ini dapat dipanggil beberapa kali dari sisi klien saat input pelanggan berubah. Cache sisi klien disegarkan setiap 2 menit atau saat parameter konteks pelanggan berubah.
  • Metode ini hanya dapat dipanggil 100 kali per menit per organisasi. Jika Anda melebihi batas, Anda melihat kode status respons http 429 yang menunjukkan bahwa Anda mengirim terlalu banyak permintaan dalam jangka waktu tertentu.

Syntax

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

Parameter-parameternya

None

Mengembalikan nilai

Nama Tipe Description
queueId String Antrean target tempat permintaan dirutekan berdasarkan konfigurasi aturan perutean dan data input (nilai entitas dan konteks yang merupakan bagian dari aturan perutean disediakan).
isQueueAvailable Boolean Menampilkan:
- TRUE jika antrean dalam jam operasional.
- FALSE jika antrian berada di luar jam operasional.
StartTimeOfNextOperatingHour DateTime Waktu mulai (UTC) jam operasional untuk antrean jika berada di luar jam operasional. Selama jam operasional, nilai 01-01-0001 dikembalikan.
EndTimeOfNextOperatingHour DateTime Waktu (UTC) saat jam operasional berakhir untuk antrean jika berada di luar jam operasional. Selama jam operasional, nilai 01-01-0001 dikembalikan.
nexttransitiontime DateTime Waktu (UTC) saat antrian beroperasi kembali jika berada di luar jam operasional. Waktu saat antrean tidak beroperasi ditampilkan selama jam operasional.
positionInQueue Number Posisi dalam antrean untuk pelanggan yang menunggu di belakang pelanggan lain dalam antrean yang sama.
isAgentAvailable Boolean Menampilkan:
- TRUE jika agen dalam antrean saat ini tersedia untuk menerima permintaan berdasarkan aturan perutean dan penetapan yang dikonfigurasi untuk aliran kerja. API juga mengembalikan true jika bot dilampirkan ke aliran kerja atau antrean. Kami menyarankan agar API ini tidak digunakan saat bot ada.
- FALSE jika agen tidak tersedia untuk menerima permintaan.
averageWaitTime Number Waktu tunggu rata-rata dalam hitungan menit untuk pelanggan dalam antrean target berdasarkan data 48 jam terakhir.

Example

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

Meneruskan nilai konteks kustom untuk fungsi untuk memastikan konteks diterima

Metode ini melakukan panggilan internal ke fungsi setContextProvider dan kemudian memanggil getAgentAvailability secara sinkron, untuk memastikan bahwa konteks diatur sebelum melanjutkan. Karena sifat fungsi yang asinkron saat digunakan secara terpisah, konteks mungkin tidak siap saat agen konsultan tersedia.

Nota

Anda tidak perlu memanggil metode setContextProvider sebelum memanggil getAgentAvailability.

Berikut adalah contoh kode yang menunjukkan cara menggunakan metode 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}

        }

    }

    );

mulai obrolan
setContextProvider
Referensi SDK obrolan langsung

  • Last updated on