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

يمكنك استخدام هذا الرابط الإلكتروني لجمع السجلات بسهولة لجميع العملاء الذين تتم إدارتهم من خلال مركز الشركاء دون الحاجة إلى الاستعلام من كل عميل على حدة. تتيح لك هذه الخاصية (webhook) تطوير تطبيقات مخصصة لإعداد التقارير والفواتير والتحليلات لكل من متطلبات العمل الداخلية والخدمات ذات القيمة المضافة.

للحصول على مقدمة عن Webhook وواجهات برمجة التطبيقات المصاحبة له، شاهد هذا الفيديو: واجهة برمجة تطبيقات سجل المكالمات التفصيلي لشركاء الاتصال في Webex.

ما يقدمه رابط الويب الخاص بالشريك

يقوم نظام الويب هوك بتوفير سجلات مفصلة لتاريخ المكالمات كل 5 دقائق. تحتوي كل حمولة من حمولات webhook على ما يلي:

• سجلات المكالمات التي انتهت بين 10 دقائق و 5 دقائق قبل الوقت الحالي.
• أي سجلات متأخرة تتم معالجتها بواسطة سحابة Webex Calling.
• يقوم تلقائيًا بتعبئة سجلات المكالمات المتأخرة في حمولات webhook اللاحقة لضمان التسليم الموثوق.

لتوضيح كيفية تضمين سجلات المكالمات في كل حمولة، انظر المثال التالي:

• تم استلام حمولة في 14:05 يحتوي على المكالمات التي انتهت بين 13:55 و 14:00.
• المكالمات التي تنتهي بين 14:00 و 14:05 يتم تضمينها في 14:10 الحمولة.
• تم إكمال السجلات سابقًا (على سبيل المثال، مكالمة انتهت في 14:04) ولكن تتم معالجتها متأخرة بواسطة خدمة Webex Calling السحابية (على سبيل المثال، في 14:11) يتم تضمينها في الحمولة المجدولة التالية (على سبيل المثال، 14:15).

رابط الويب في مركز الشركاء

من خلال توفير رابط الويب، فإنك تمكّن منصة التحليلات من إرسال سجلات المكالمات إلى عنوان URL الخاص بالرد عند إنشائها.

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

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

الوصول إلى البيانات وخصوصيتها

لا يمكن الوصول إلى سجلات تفاصيل المكالمات (CDR) لأغراض الفوترة إلا من قبل الشريك المالك.

• يصبح الشريك (أو الشريك الفرعي) الذي يدير الترخيص المرتبط بسجل المكالمات هو الشريك المالك.
• يتم تحديد الملكية من خلال: معرف المستخدم > رقم الترخيص > معرف الاشتراك > معرف الشريك.
• كل سجل بيانات المكالمات (CDR) متاح لشريك واحد فقط.
• بعض سجلات المكالمات لا ترتبط بشريك الفوترة، ولا يحصل جميع الشركاء المرتبطين بمؤسسة ما على وصول متساوٍ إلى جميع السجلات، لأن هذه السجلات قد تحتوي على معلومات تعريف شخصية (PII).

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

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

يجب عليك استخدام رمز وصول الشريك للوصول إلى واجهات برمجة التطبيقات هذه. احصل على رمز الوصول الخاص بشريكك وقم بإدارته وفقًا لممارسات إدارة رموز الوصول القياسية لمطوريWebex .

نقطة نهاية واجهة برمجة تطبيقات المصالحة

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

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

يستخدم عنوان URL لنقطة نهاية واجهة برمجة تطبيقات المصالحة التنسيق التالي:

معلمات واجهة برمجة التطبيقات

يمكنك استخدام واجهة برمجة التطبيقات (API) لاسترداد سجلات المكالمات من آخر 30 يومًا. يجب أن تبدأ الفترة الزمنية التي اخترتها قبل 5 دقائق على الأقل من التوقيت العالمي المنسق الحالي، ولا يمكن أن تتجاوز 12 ساعة بين وقتي البداية والنهاية في مكالمة API واحدة.

