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

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

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

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

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

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

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

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

Webhook في Parter Hub

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

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

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

الوصول وخصوصية البيانات

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

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

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

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

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

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

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

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

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

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

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

معلمات API هي:

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

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

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

تعيد واجهة برمجة التطبيقات Records سجلات المكالمات بتنسيق JSON، وهو نفس التنسيق الموضح في Detailed Call History API. تحتوي الحمولة المرتجعة على حقول متطابقة مع الحمولة المرتجعة لسجل المكالمات التفصيلي. لمزيد من المعلومات حول الحقول وقيمها، راجع تقرير تاريخ المكالمات التفصيلي لـ Webex Calling.

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

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

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

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

لتحديد ما إذا كانت استجابات واجهة برمجة التطبيقات مقسمة إلى صفحات، تحقق من رؤوس الاستجابة لرأس الرابط. إذا كان الرابط 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" للصفحات الأولى والسابقة على التوالي.

شريك reports/templates واجهة برمجة التطبيقات

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

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