تكوين رؤوس X-SIP للوكلاء الذين يدعمون خاصية الصوت

تشرح هذه المقالة كيفية تكوين عناوين X لبروتوكول بدء الجلسة (SIP) للمكالمات الواردة والصادرة في Copilot Studio للوكلاء المزودين بميزة الصوت لاستخدامها في Dynamics 365 Contact Center.

تمكنك عناوين SIP X من تمرير بيانات التعريف المخصصة بين أنظمة الاتصالات الهاتفية والوكلاء الممكنين للصوت. يدعم مركز الاتصال Dynamics 365 الوكلاء المجهزين بالصوت لعناوين X الواردة والصادرة. يسمح هذا التكوين بتبادل البيانات السلس أثناء عمليات نقل المكالمات والتوجيه.

المتطلبات المسبقه

• Dynamics 365 Contact Center مع تمكين الوكلاء المجهزين للصوت

• الوصول إلى Copilot Studio مع الصلاحيات المناسبة

• التوجيه المباشر لتكوين الاتصالات الهاتفية

• الفهم الأساسي لـ Copilot Studio الموضوع وإدارة المتغيرات

مهم

يجب أن تحتوي أسماء وقيم SIP X-header على أحرف معتمدة فقط. تعرف على المزيد حول الأحرف المدعومة في تمرير البيانات السياقية بين المكالمات.

تكوين رؤوس X الواردة

تحتوي الترويسات X الواردة على بيانات تعريف يتم تمريرها من أنظمة الاتصالات الهاتفية الخارجية إلى الوكيل المزود بالقدرات الصوتية. لتلقي هذه البيانات واستخدامها، يجب تكوين عقدة Parse Value لاستخراج معلومات رأس X من Conversation.SipXHeader متغير النظام.

متطلبات رأس X الواردة

• الحد الأقصى للعدد: خمسة رؤوس X لكل مكالمة واردة.

• متطلبات التسمية: يجب أن تبدأ جميع أسماء رؤوس X ب x-.

  ملحوظة

  في Copilot Studio، يجب أن تبدأ جميع رؤوس X الواردة بأحرف صغيرة x-، حتى إذا كان النظام الخارجي الذي يرسل رأس X يستخدم أحرفا كبيرة X-. يمكن أن يكون رأس X الصادر المحدد في Copilot Studio إما أحرفا صغيرة أو أحرفا كبيرة، اعتمادا على الصيغة التي يتوقعها النظام الخارجي.

• طول الاسم: يصل إلى 64 حرفا.

• طول القيمة: يصل إلى 256 حرفا.

• مخطط JSON مطلوب لجميع رؤوس X المتوقعة.

• تحديث مخطط JSON عند تغيير أسماء رأس X.

• تبعية بيانات القناة: يجب أن تكون رؤوس X موجودة في Conversation.SipXHeader.

إضافة إدارة المتغيرات - عقدة تحليل القيمة

1. انتقل إلى القسم الخاص بالمساعد الممكن بالصوت.

2. إضافة عقدة موضوع جديدة.

3. حدد إدارة المتغيرات وحدد Parse value.

   

تكوين عقدة Parse Value

1. من قائمة النظام ، قم بتعيين حقل قيمة التحليل إلى Conversation.SipXHeader.

2. تعيين نوع البيانات إلى من بيانات العينة.

3. حدد بنية رأس X المتوقعة عن طريق تحديد Get schema من نموذج JSON.

   

تعريف مخطط JSON لرؤوس X

في مربع الحوار Get schema from sample JSON ، قم بتوفير بنية JSON التي تتضمن أسماء X-header التي تتوقع تلقيها. على سبيل المثال، إذا كنت تتوقع رؤوسا مثل X-CallID وفي X-AAI-Incoming مكالمة واردة، أضفها إلى مخطط JSON الخاص بك.

حدد Confirm لتطبيق المخطط.

مهم

يقوم النظام الأساسي Dynamics 365 Contact Center دائما بتطبيع أسماء رؤوس X لاستخدام بادئة x- صغيرة، بغض النظر عن كيفية إرسال النظام الخارجي لها. وهذا يعني:

• إذا أرسل النظام الخارجي X-CallID، يجب تعريفه على أنه x-CallID في المخطط الخاص بك.

• إذا أرسل النظام الخارجي X-AAI-Incoming، يجب تعريفه على أنه x-AAI-Incoming في المخطط الخاص بك.

على الرغم من أن النظام الخارجي قد يستخدم الأحرف الكبيرة X-، يجب أن يستخدم المخطط دائما أحرفا صغيرة x- بحيث يمكن للنظام الأساسي تعيين الرؤوس ومعالجتها بشكل صحيح.

مثال JSON لعناوين X

{

"x-CallID": "",

"x-AAI-Incoming": ""  
}

حفظ البيانات التي تم تحليلها

1. إنشاء متغير أو تحديده في الحقل حفظ باسم (على سبيل المثال، IncomingSipXHeader).

   

2. قم بتعيين نطاق المتغير إلى Global للسماح بالوصول عبر مواضيع متعددة في وكيلك.

الوصول إلى قيم رأس X في مواضيعك

بمجرد التكوين، يمكنك الوصول إلى قيم رأس X الفردية باستخدام تدوين النقطة، على غرار الأمثلة التالية:

• Global.IncomingSipXHeader.'x-AAI-Incoming'

• IncomingSIPXHeaders.sipXHeader.'X-CallID'

سلوك وقت التشغيل

• يتلقى Copilot Studio فقط الرؤوس الخمسة الأولى من X المرسلة من قبل النظام الخارجي.

• يقوم Copilot Studio تلقائيًا بملء السجل بقيم رأس X عندما تتطابق الأسماء مع المخطط.

• تحتوي رؤوس X المفقودة على قيم سلسلة فارغة.

• تكون تحديثات المخطط مطلوبة عند تغيير أسماء رؤوس X، أو إذا كنت تريد تلقي رؤوس إضافية.

تكوين رؤوس X الصادرة

يمكنك تمرير البيانات المخصصة عند تحويل المكالمات إلى أرقام هاتف خارجية باستخدام X-headers الصادرة. قم بتكوين هذه العناوين في عقدة نقل المحادثة .

متطلبات رأس X الصادرة

• الحد الأقصى للعدد: خمسة X-headers لكل عملية نقل.

• متطلبات التسمية: يمكن أن تبدأ جميع أسماء عناوين X ب X- أو x-، اعتمادا على الحالة التي يتوقعها النظام الخارجي.

  ملحوظة

  في Copilot Studio، يجب أن تبدأ جميع رؤوس X الواردة بأحرف صغيرة x-، حتى إذا كان النظام الخارجي الذي يرسل رأس X يستخدم أحرفا كبيرة X-. يمكن أن يكون رأس X الصادر المحدد في Copilot Studio إما أحرفا صغيرة أو أحرفا كبيرة، اعتمادا على الصيغة التي يتوقعها النظام الخارجي.

• طول الاسم: يصل إلى 64 حرفا.

• طول القيمة: يصل إلى 256 حرفا.

• نوع النقل: متوفر فقط لنقل رقم الهاتف الخارجي.

إعداد عقدة نقل المحادثة

1. إضافة عقدة نقل المحادثة إلى تدفق الموضوع الخاص بك.

2. ضمن نوع النقل، حدد نقل رقم الهاتف الخارجي وأدخل رقم النقل. على سبيل المثال، +18005551212.

تكوين X-headers في نقل خصائص عقدة المحادثة

1. حدد أيقونة المزيد (...) للعقدة، ثم حدد خصائص.

2. حدد + Add لإضافة أزواج قيمة مفتاح رأس X.

   

3. تعريف إدخالات رأس X. يتم إرسال أسماء رؤوس X الصادرة بدقة وفقًا لتعريفك لها في عقدة نقل المحادثة. اختر الحالة المناسبة بناء على ما يتوقعه نظام الاستلام.

   • اسم المفتاح: يجب أن يبدأ ب X- أو x- (على سبيل المثال، X-AAI-Outgoing أو X-CallID)
   • القيمة: أدخل قيمة ثابتة أو عين متغيرا

   