معلمات واجهة برمجة التطبيقات هي:

• startTime (مطلوب، سلسلة نصية)—تاريخ ووقت البدء (UTC) لأول سجل تريد جمعه. تأكد من:
  • يمكنك تنسيق الوقت على النحو التالي: YYYY-MM-DDTHH:MM:SS.mmmZ. على سبيل المثال، 2025-08-15T06:00:00.000Z.
  • يجب ألا يتجاوز تاريخ ووقت البدء 30 يومًا من التوقيت العالمي المنسق الحالي.
  • لا يمكن أن تتجاوز الفترة الزمنية بين startTime و endTime 12 ساعة.
• endTime (مطلوب، سلسلة نصية)—تاريخ ووقت الانتهاء (UTC) للسجلات التي تريد جمعها. تعتمد السجلات على وقت التقرير، وهو الوقت الذي تتم فيه المكالمة. تأكد من:
  • يمكنك تنسيق الوقت على النحو التالي: YYYY-MM-DDTHH:MM:SS.mmmZ. على سبيل المثال، 2025-08-15T18:00:00.000Z.
  • يجب أن يكون تاريخ ووقت الانتهاء قبل 5 دقائق من التوقيت العالمي المنسق الحالي وألا يكون أقدم من 30 يومًا.
  • يجب أن يكون تاريخ ووقت الانتهاء أكبر من startTime.
  • لا يمكن أن تتجاوز الفترة الزمنية بين startTime و endTime 12 ساعة.

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

          {
          "cdr_counts": [
          {
          "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 3009
          },
          {
          "orgId": "yyyyyyyy-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 129
          },
          {
          "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 27895
          }
          ]
          }          
        

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

• عدد الصفحات: إجمالي عدد الصفحات (على سبيل المثال، 2)
• total-orgs: إجمالي عدد المنظمات المشمولة في الرد (على سبيل المثال، 283)
• الصفحة الحالية: رقم الصفحة الحالية (على سبيل المثال، 1)

على سبيل المثال، إذا كانت العناوين تظهر num-pages=2, total-orgs=283, و current-page=1, أنت تشاهد الصفحة الأولى من رد مكون من صفحتين يحتوي على 283 منظمة إجمالاً. للوصول إلى الصفحة التالية، أضف page=2 المعلمة الخاصة بطلب GET الخاص بك، كما هو موضح أدناه:

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

نقطة نهاية واجهة برمجة تطبيقات السجلات

تُستخدم نقطة نهاية واجهة برمجة تطبيقات السجلات للاستعلام عن سجلات المكالمات المفقودة لمنظمات محددة حيث تم تحديد التناقضات أو البيانات المفقودة باستخدام واجهة برمجة تطبيقات المصالحة.

تقوم واجهة برمجة تطبيقات السجلات بإرجاع سجلات المكالمات بتنسيق JSON، وهو تنسيق مطابق للتنسيق الموضح في واجهة برمجة تطبيقات سجل المكالمات المفصلة . تحتوي البيانات المُعادة على حقول مطابقة لتلك الموجودة في البيانات المُعادة من سجل المكالمات التفصيلي. للحصول على مزيد من المعلومات حول الحقول وقيمها، راجع تقرير سجل المكالمات المفصل لـ Webex.

توفر واجهة برمجة التطبيقات سجلات المكالمات التي انتهت قبل 5 دقائق من الوقت الحالي. لضمان إتاحة جميع سجلات المكالمات، نوصي بالاستعلام عن واجهة برمجة التطبيقات بعد ساعة واحدة من الفترة الزمنية المفضلة لديك.

يستخدم عنوان URL لنقطة نهاية واجهة برمجة تطبيقات السجلات التنسيق التالي:

