إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تعرض القناة متعددة الاتجاهات لـ Customer Service مجموعة من الإمكانات التي توسع قدرة Dynamics 365 Customer Service Enterprise لتمكين المؤسسات من الاتصال والتفاعل مع عملائها على الفور عبر قنوات المراسلة الرقمية. مطلوب ترخيص إضافي للوصول إلى القناة متعددة الاتجاهات لـ Customer Service. لمزيد من المعلومات، راجع نظرة عامة على تسعير Dynamics 365 Customer Service وصفحات خطة تسعير Dynamics 365 Customer Service.
استرداد توفر العامل لقائمة انتظار استنادا إلى قواعد التوجيه. يمكن لمطور القناة متعددة الاتجاهات استخدام واجهة برمجة التطبيقات هذه لتحديد ما إذا كان خيار بدء المحادثة يجب أن يكون مرئيا للعميل وأيضا لعرض معلومات مثل وقت الانتظار والموضع في قوائم الانتظار.
ملاحظة
- استمع إلى حدث lcw:ready الذي تم طرحه بواسطة الدردشة المباشرة قبل استدعاء أساليب SDK للدردشة المباشرة. يمكن استدعاء أساليب الدردشة المباشرة بعد رفع الحدث lcw:ready . يمكنك الاستماع إلى هذا الحدث عن طريق إضافة مستمع الحدث الخاص بك على كائن النافذة.
- يمكن استدعاء هذه الطريقة عدة مرات من جانب العميل عندما يتغير إدخال العميل. يتم تحديث ذاكرة التخزين المؤقت من جانب العميل كل دقيقتين أو عند تغيير معلمات سياق العميل.
- يمكن استدعاء هذه الطريقة 100 مرة في الدقيقة لكل مؤسسة فقط. إذا تجاوزت الحد المسموح به، فسترى رمز حالة استجابة http 429 الذي يشير إلى أنك أرسلت عددا كبيرا جدا من الطلبات في فترة زمنية محددة.
إعراب
Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();
المعلمات
None
قيمة الإرجاع
| اسم | النوع | الوصف |
|---|---|---|
queueId |
سلسلة | قائمة الانتظار المستهدفة حيث يتم توجيه الطلب استنادا إلى تكوين قاعدة التوجيه وبيانات الإدخال (يتم توفير قيمة الكيان والسياق اللذين يشكلان جزءا من قاعدة التوجيه). |
isQueueAvailable |
قيمة منطقية | يعرض: - TRUE إذا كانت قائمة الانتظار ضمن ساعات العمل. - خطأ إذا كانت قائمة الانتظار خارج ساعات العمل. |
StartTimeOfNextOperatingHour |
التاريخ والوقت | وقت البدء (UTC) لساعات التشغيل لقائمة الانتظار إذا كانت خارج ساعات العمل. خلال ساعات العمل ، يتم إرجاع قيمة 01-01-0001. |
EndTimeOfNextOperatingHour |
التاريخ والوقت | الوقت (UTC) عند انتهاء ساعات العمل لقائمة الانتظار إذا كانت خارج ساعات العمل. خلال ساعات العمل ، يتم إرجاع قيمة 01-01-0001. |
nexttransitiontime |
التاريخ والوقت | الوقت (UTC) الذي يتم فيه تشغيل قائمة الانتظار مرة أخرى إذا كانت خارج ساعات العمل. يتم عرض الوقت الذي لا تكون فيه قائمة الانتظار قيد التشغيل أثناء ساعات العمل. |
positionInQueue |
الرقم | الموضع في قائمة الانتظار لعميل ينتظر خلف عملاء آخرين في نفس قائمة الانتظار. |
isAgentAvailable |
قيمة منطقية | يعرض: - صحيح إذا كان الوكلاء في قائمة الانتظار متاحين حاليا لتلقي الطلبات استنادا إلى قواعد التوجيه والتعيين التي تم تكوينها لتدفق العمل. تقوم واجهة برمجة التطبيقات أيضا بإرجاع true إذا تم إرفاق روبوت بدفق العمل أو قائمة انتظار. نوصي بعدم استخدام واجهة برمجة التطبيقات هذه عند وجود روبوت. - خطأ إذا لم يكن الوكلاء متاحين لتلقي الطلبات. |
averageWaitTime |
الرقم | متوسط وقت الانتظار بالدقائق للعملاء في قائمة الانتظار المستهدفة استنادا إلى بيانات ال 48 ساعة الماضية. |
مثال
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
// Gets the agent availability
Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();
});
تمرير قيم السياق المخصصة للدالة للتأكد من تلقي السياق
تقوم هذه الطريقة بإجراء استدعاء داخلي إلى الدالة setContextProvider ثم تستدعي getAgentAvailability بشكل متزامن، للتأكد من تعيين السياق قبل المتابعة. نظرا للطبيعة غير المتزامنة للوظائف عند استخدامها بشكل منفصل، قد لا يكون السياق جاهزا عند توفر العامل الاستشاري.
ملاحظة
لا تحتاج إلى استدعاء الأسلوب setContextProvider قبل استدعاء getAgentAvailability.
فيما يلي نموذج التعليمات البرمجية الذي يوضح كيفية استخدام الأسلوب 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}
}
}
);