نموذج الفوترة في الولايات المتحدة

يوضّح هذا المستند نموذج الفوترة لحركة بيانات "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" على شركات الاتصالات في الولايات المتحدة.

نظرة عامة على تصنيفات الفوترة في الولايات المتحدة

يتم تلقائيًا تصنيف كل رسالة يتم إرسالها إلى رقم هاتف أمريكي أو تلقّيها منه إلى أحد الأنواع الثلاثة التالية استنادًا إلى تنسيقها:

  • رسالة غنية بصريًا متقدّمة (ثنائية الاتجاه)
  • رسالة وسائط تفاعلية متقدّمة (ثنائية الاتجاه)
  • النقرة على الإجراء المقترَح (بمبادرة من المستخدم)

يُرجى الرجوع إلى الأقسام التالية للاطّلاع على المواصفات التفصيلية.

ملاحظة حول المصطلحات

لوصف اتجاه حركة بيانات الرسائل، تستخدم شركات النقل الأمريكية عادةً مصطلحات MT/MO. تتوافق هذه المصطلحات مع مصطلحات A2P/P2A المستخدَمة في جميع مستندات "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية":

  • رسائل MT (الموجّهة إلى الأجهزة الجوّالة) هي رسائل A2P (من التطبيقات إلى الأشخاص): وهي رسالة يرسلها النشاط التجاري.
  • الرسالة الصادرة من الجهاز الجوّال (MO) هي رسالة من شخص إلى تطبيق (P2A): رسالة أو إجراء يبدأه المستخدم.

فوترة الأحداث من التطبيقات إلى الأشخاص (A2P/MT)

يتناول هذا القسم منطق الفوترة للرسائل التي يرسلها وكيل (أي رسائل من التطبيق إلى المستخدم أو رسائل نصية قصيرة).

الرسائل الغنية بصريًا (من التطبيق إلى المستخدم)

يتم تصنيف الرسالة على أنّها "رسالة غنية التنسيق" إذا كانت تحتوي فقط على مجموعة من العناصر التالية:

منطق الفوترة للرسائل التفاعلية

يتم تحصيل رسوم مقابل "الرسالة التفاعلية" استنادًا إلى الأجزاء.

  • حجم الجزء: جزء واحد = 160 بايت من النص المرمّز بتنسيق UTF-8.
  • الاحتساب: يتم تقسيم إجمالي طول بايت UTF-8 لنص الرسالة على 160 ويتم دائمًا تقريبه إلى أقرب عدد صحيح.
  • الاستثناءات: لا يتم تضمين النص وبيانات الإرسال اللاحق ضمن الردود أو الإجراءات المقترَحة في عدد الأقسام.
  • مثال: تحتوي رسالة نصية مؤلّفة من 300 بايت على جزأين (300 / 160 = 1.875، تم تقريبها إلى 2).

عدد وحدات البايت

بعض أحرف يونيكود (مثل رموز الإيموجي أو الأحرف التي تتضمّن علامات تشكيل) هي أحرف متعددة البايتات، لذا قد يختلف إجمالي عدد بايتات UTF عن عدد الأحرف.

للاطّلاع على عدد وحدات البايت الدقيق للرسالة، اكتبها أو الصقها أدناه.

رسائل الوسائط التفاعلية المتقدّمة (من التطبيق إلى المستخدم)

يتم تصنيف الرسالة على أنّها رسالة وسائط غنية إذا كانت تتضمّن عنصرًا واحدًا على الأقل من العناصر التالية:

منطق الفوترة لرسائل الوسائط التفاعلية المتقدّمة

تتم فوترة "رسالة الوسائط المتعددة التفاعلية" كحدث واحد بسعر ثابت.

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

أمثلة على الردود من واجهة برمجة التطبيقات الخاصة بالرسائل من التطبيق إلى المستخدم

تعرض هذه الأمثلة الحقل richMessageClassification في استجابة ناجحة لطلب بيانات من RBM API للرسائل التي أرسلها الوكيل.

مثال على ردّ من واجهة برمجة التطبيقات بشأن RICH_MESSAGE

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 5
  }
}

مثال على ردّ من واجهة برمجة التطبيقات بشأن RICH_MEDIA_MESSAGE

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

