getAgentAvailability

Customer Service için Çok Yönlü Kanal, kuruluşların, dijital mesajlaşma kanallarında anında bağlanıp müşterileriyle etkileşim kurmalarını sağlamak için Dynamics 365 Customer Service Enterprise'ın gücünü genişleten bir özellikler paketi sunar. Customer Service için Çok Yönlü Kanal'a erişmek için ek bir lisans gerekir. Daha fazla bilgi için Dynamics 365 Customer Service fiyatlandırmasına genel bakış ve Dynamics 365 Customer Service fiyatlandırma planı sayfalarına bakın.

Yönlendirme kurallarına göre bir kuyruk için aracı kullanılabilirliğini alır. Çok yönlü kanal geliştiricisi, konuşmayı başlat seçeneğinin müşteri tarafından görülüp görülmeyeceğini belirlemek ve ayrıca bekleme süresi ve kuyruklardaki konum gibi bilgileri görüntülemek için bu API'yi kullanabilir.

Uyarı

  • Canlı sohbet SDK yöntemlerini çağırmadan önce canlı sohbet tarafından oluşturulan lcw:ready olayını dinleyin. Canlı sohbet yöntemleri, lcw:ready olayı tetiklendikten sonra çağrılabilir. Pencere nesnesine kendi olay dinleyicinizi ekleyerek bu olayı dinleyebilirsiniz.
  • Bu yöntem, müşteri girişi değiştiğinde istemci tarafından birden çok kez çağrılabilir. İstemci tarafı önbelleği her 2 dakikada bir veya müşteri bağlam parametreleri değiştiğinde yenilenir.
  • Bu yöntem yalnızca kuruluş başına dakikada 100 kez çağrılabilir. Sınırı aşarsanız, belirtilen süre içinde çok fazla istek gönderdiğinizi belirten http 429 yanıt durum kodunu görürsünüz.

Sözdizimi

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

Parametreler

Hiç kimse

Dönüş değeri

İsim Türü Description
queueId String Yönlendirme kuralı yapılandırmasına ve giriş verilerine göre isteğin yönlendirildiği hedef kuyruk (yönlendirme kuralının bir parçası olan varlık ve bağlamın değeri sağlanır).
isQueueAvailable Boolean Görüntü -ler:
- Kuyruk çalışma saatleri içindeyse DOĞRU.
- Kuyruk çalışma saatleri dışındaysa YANLIŞ.
StartTimeOfNextOperatingHour DateTime Kuyruk çalışma saatlerinin dışındaysa, çalışma saatlerinin başlangıç saati (UTC). Çalışma saatleri içinde 01-01-0001 değeri döndürülür.
EndTimeOfNextOperatingHour DateTime Kuyruk çalışma saatlerinin dışındaysa, kuyruk için çalışma saatlerinin sona erdiği saat (UTC). Çalışma saatleri içinde 01-01-0001 değeri döndürülür.
nexttransitiontime DateTime Kuyruğun çalışma saatleri dışındaysa kuyruğun yeniden çalışır durumda olduğu saat (UTC). Kuyruğun çalışır durumda olmadığı zaman, çalışma saatleri içinde görüntülenir.
positionInQueue Sayı Aynı kuyruktaki diğer müşterilerin arkasında bekleyen bir müşteri için kuyruktaki konum.
isAgentAvailable Boolean Görüntü -ler:
- Kuyruktaki aracılar şu anda iş akışı için yapılandırılan yönlendirme ve atama kurallarına göre istekleri almak için kullanılabiliyorsa TRUE. API, iş akışına veya kuyruğa bir bot eklenmişse de true değerini döndürür. Bir bot varken bu API'nin kullanılmamasını öneririz.
- Temsilciler istekleri almak için uygun değilse YANLIŞ.
averageWaitTime Sayı Son 48 saatlik verilere göre hedef kuyruktaki müşteriler için dakika cinsinden ortalama bekleme süresi.

Example

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

Bağlamın alındığından emin olmak için işlev için özel bağlam değerlerini geçirin

Bu yöntem, setContextProvider işlevine bir iç çağrı gerçekleştirir ve devam etmeden önce bağlamın ayarlandığından emin olmak için getAgentAvailability'yi zaman uyumlu olarak çağırır. İşlevlerin ayrı ayrı kullanıldıklarında zaman uyumsuz doğası nedeniyle, danışma aracısı kullanılabilir olduğunda bağlam hazır olmayabilir.

Uyarı

getAgentAvailability'yi çağırmadan önce setContextProvider yöntemini çağırmanız gerekmez.

Yöntemin setContextProvider nasıl kullanılacağını gösteren örnek bir kod aşağıda verilmiştir.

// 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}

        }

    }

    );

Sohbete başla
setContextProvider
Canlı sohbet SDK başvurusu

  • Son güncelleştirme: