يتيح لك خطاف الويب التفصيلي لسجلات المكالمات إمكانية رؤية أكبر في نشاط Webex Calling لعملائك لأغراض مختلفة، بدءًا من الفوترة وحتى إعداد التقارير المصممة خصيصًا. يمكنك استخدام خطاف الويب هذا لجمع السجلات بشكل مناسب لجميع عملائك دون الحاجة إلى استعلام السجلات لكل عميل واحد تلو الآخر. يسمح لك خطاف الويب هذا بتطوير تطبيقات تقارير وتحليلية مخصصة لأغراض العمل الداخلي أو توفير خدمات ذات قيمة مضافة للعملاء. للحصول على مقدمة عن خطاف الويب واجهات API المصاحبة له، يمكنك مشاهدة vidcast.

يوفر خطاف الويب السجلات كل 5 دقائق. يحتوي كل حمولة خطاف الويب على سجلات للمكالمات التي انتهت منذ 10 إلى 5 دقائق. على سبيل المثال، تشتمل الحمولة المستلمة في الساعة 17:00 على المكالمات التي انتهت بين 16:50 و16:55. المكالمات التي تنتهي بين 16:55 و17:00 ستكون ضمن الحمولة 17:05.

يتم تسليم سجلات Webex Calling باستخدام نفس التنسيق مع واجهات API التفصيلية الحالية لسجلات المكالمات. يمكنك إعداد خطاف ويب والاختيار بين نوعين من التلقيم:

• التحليلات—تشمل جميع سجلات المكالمات لجميع مؤسسات العملاء التي يقيم الشريك علاقة معها في Webex Calling. ويشمل ذلك المنظمات التي:
  • يدير الشريك مؤسسة العميل مع دور المسؤول الكامل للشريك.
  • لدى مؤسسة العميل اشتراك نشط في Webex Calling داخل مؤسسة الشريك.
• الفوترة— تشمل سجلات المكالمات فقط للمكالمات التي أجراها المستخدمون باستخدام ترخيص Webex Calling الذي يبيعه الشريك. يتم تضمين سجلات المكالمات لمساحات العمل في هذه التغذية.

نحن نوفر نقطتي نهاية API إلى جانب خطاف الويب للمساعدة في مطابقة البيانات. تتيح لك نقاط النهاية هذه "التعرف على أحدث المستجدات" أو التوفيق بين مخازن بياناتك والسجلات المفقودة التي لا يتلقاها مستمع خطاف الويب. وهاتان المعاهدتان هما نقطة نهاية API للمصالح ة ونقطة نهاية API للسجلات.

تتوفر السجلات من واجهات API هذه لمدة 48 ساعة. نوصي بالمطابقة بين مخازن السجلات بشكل دوري، مثل كل 12 أو 24 ساعة، بحيث يتم استلام جميع السجلات كما هو متوقع. مطلوب رمز وصول الشريك لاستخدام واجهة برمجة التطبيقات هذه. يمكنك الحصول على رمز وصول الشريك وإدارته وفقًا لمبادئ إدارة رمز وصول مطور Webex القياسي.

نقطة نهاية API للمصالحة

تقوم نقطة نهاية واجهة برمجة التطبيقات للمصالحة بإرجاع عدد السجلات التي أنشأها كل عميل والتي يديرها الشريك في الفترة الزمنية المحددة. إذا كان الشريك يدير أكثر من 200 مؤسسة عميل، فسيتم تقسيم النتائج من واجهة برمجة التطبيقات إلى صفحات لضمان قابلية قراءة أفضل. يمكنك استخدام هذه المجاميع للتحقق من التخزين المحلي إذا كانت هناك أي سجلات مفقودة لعملاء محددين. يمكنك العثور على عنوان URL لنقطة نهاية API للمصالحة هنا:

https://analytics.webexapis.com/v1/partners/cdrcountbyorg?endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z

المعلمات

