تشرح هذه الصفحة ملفات البيانات التي يُنشئها نظام RCS للأعمال لمساعدة شركات الاتصالات الأمريكية في عمليات الفوترة والتدقيق وفقًا لإطار عمل إدارة المخاطر القائم على النتائج في الولايات المتحدة. للمزيد من المعلومات حول إطار عمل إدارة المخاطر القائم على النتائج في الولايات المتحدة، يُرجى زيارة الموقع الإلكتروني usrbm.org .
تقرير الفوترة هو تقرير مُجمّع للأحداث القابلة للفوترة بين الوكلاء المُفعّلين والمستخدمين. تعني كلمة "قابل للفوترة" ببساطة أن الحدث مؤهل للدفع. تُحدد شركات الاتصالات ما إذا كانت الأحداث القابلة للفوترة ستُفوتر وكيفية ذلك. جميع شركات الاتصالات الأمريكية التي تُشغّل خدمة RCS للأعمال لديها إمكانية الوصول إلى تقارير الفوترة.
للحصول على تفاصيل حول نموذج تصنيفات الفواتير في الولايات المتحدة، يرجى الرجوع إلى الأسئلة الشائعة حول الفواتير في الولايات المتحدة .
إنشاء الملفات
للمزيد من المعلومات، انظر قسم إنشاء الملفات .
تخزين الملفات والوصول إليها
للمزيد من المعلومات، راجع قسم تخزين الملفات والوصول إليها .
توافر الملفات
للمزيد من المعلومات، راجع قسم توفر الملفات .
تقارير الفواتير
تقارير الفوترة هي سجلات للأحداث القابلة للفوترة ، والتي تُحسب بناءً على فئة فوترة الوكيل ونوع الرسائل التي يرسلها. تتوفر تقارير الفوترة لجميع شركات الاتصالات التي تُشغّل خدمة RCS للأعمال بشكل فعّال.
تحتوي تقارير الفواتير على معلومات سرية، ولكن لا تحتوي على معلومات تعريف شخصية للمستخدم (PII)، مثل MSISDN، أو MSISDN المشفر، أو أي معرف فريد للمستخدم.
فئات الفوترة مقابل الأحداث القابلة للفوترة
يُعد التمييز بين فئات فوترة الوكيل والأحداث القابلة للفوترة أمرًا أساسيًا لفهم كيفية احتساب الفوترة لوكيلك.
- فئة الفوترة هي تصنيف ثابت تختاره عند إنشاء وكيلك. وهي تحدد الطريقة التي يتم بها فوترة وكيلك: لكل رسالة (الوكلاء غير التفاعليين) أو لكل جلسة (الوكلاء التفاعليين).
- الأحداث القابلة للفوترة هي تفاعلات بين وكيل RCS للأعمال ومستخدم يتم تتبعها لأغراض الفوترة (على سبيل المثال،
rich_message).
فئات فواتير الوكلاء في الولايات المتحدة
عند إنشاء وكيل، يحدد المالك فئة الفوترة الخاصة به بناءً على كيفية تفاعل الوكيل مع المستخدمين. لا تقيّد فئة الفوترة عدد الرسائل أو أنواعها التي يمكن للوكيل إرسالها، ولكنها تحدد كيفية احتساب رسوم الرسائل. يوضح الجدول التالي فئتي الفوترة الرئيسيتين.
| فئة الفوترة | نوع الوكيل | أمثلة على حالات الاستخدام | طريقة الفوترة |
|---|---|---|---|
| غير حواري | وكلاء يرسلون في المقام الأول رسائل أحادية الاتجاه. |
| يتم احتساب رسوم على كل رسالة يتم تسليمها للمستخدم. |
| محادثة | وكلاء مصممون لإجراء تبادلات ذهابًا وإيابًا مع المستخدمين بغض النظر عمن يبدأ المحادثة. |
| يتم احتساب الرسوم لكل جلسة : إذا تم استيفاء معايير الجلسة، فسيتم احتساب الرسوم على جميع الرسائل الغنية والرسائل الغنية بالوسائط المتعددة خلال فترة الجلسة التي تبلغ 24 ساعة بسعر ثابت، بغض النظر عن طولها أو أجزائها. يتم احتساب الرسوم لكل رسالة : إذا لم يتم استيفاء معايير الجلسة أو إذا كانت الرسالة خارج نطاق نافذة الجلسة التي تبلغ 24 ساعة، فسيتم احتساب رسوم الرسالة بشكل فردي بسعر لكل رسالة للوسائط الغنية أو الوسائط الغنية وفقًا لجدول أسعار شركة الاتصالات الفردية. |
الوكلاء الحواريون مقابل الوكلاء غير الحواريين
يوجد نوعان من فئات فوترة الوكلاء: المحادثة وغير المحادثة.
يتم تحصيل رسوم من الوكلاء غير القادرين على إجراء المحادثات مقابل كل رسالة يقومون بتسليمها للمستخدم.
- هذا التصنيف هو الأنسب للوكلاء الذين لا يتوقعون ردوداً متكررة.
تُفرض رسوم ثابتة على وكلاء المحادثة مقابل كل جلسة، شريطة أن تبدأ الجلسة، وتشمل هذه الرسوم جميع الرسائل المتبادلة خلال فترة 24 ساعة، بما في ذلك الرسائل التي بدأت الجلسة. مع ذلك، قد تُفرض رسوم على الرسائل التي لا تدخل ضمن جلسة مدتها 24 ساعة.
- تُعد هذه الفئة الأنسب للوكلاء الذين ينخرطون في محادثات متعددة المراحل مع المستخدمين.
منطق فوترة الجلسات
وفقًا لنموذج الفوترة الأمريكي، تُفعَّل الجلسة بسلسلة من 4 رسائل غنية أو رسائل وسائط متعددة غنية (تتضمن رسالتين شهريتين على الأقل ورسالة واحدة متعددة الرسائل على الأقل) يتم تبادلها خلال 24 ساعة من الرسالة الأولى في سلسلة التفعيل. بمجرد استيفاء هذا الحد، تُفوتر جميع الرسائل خلال فترة الـ 24 ساعة كجلسة واحدة . أما الرسائل التي لا تُفعِّل جلسة أو لا تُفعِّلها، فتُفوتر وفقًا لسعر الرسالة الواحدة للرسائل الغنية أو رسائل الوسائط المتعددة الغنية، وذلك وفقًا لجدول أسعار شركة الاتصالات المعنية.
يوضح الرسم التخطيطي التالي مثالاً على جلسة فوترة من تطبيق إلى شخص (A2P) للوكلاء التفاعليين.
- MT (تم إنهاء المكالمة عبر الهاتف المحمول) هي رسالة ترسلها الشركة.
- MO (الرسالة المنشأ من الهاتف المحمول) هي رسالة أو إجراء يبدأه المستخدم.
الأحداث القابلة للفوترة
تُصنّف تدفقات الرسائل حسب منشئها واتجاهها. لوصف اتجاه حركة الرسائل، تستخدم شركات الاتصالات الأمريكية عادةً مصطلحي MT/MO . يتوافق هذان المصطلحان مع مصطلحي A2P/P2A المستخدمين في جميع وثائق RCS للأعمال. إليك شرحًا موجزًا لكيفية توافق هذين المصطلحين:
- A2P (التطبيق إلى الشخص) هو MT (الرسالة المرسلة من الهاتف المحمول) : رسالة ترسلها الشركة.
- P2A (من الشخص إلى التطبيق) هو MO (من الهاتف المحمول) : رسالة أو إجراء بدأه المستخدم.
| حدث | وصف | وكلاء غير محادثة | وكلاء المحادثة |
|---|---|---|---|
a2p_rich_message | رسالة مرسلة من قبل وكيل تحتوي فقط على نص أو ردود مقترحة أو إجراءات مقترحة محددة (اتصل برقم، افتح عنوان URL في المتصفح). | يتم التعامل معها دائماً كحدث فردي قابل للفوترة. يتم احتساب الرسوم لكل رسالة بناءً على الأجزاء (الجزء الواحد يساوي 160 بايت من UTF-8). | يتم التعامل معها كحدث فردي قابل للفوترة ما لم تصبح جزءًا من جلسة. |
p2a_rich_message | رسالة يرسلها المستخدم تحتوي فقط على نص حر أو نص ناتج عن النقر على رد مقترح. | يتم التعامل معها دائماً كحدث فردي قابل للفوترة. يتم احتساب الرسوم لكل رسالة بناءً على الشرائح. | يتم التعامل معها كحدث فردي قابل للفوترة ما لم تصبح جزءًا من جلسة. |
a2p_rich_media_message | رسالة مرسلة من قبل وكيل تحتوي على وسائط (صورة، فيديو، صوت)، وبطاقات غنية، وشرائح عرض، أو إجراءات معقدة مثل "عرض الموقع". | يتم التعامل معها دائماً كحدث فردي قابل للفوترة. يتم احتساب الرسوم كحدث واحد بسعر ثابت بغض النظر عن الحجم أو المحتوى. | يتم التعامل معها كحدث فردي قابل للفوترة ما لم تصبح جزءًا من جلسة. |
p2a_rich_media_message | رسالة مرسلة من المستخدم تحتوي على ملف وسائط تم تحميله (صورة، فيديو، صوت). | يتم التعامل معها دائماً كحدث فردي قابل للفوترة. يتم احتساب الرسوم كحدث واحد بسعر ثابت. | يتم التعامل معها كحدث فردي قابل للفوترة ما لم تصبح جزءًا من جلسة. |
p2a_suggested_action | يقوم المستخدم بالنقر على أي إجراء مقترح (مثل "عرض الموقع") ليس ردًا مقترحًا. | يتم التعامل معها دائماً كحدث فردي قابل للفوترة. يُنشئ حدثًا واحدًا قابلًا للفوترة لكل نقرة. | يتم التعامل معها كحدث فردي قابل للفوترة، وتولد حدثًا واحدًا قابلًا للفوترة لكل نقرة ما لم تصبح جزءًا من جلسة. |
a2p_session | نافذة تفاعل مدتها 24 ساعة تبدأ عند بدء تشغيل جلسة ما، وتكون الرسالة الأولى رسالة نصية. لمزيد من المعلومات، راجع: ما هي الجلسة وكيف تعمل . | غير متوفر. لا تنطبق الجلسات على الوكلاء غير القادرين على إجراء محادثات. | بمجرد تفعيل الخدمة، تُغطى جميع الرسائل خلال فترة الـ ٢٤ ساعة برسوم جلسة واحدة. أي حدث قابل للفوترة خلال جلسة الـ ٢٤ ساعة سيُنسب إلى مُعرّف الحدث القابل للفوترة الخاص بالجلسة. |
p2a_session | نافذة تفاعل مدتها 24 ساعة تبدأ عند بدء جلسة عمل وتكون الرسالة الأولى من نوع MO. لمزيد من المعلومات، راجع: ما هي الجلسة وكيف تعمل . | غير متوفر. لا تنطبق الجلسات على الوكلاء غير القادرين على إجراء محادثات. | بمجرد تفعيل الخدمة، تُغطى جميع الرسائل خلال فترة الـ ٢٤ ساعة برسوم جلسة واحدة. أي حدث قابل للفوترة خلال جلسة الـ ٢٤ ساعة سيُنسب إلى مُعرّف الحدث القابل للفوترة الخاص بالجلسة. |
إعداد تقارير الفواتير
لا تُحتسب الأحداث القابلة للفوترة إلا للوكلاء الذين لديهم حركة مرور غير مخصصة للاختبار. ولا تظهر الأنشطة من أرقام الهواتف التجريبية في تقارير الفوترة.
تفترض هذه التقارير أن الأحداث تُحتسب رسومها عند تسليم رسائل A2P، وليس عند إرسالها. ولا تُحتسب رسوم على الرسائل غير المُسلّمة أو المُلغاة قبل التسليم.
نموذج تقرير الفواتير
تستخدم تقارير الفوترة تنسيق اسم الملف rbm_billable_events_YYYY-MM-DD.csv . التاريخ الموجود في اسم الملف هو تاريخ إنشاء الملف.
يمثل كل سطر في التقرير سجلاً لحدث واحد قابل للفوترة. تُمثَّل جلسات A2P/P2A بصفوف متعددة، صف لكل رسالة متبادلة. يُظهر كل صف مرتبط بجلسة (يشترك في نفس billing_event_id ) إجمالي عدد رسائل MT وMO خلال فترة الجلسة الكاملة التي تمتد 24 ساعة في عمودَي mt_messages و mo_messages .
يحتوي كل سجل في التقرير على المعلومات التالية لكل حدث قابل للفوترة.
| مجال | شكل | وصف | مثال |
|---|---|---|---|
billing_event_id | خيط | معرف تم إنشاؤه يميز الحدث القابل للفوترة. جميع الرسائل التي تشكل جزءًا من جلسة واحدة سيكون لها نفس | 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type | خيط | نوع الحدث:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action | p2a_rich_message |
agent_id | خيط | معرّف فريد للوكيل الذي شارك في الحدث. | acme_342h23_agent@rbm.goog |
agent_owner | خيط | عنوان البريد الإلكتروني للمالك الحالي لحساب الشريك الذي تم إنشاء الوكيل فيه. | marketing@xyzaggregator.com |
billing_party | خيط | الجهة التي تُصدر فواتير الفعاليات. | الناقل |
max_duration_single_message | رقم | الحد الأقصى للوقت (بالساعات) المسموح به للمستخدم للرد على رسالة الوكيل قبل إغلاق نافذة بدء المحادثة وتصنيف الرسالة كحدث single_message . لا ينطبق هذا على النموذج الأمريكي للرسائل الغنية الفردية. | 24 |
max_duration_a2p_conversation | رقم | بالنسبة للجلسات التجريبية، يعكس هذا نافذة الجلسة التي تمتد على مدار 24 ساعة، بدءًا من الرسالة الأولى في تسلسل التشغيل. تُقاس المدة بالساعات. | 24 |
max_duration_p2a_conversation | رقم | بالنسبة للجلسات التجريبية، يعكس هذا نافذة الجلسة التي تبلغ مدتها 24 ساعة والتي تم قياسها من الرسالة الأولى في تسلسل التشغيل. | 24 |
start_time | YYYY-mm-ddTHH:00:00Z | تاريخ/وقت بدء الحدث بتوقيت UTC (ISO 8601). بالنسبة للجلسات، يمثل هذا الطابع الزمني للرسالة الأولى في تسلسل التشغيل. A2P a2p_rich_message و a2p_rich_media_message ، فهذا هو الوقت الذي يتم فيه تسليم الرسالة إلى المستخدم.a2p_session ، فهذا هو الوقت الذي يتم فيه تسليم الرسالة الأولى في المحادثة إلى المستخدم.P2A p2a_rich_message و p2a_rich_media_message ، فهذا هو الوقت الذي يتم فيه إرسال الرسالة من قبل المستخدم.p2a_session ، فهذا هو الوقت الذي يتم فيه إرسال الرسالة الأولى في المحادثة من قبل المستخدم. | 2025-05-20T08:00:00Z |
duration | رقم | تُشير المدة إلى الجلسات فقط، وتُقاس بالدقائق. أما إذا كان الحدث خارج نطاق الجلسة، فتكون القيمة صفرًا. | 45 |
mt_messages | رقم | عدد الرسائل المُرسلة إلى الهاتف المحمول (A2P) في الحدث. بالنسبة للجلسات، يُظهر كل صف يحمل نفس billing_event_id إجمالي عدد رسائل MT في الجلسة بأكملها. | 5 |
mo_messages | رقم | عدد الرسائل الصادرة من الأجهزة المحمولة (P2A) في الحدث. بالنسبة للجلسات، يُظهر كل صف يشترك في نفس billing_event_id إجمالي عدد رسائل MO في الجلسة بأكملها. | 3 |
size_kilobytes | رقم | حجم جميع الملفات المرفقة بالرسائل في الحدث، مقربة إلى أقرب كيلوبايت (1 كيلوبايت يساوي 1024 بايت). | 912 |
agent_name | خيط | اسم الوكيل الذي شارك في الحدث. | ACME Brand |
owner_name | خيط | اسم المالك الحالي لحساب الشريك الذي تم إنشاء الوكيل فيه. | XYZ Aggregator |
segment_count | رقم | عدد المقاطع المحسوب a2p_rich_message events و p2a_rich_message (المقطع الواحد يساوي 160 بايت من ترميز UTF-8). إذا لم يكن الحدث من بين الأحداث المذكورة، تكون القيمة 0. | 5 |
session_type | خيط | نوع الجلسة:a2p_sessionp2a_session | a2p_session |
نموذج تقرير الفواتير
يتوفر نموذج التقرير للتنزيل:
حجم الملف النموذجي
يعتمد حجم التقرير اليومي من شريك RCS للأعمال النشط على مقدار النشاط الذي قام به على شبكة شركة الاتصالات.