فوترة أحداث Person-to-Agent (P2A/MO)

يتناول هذا القسم الفوترة المتعلقة بالرسائل والإجراءات التي يبدأها المستخدم (أي الرسائل من شخص إلى تطبيق أو الرسائل الواردة من الجوّال).

الرسائل الغنية بصريًا (من المستخدم إلى التطبيق)

يتم تصنيف رسالة المستخدم على أنّها "رسالة غنية التنسيق" إذا كانت تحتوي على نص فقط. ويشمل ذلك كلاً من النص الحر والنص الناتج عن النقر على رد مقترَح. (قد تتضمّن الردود المقترَحة معرّف بيانات ردّ في حمولة الرسالة).

منطق الفوترة: تتم الفوترة استنادًا إلى شرائح الجمهور. للحصول على تفاصيل حول عمليات احتساب عدد الأجزاء، يُرجى الاطّلاع على منطق الفوترة للرسائل التفاعلية.

رسائل الوسائط التفاعلية المتقدّمة (من المستخدم إلى التطبيق)

يتم تصنيف الرسالة على أنّها رسالة وسائط تفاعلية متقدمة إذا كانت تحتوي على ملف تم تحميله (صورة أو فيديو أو صوت).

منطق الفوترة: يتم تحصيل الرسوم كحدث واحد بسعر ثابت. لا ينطبق التقسيم إلى شرائح.

النقرات على الإجراءات المقترَحة

يؤدي النقر على أي إجراء مقترَح إلى إنشاء حدث قابل للفوترة يُعرف باسم "النقر على إجراء مقترَح". (قد تتضمّن الإجراءات المقترَحة معرّف بيانات الإبلاغ عن الإحالات الناجحة في حمولة الرسالة).

منطق الفوترة: يتم إنشاء حدث واحد قابل للفوترة لكل نقرة.

حالة خاصة: مشاركة الموقع الجغرافي

تتميّز ميزة "مشاركة الموقع الجغرافي" بأنّها تنشئ حدثَين منفصلَين قابلَين للفوترة من شخص إلى تطبيق:

أمثلة على ردود الويب هوك من المستخدم إلى التطبيق

تعرض هذه الأمثلة الحقل richMessageClassification في خطافات الويب المُرسَلة إلى الوكيل للأحداث التي يبدأها المستخدم.

مثال على ردّ تلقائي على الويب لرسالة RICH_MESSAGE أرسلها مستخدم

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "text": "Hello, world!",
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 1
  }
}

مثال على ردّ تلقائي على الويب لرسالة RICH_MEDIA_MESSAGE أرسلها مستخدم

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "userFile": "...",
  "payload": "...",
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

مثال على رابط خارجي لـ SUGGESTED_ACTION_CLICK

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "suggestionResponse": {
        "text": "Click here",
        "postbackData": "...",
        "type": "ACTION"
    },
    "richMessageClassification": {
        "classificationType": "SUGGESTED_ACTION_CLICK"
    }
}

مثال على webhook لرسالة موقع جغرافي

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

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "location": {
      "latitude": 37.422000,
      "longitude": -122.084056
    },
    "richMessageClassification": {
        "classificationType": "RICH_MESSAGE",
        "segmentCount": 1
    }
}

ملاحظات فنية وملاحظات حول التنفيذ

  • التقسيمات مخصّصة لأغراض الفوترة فقط: يتم تسليم الرسائل الطويلة كوحدة واحدة إلى جهاز المستخدم. عدد الشرائح هو عملية حسابية افتراضية لأغراض الفوترة، ولا يؤثّر في طريقة تسليم الرسائل أو عرضها للمستخدم.
  • التصنيف التلقائي: يتم تصنيف الرسالة تلقائيًا بالكامل استنادًا إلى محتوى الرسالة، ولا يمكن إلغاء هذا التصنيف يدويًا.
  • الطرح: تم تفعيل نموذج الفوترة في الولايات المتحدة على منصة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية" (RCS) في 15 يوليو 2025. واعتبارًا من هذا التاريخ، ستعرض تقارير Google وردود واجهة برمجة التطبيقات التصنيفات الجديدة.