https://analytics-calling.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 (مطلوب، سلسلة نصية)—تاريخ ووقت البدء (UTC) لأول سجل تريد جمعه. تأكد من:
  • يمكنك تنسيق الوقت على النحو التالي: YYYY-MM-DDTHH:MM:SS.mmmZ. على سبيل المثال، 2025-08-15T06:00:00.000Z.
  • يجب ألا يتجاوز تاريخ ووقت البدء 30 يومًا من التوقيت العالمي المنسق الحالي.
  • يجب ألا تتجاوز الفترة الفاصلة بين startTime و endTime 12 ساعة في طلب API واحد.
• endTime (مطلوب، سلسلة نصية)—تاريخ ووقت الانتهاء (UTC) لآخر سجل تريد جمعه. تعتمد السجلات على وقت التقرير، وهو الوقت الذي تتم فيه المكالمة. تأكد من:
  • يمكنك تنسيق الوقت على النحو التالي: YYYY-MM-DDTHH:MM:SS.mmmZ. على سبيل المثال، 2025-08-15T18:00:00.000Z.
  • يجب أن يكون تاريخ ووقت الانتهاء قبل 5 دقائق على الأقل من التوقيت العالمي المنسق الحالي وألا يكون أقدم من 30 يومًا.
  • يجب أن يكون تاريخ ووقت الانتهاء أكبر من startTime.
  • يجب ألا تتجاوز الفترة الفاصلة بين startTime و endTime 12 ساعة في طلب API واحد.
• الحد الأقصى (اختياري، رقم) - يحدد الحد الأقصى لعدد السجلات في الصفحة الواحدة في الاستجابة. تأكد من:
  • يتراوح النطاق من 500 إلى 5000. القيمة الافتراضية هي 5000. على سبيل المثال، Max=1000.
  • إذا كان لدى واجهة برمجة التطبيقات (API) سجلات أكثر من القيمة القصوى المحددة، فسيتم تقسيم الاستجابة إلى صفحات.
  • إذا تم تحديد قيمة أقل من 500، فسيتم تعديلها تلقائيًا إلى 500. إذا تم تحديد قيمة أعلى من 5000، فسيتم تعديلها إلى 5000.

تقسيم الصفحات

لتحديد ما إذا كانت استجابات واجهة برمجة التطبيقات (API) مقسمة إلى صفحات، تحقق من رؤوس الاستجابة بحثًا عن رأس Link. إذا كان هناك رابط next موجود في رأس الرابط، فقم باستخراجه واستخدم قيمة startTimeForNextFetch لطلب المجموعة التالية من السجلات. إذا لم يكن هناك رابط تالٍ، فسيتم جمع جميع التقارير الخاصة بالنطاق الزمني المحدد.

يمكن إجراء طلبات واجهة برمجة التطبيقات للصفحات اللاحقة على الفور، ولكن يجب تقييد معدل الطلبات بحد أقصى 10 طلبات مُصفحة في الدقيقة، لكل نطاق رمز مميز.

على سبيل المثال، إذا كان طلب واجهة برمجة التطبيقات الأولي هو:

https://analytics-calling.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=2025-08-15T18:00:00.000Z&startTime=2025-08-15T06:00:00.000Z&Max=5000

ثم يكون عنوان الرابط في الاستجابة كالتالي:

; rel="next"

تتضمن قيم الروابط الأخرى الممكنة rel="first" و rel="prev" للصفحتين الأولى والسابقة على التوالي.

يمكنك إنشاء وتنزيل التقارير المتوفرة في مركز الشركاء باستخدام واجهات برمجة تطبيقات تقارير الشركاء . للمزيد من المعلومات، راجع الشريك report/templates.

يمكن للشركاء أيضاً الوصول إلى العديد من التقارير وتنزيلها مباشرة من مركز الشركاء. للمزيد من المعلومات، راجع تقارير مركز الشركاء .