Aracılığıyla paylaş


setAuthTokenProvider

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.

Kimlik doğrulama belirteci sağlayıcısını ayarlar.

Kimlik doğrulama belirteci sağlayıcı işlevi, parametre olarak bir geri çağırma işleviyle çağrıldığında, bağımsız değişken olarak geçerli bir JSON Web Belirteci (JWT) dizesiyle geri çağırma işlevini çağırır.
Bu yöntem, parametrenin authTokenProvider değeri bir işlev değilse bir hata oluşturur.

Önemli

  • JWT belirtecinin yükünde, anahtar için lwicontexts sağlanan değer serileştirilmiş özel bağlam olmalıdır.
  • Özel bağlam, anahtar/değer çiftlerinden oluşan bir koleksiyondur. Herhangi bir anahtar için yalnızca temel değerlere izin verilir.
  • Özel bağlam anahtarları, Customer Service için Çok Yönlü Kanal'da ilişkili iş akışı için oluşturulan bağlam değişkenlerine karşılık gelmelidir.
  • Kimlik doğrulama belirteci sağlayıcısı, yeni bir sohbet başlatılırken canlı sohbet widget'ı tarafından çağrılır.

Uyarı

Canlı sohbet SDK yöntemleri, lcw:ready olayı tetiklendikten sonra çağrılmalıdır. Pencere nesnesine kendi olay dinleyicinizi ekleyerek bu olayı dinleyebilirsiniz.

Bu SDK, yalnızca widget için kimlik doğrulama etkinleştirilmişse geçerlidir. Widget'ınız için kimlik doğrulamayı etkinleştirmek üzere Sohbet kimlik doğrulama ayarları oluşturma bölümüne bakın.

Sözdizimi

Microsoft.Omnichannel.LiveChatWidget.SDK.setAuthTokenProvider(authTokenProvider);

Parametreler

Parametre Türü Description
authTokenProvider İşlev Bağımsız değişken olarak bir geri çağırma işleviyle çağrıldığında, JWT belirtecini getiren ve bağımsız değişkeni olarak JWT belirteci ile geri çağırma işlevini çağıran işlev

Dönüş değeri

Hiç kimse

Example

Örnek belirteç yükü

{
    "sub" : "87b4d06c-abc2-e811-a9b0-000d3a10e09e",
    "lwicontexts" :"{\"msdyn_cartvalue\":\"10000\", \"msdyn_isvip\":\"false\"}",
    "iat" : 1542622071,
    "iss" : "contosohelp.com",
    "exp" : 1542625672,
    "nbf" : 1542622072
}

Uyarı

Yukarıdaki yükte, anahtara lwicontexts karşılık gelen değer serileştirilmiş özel bağlam olmalıdır. Anahtarlar msdyn_cartvalue ve msdyn_isvip serileştirilmiş özel bağlamda, Customer Service için Çok Yönlü Kanal'da ilişkili iş akışı için oluşturulan bağlam değişkenlerine karşılık gelir.

let payloadToEncrypt = {
    "sub" : "87b4d06c-abc2-e811-a9b0-000d3a10e09e",
    "lwicontexts" :"{\"msdyn_cartvalue\":\"10000\", \"msdyn_isvip\":\"false\"}",
    "iat" : 1542622071,
    "iss" : "contosohelp.com",
    "exp" : 1542625672,
    "nbf" : 1542622072
};

function convertToJwtToken(payloadToEncrypt){
    // Ideally, you call your service to convert the payload to a valid JWT token
    return Promise.resolve("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI4N2I0ZDA2Yy1hYmMyLWU4MTEtYTliMC0wMDBkM2ExMGUwOWUiLCJsd2ljb250ZXh0cyI6IntcIm1zZHluX2NhcnR2YWx1ZVwiOlwiMTAwMDBcIiwgXCJtc2R5bl9pc3ZpcFwiOlwiZmFsc2VcIn0iLCJpYXQiOjE1NDI2MjIwNzEsImlzcyI6ImNvbnRvc29oZWxwLmNvbSIsImV4cCI6MTU0MjYyNTY3MiwibmJmIjoxNTQyNjIyMDcyfQ.r37z1M5rMyRYMOJ-rhyTRYFOgvl9N7KvTMueSFPkiuM");
}

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
// Sets the auth-token provider
// Throws error if authTokenProvider is not a function
    convertToJwtToken(payloadToEncrypt).then(function (jwtToken){
        Microsoft.Omnichannel.LiveChatWidget.SDK.setAuthTokenProvider(function authTokenProvider(callback){
            callback(jwtToken);
        });
    });
});

Hata kodları

Bu yöntemle aşağıdaki hatalar oluşabilir.

Hata kodu Hata mesajı
2 Kimlik doğrulama belirteci sağlayıcısı yöntemi yürütülemedi
3 Kimlik doğrulama belirteci sağlayıcısı herhangi bir belirteç sağlamadı
4 Kimlik doğrulama belirteci sağlayıcısı geçersiz belirteç sağladı

Canlı sohbet SDK'sı için JavaScript API referansı