مشاركة عبر


setAuthTokenProvider

تعرض القناة متعددة الاتجاهات لـ Customer Service مجموعة من الإمكانات التي توسع قدرة Dynamics 365 Customer Service Enterprise لتمكين المؤسسات من الاتصال والتفاعل مع عملائها على الفور عبر قنوات المراسلة الرقمية. مطلوب ترخيص إضافي للوصول إلى القناة متعددة الاتجاهات لـ Customer Service. لمزيد من المعلومات، راجع نظرة عامة على تسعير Dynamics 365 Customer Service وصفحات خطة تسعير Dynamics 365 Customer Service.

لتعيين موفر الرمز المميز للمصادقة.

تستدعي وظيفة موفر الرمز المميز للمصادقة، عند استدعاؤها باستخدام دالة معاودة الاتصال كمعلمة، وظيفة معاودة الاتصال بسلسلة JSON Web Token (JWT) صالحة كوسيطة.
تثير هذه الطريقة خطأ إذا لم تكن قيمة authTokenProvider المعلمة دالة.

هام

  • في حمولة الرمز المميز JWT، يجب أن تكون القيمة المقدمة للمفتاح lwicontexts هي السياق المخصص المتسلسل.
  • السياق المخصص عبارة عن مجموعة من أزواج المفاتيح/القيم. يسمح فقط بالقيم الأولية لأي مفتاح.
  • يجب أن تتوافق مفاتيح السياق المخصص مع متغيرات السياق التي تم إنشاؤها لدفق العمل المقترن في القناة متعددة الاتجاهات ل Customer Service.
  • سيتم استدعاء موفر الرمز المميز للمصادقة بواسطة أداة الدردشة المباشرة عند بدء محادثة جديدة.

‏‫ملاحظة

يجب استدعاء أساليب SDK للدردشة المباشرة بعد رفع الحدث lcw:ready . يمكنك الاستماع إلى هذا الحدث عن طريق إضافة مستمع الحدث الخاص بك على كائن النافذة.

لا تنطبق SDK هذه إلا إذا تم تمكين المصادقة لعنصر واجهة المستخدم. لتمكين المصادقة على عنصر واجهة المستخدم، راجع إنشاء إعدادات مصادقة الدردشة.

إعراب

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

Parameters

المعلمة‬ النوع الوصف
authTokenProvider الدالة الدالة التي عند استدعاؤها باستخدام دالة معاودة الاتصال كوسيطة، تجلب رمز JWT المميز وتستدعي وظيفة معاودة الاتصال باستخدام رمز JWT المميز كوسيطة لها

قيمة الإرجاع

None

Example

عينة حمولة الرمز المميز

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

‏‫ملاحظة

في الحمولة أعلاه، يجب أن تكون القيمة المقابلة للمفتاح lwicontexts هي السياق المخصص المتسلسل. تتوافق المفاتيح msdyn_cartvalue وفي msdyn_isvip السياق المخصص المتسلسل مع متغيرات السياق التي تم إنشاؤها لدفق العمل المقترن في القناة متعددة الاتجاهات ل Customer Service.

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

رموز الخطأ

يمكن أن تحدث الأخطاء التالية بهذه الطريقة.

رمز الخطأ رسالة خطأ
2 فشل تنفيذ أسلوب موفر رمز المصادقة
3 لم يقدم موفر رمز المصادقة أي رمز مميز
4 قدم موفر رمز المصادقة رمزا مميزا غير صالح

مرجع واجهة برمجة تطبيقات JavaScript لحزمة تطوير البرامج (SDK) للدردشة المباشرة