أفضل الممارسات

اتبع هذه الإرشادات لتصميم المخطط وإدارة المتغيرات ومعالجة الأخطاء والأداء عند العمل مع عناوين SIP X في الوكلاء الممكنين للصوت. تعرف على المزيد في الأدوات والمعرفة وMCP وواجهة برمجة التطبيقات.

تصميم المخطط

• استخدم أسماء عناوين X الوصفية التي تشير بوضوح إلى الغرض منها.

• احتفظ بمخطط JSON محدثا عند تغيير متطلبات رأس X.

• قم بتوثيق مخطط "رأس X" لمرجع الفريق واستكشاف الأخطاء وإصلاحها.

إدارة المتغيرات

• استخدم المتغيرات العمومية لبيانات رأس X التي تحتاج إلى الوصول إليها عبر الموضوعات.

• اختر أسماء متغيرات ذات معنى (على سبيل المثال، IncomingSIPXHeaders أو CustomerXHeaders).

• تهيئة المتغيرات في وقت مبكر من تدفق المحادثة.

معالجة الأخطاء

• تحقق دائما من وجود X-header قبل استخدام القيم في المنطق الخاص بك.

• تنفيذ آلية سلوك احتياطي عندما تكون بيانات X-header مفقودة أو غير صالحة.

• اختبر بدقة مع سيناريوهات رأس X المختلفة.

الاعتبارات الخاصة بالأداء

• تحليل ترويسات X في وقت مبكر من مسار المحادثة.

• ذاكرة التخزين المؤقت للقيم المستخدمة بشكل متكرر في متغيرات منفصلة إذا لزم الأمر.

• تجنب التحليل المتكرر لبيانات القناة نفسها.

المشاكل الشائعة في X-headers الواردة

إذا لم تعمل عناوين X الواردة كما هو متوقع، فراجع هذه المشكلات الشائعة وخطوات استكشاف الأخطاء وإصلاحها.

القيم الخاصة برأس X لم يتم تلقيها

• تحقق من أن مخطط JSON يطابق أسماء رأس X المتوقعة بالضبط.

• تحقق من تكوين عقدة Parse Value باستخدام Conversation.SipXHeader.

• تأكد من تعيين المتغير إلى النطاق العمومي إذا قمت بالوصول إليه من مواضيع متعددة.

• تأكد من أنه لا يتوقع أكثر من خمسة رؤوس X، وأن رؤوس X هي أفضل خمسة رؤوس X يتم إرسالها بواسطة النظام الخارجي.

قيم رأس X فارغة أو خالية

• تأكد من أن النظام الخارجي يرسل عناوين X بالأسماء المتوقعة.

• تحقق من أن مخطط JSON يتضمن جميع أسماء رؤوس X المطلوبة مع بادئة صغيرة x- .

المشاكل الشائعة مع ترويسات X الصادرة

إذا لم تعمل عناوين X الصادرة كما هو متوقع، فراجع هذه المشكلات الشائعة وخطوات استكشاف الأخطاء وإصلاحها.

لم يتم إرسال رؤوس X خلال عملية النقل

• تحقق من أن جميع أسماء X-header تبدأ ب X- أو x-.

• تأكد من تعيين نوع النقل إلى نقل رقم الهاتف الخارجي.

• تأكد من تعيين قيم رأس X بشكل صحيح قبل عقدة نقل المحادثة .

فشل النقل مع رؤوس X

• تأكد من أن أسماء وقيم X-header لا تتجاوز حدود الطول.

• تحقق من أن نظام الاستلام يمكنه التعامل مع رؤوس X التي يتم إرسالها.

• تحقق من وجود أحرف خاصة قد تتسبب في حدوث مشاكل في التحليل.

إدارة المخطط

حافظ على مخطط رأس X منظما ومحدثا مع تغير متطلباتك.

تحديث مخطط رأس X

• تحديث نموذج JSON في تعريف مخطط JSON لرؤوس X لتلقي رؤوس X جديدة.

• تأكيد المخطط المحدث وحفظه.

• اختبر المخطط باستخدام تكوين رأس X الجديد.