setAuthTokenProvider

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 .

Mengesetkan pembekal token pengesahan.

Fungsi pembekal token pengesahan, apabila dipanggil dengan fungsi panggilan balik sebagai parameter, memanggil fungsi panggilan balik dengan rentetan JSON Web Token (JWT) yang sah sebagai hujah.
Kaedah ini menimbulkan ralat jika nilai authTokenProvider parameter bukan fungsi.

Penting

  • Dalam muatan token JWT, nilai yang disediakan untuk lwicontexts kunci hendaklah konteks tersuai bersiri.
  • Konteks tersuai ialah koleksi pasangan kunci/nilai. Hanya nilai primitif dibenarkan untuk mana-mana kunci.
  • Kekunci konteks tersuai mesti sepadan dengan pembolehubah konteks yang dicipta untuk strim kerja yang berkaitan dalam Multichannel untuk Customer Service.
  • Pembekal token pengesahan akan digunakan oleh widget sembang langsung apabila memulakan sembang baharu.

Nota

Kaedah SDK sembang langsung hendaklah digunakan selepas acara lcw:ready dibangkitkan. Anda boleh mendengar acara ini dengan menambah pendengar acara anda sendiri pada objek tetingkap.

SDK ini hanya boleh digunakan jika pengesahan didayakan untuk widget. Untuk mendayakan pengesahan widget anda, lihat Cipta seting pengesahan sembang.

Sintaks

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

Parameter

Parameter_ Taip Perihalan
authTokenProvider Fungsi Fungsi yang apabila dipanggil dengan fungsi panggilan balik sebagai argumen, mengambil token JWT dan memanggil fungsi panggilan balik dengan token JWT sebagai argumennya

Nilai pulangan

Tiada

Contoh

Sampel muatan token

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

Nota

Dalam muatan di atas, nilai yang sepadan dengan lwicontexts kunci hendaklah konteks tersuai bersiri. Kekunci msdyn_cartvalue dan msdyn_isvip dalam konteks tersuai bersiri sepadan dengan pembolehubah konteks yang dicipta untuk strim kerja yang berkaitan dalam Multisaluran untuk Perkhidmatan Pelanggan.

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

Kod ralat

Ralat berikut boleh berlaku dengan kaedah ini.

Kod ralat Mesej ralat
2 Pelaksanaan kaedah pembekal token pengesahan gagal
3 Pembekal token pengesahan tidak menyediakan sebarang token
4 Pembekal token pengesahan menyediakan token tidak sah

Rujukan API JavaScript untuk SDK sembang langsung

  • Last updated on