لا يمكن استدعاء واجهة برمجة التطبيقات للمصالحة إلا لمدة أقصاها 1 ساعة، مع وجود معلمتي startTime وendTime على مسافة تزيد عن 60 دقيقة. يمكن استخدام واجهة API لأي فترة مدتها 1 ساعة بين 5 دقائق و48 ساعة مضت، ولكن لإدارة تحميل الخدمة، يمكن الاتصال بساعة واحدة فقط في المرة الواحدة.

المعلمات المتوفرة هي:

• startTime (سلسلة نصية) — وقت التقرير الأول الذي تريد تجميعه. يحدد وقت التقرير وقت إكمال المكالمة.

  يجب عليك تنسيق الوقت كـ YYYY-MM-DDTHH:MM:SS.mmmZ.

• endTime (سلسلة نصية) — وقت آخر تقرير تريد تجميعه. يحدد وقت التقرير وقت إكمال المكالمة.

  يجب أن يكون الوقت المحدد بعد startTime ولكن لا يتجاوز 48 ساعة، ويجب عليك تنسيق الوقت كـ YYYY-MM-DDTHH:MM:SS.mmmZ.

فيما يلي مثال على شكل حمولة إرجاع JSON لنقطة نهاية واجهة برمجة التطبيقات للمصالحة:

{ "cdr_counts": [ {"orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyy"، "count": 3009 }، { "orgId": "yyyyyy-yyyy-zzzz-xxxx-yyyyyyyyyyy"، "count": 129 }، { "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyy"، "count": 278 } ] } 

تشير رؤوس استجابة API إلى إجمالي عدد المؤسسات التي تم إرجاعها وما إذا كانت هناك صفحات إضافية أم لا. تحقق من المعلمات التالية للتأكد من أنه تم الاستعلام عن جميع الصفحات.

 عدد الصفحات = 2 إجمالي المؤسسات = 283 صفحة حالية = 1

تظهر المعلمات المذكورة أعلاه أن الصفحة الحالية هي الصفحة الأولى، وأن هناك 2 صفحات إجمالية، وأن الاستجابة بأكملها تحتوي على 283 مؤسسة. يمكنك الوصول إلى الصفحة الثانية عن طريق إضافة المعلمة page=2 إلى طلب GET ، كما هو موضح أدناه.

https://analytics.webexapis.com/v1/partners/cdrcountbyorg?endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z&page=2

نقطة نهاية API للسجلات

ترجع نقطة نهاية API هذه سجلات المكالمات بتنسيق JSON، متطابقة مع التنسيق كما هو موضح في واجهة برمجة تطبيقات محفوظات المكالمات التفصيلية. تحتوي الحمولة التي تم إرجاعها على حقول مطابقة للحمولة التي تم إرجاعها "محفوظات المكالمات التفصيلية". يمكنك العثور على مزيد من التفاصيل حول القيم في كل حقل تم إرجاعه هنا. تُستخدم نقطة نهاية API للسجلات للاستعلام عن السجلات المفقودة للمؤسسات التي تكون السجلات مفقودة بالنسبة لها. يمكنك العثور على عنوان URL لنقطة نهاية API للسجلات هنا:

https://analytics.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z

المعلمات

• orgID— معرف المؤسسة الذي تريد الاستفسار عنه في السجلات. يمكنك فتح هذه المعرفات من نقطة نهاية التسوية السابقة.

• startTime (سلسلة نصية) — وقت التقرير الأول الذي تريد تجميعه. يحدد وقت التقرير وقت إكمال المكالمة.

  يجب أن يكون الوقت المحدد بين 5 دقائق مضت و48 ساعة مضت، ويجب تنسيق الوقت كـ YYYY-MM-DDTHH:MM:SS.mmmZ.

• endTime (سلسلة نصية) — وقت آخر تقرير تريد تجميعه. يحدد وقت التقرير وقت إكمال المكالمة.

  يجب أن يكون الوقت المحدد بعد startTime ولكن لا يتجاوز 48 ساعة، ويجب عليك تنسيق الوقت كـ YYYY-MM-DDTHH:MM:SS.mmmZ.