مدل صورتحساب ایالات متحده

این سند، مدل صورتحساب برای ترافیک RCS برای کسب‌وکارها در اپراتورهای آمریکایی را تشریح می‌کند.

مهم: اپراتورهای آمریکایی قیمت انواع پیام‌های قابل پرداخت که در بخش‌های بعدی توضیح داده شده است را تعیین می‌کنند. آنها همچنین هزینه نهایی توسعه‌دهنده برای ارسال پیام‌های RCS برای کسب‌وکار را تعیین می‌کنند. این سند به عنوان یک راهنمای آموزنده در مورد نحوه تعریف انواع پیام‌ها و رویدادهای قابل پرداخت در بازار ایالات متحده عمل می‌کند. برای اطلاعات بیشتر در مورد قیمت‌گذاری یا صورتحساب، لطفاً با نمایندگان اپراتور مربوطه تماس بگیرید.

• برای اطلاعات مربوط به مدل استاندارد صورتحساب (برای ترافیک غیر آمریکایی)، به سوالات متداول صورتحساب مراجعه کنید.
• برای اطلاعات مربوط به گزارش‌دهی، به راهنمای گزارش‌های صورتحساب و گزارش‌های فعالیت مراجعه کنید.

مروری بر طبقه‌بندی‌های صورتحساب ایالات متحده

هر پیام ارسالی یا دریافتی از یک شماره تلفن آمریکایی، بر اساس قالب آن، به طور خودکار در یکی از سه نوع زیر طبقه‌بندی می‌شود:

• پیام غنی (دو طرفه)
• پیام رسانه‌ای غنی (دو طرفه)
• کلیک روی اقدام پیشنهادی (به ابتکار کاربر)

برای مشخصات دقیق به بخش‌های زیر مراجعه کنید.

نکته‌ای در مورد اصطلاحات

برای توصیف جهت ترافیک پیام‌رسانی، اپراتورهای آمریکایی معمولاً از اصطلاحات MT/MO استفاده می‌کنند. این اصطلاحات با اصطلاحات A2P/P2A که در سراسر مستندات RCS for Business استفاده می‌شود، مطابقت دارند:

• MT (موبایل خاتمه یافته) A2P (درخواست به شخص) است : پیامی که توسط کسب و کار ارسال می‌شود.
• MO (Mobile Originated) همان P2A (شخص به برنامه) است : پیام یا عملی که توسط کاربر آغاز می‌شود.

صدور صورتحساب رویداد از طریق عامل به شخص (A2P/MT)

این بخش منطق صورتحساب برای پیام‌های ارسالی توسط یک اپراتور (یعنی پیام‌های A2P یا MT) را پوشش می‌دهد.

پیام‌های غنی (A2P)

یک پیام در صورتی به عنوان پیام غنی (Rich Message) طبقه‌بندی می‌شود که فقط ترکیبی از عناصر زیر را داشته باشد:

• متن
• پاسخ‌های پیشنهادی
• اقدامات پیشنهادی فقط از انواع زیر:
  • شماره گیری کنید
  • URL را در مرورگر استاندارد باز کنید ، نه در نمای وب

منطق پرداخت برای پیام‌های غنی

هزینه یک پیام غنی بر اساس بخش‌ها محاسبه می‌شود.

• اندازه قطعه : ۱ قطعه = ۱۶۰ بایت متن کدگذاری شده UTF-8.
• محاسبه : کل طول بایت‌های متن پیام که به صورت UTF-8 نوشته شده است، بر ۱۶۰ تقسیم شده و همیشه به نزدیکترین عدد صحیح به سمت بالا گرد می‌شود.
• موارد استثنا : متن و داده‌های ارسالی در پاسخ‌ها یا اقدامات پیشنهادی در شمارش بخش‌ها لحاظ نمی‌شوند .
• مثال : یک پیام متنی ۳۰۰ بایتی دارای ۲ بخش است (۳۰۰ / ۱۶۰ = ۱.۸۷۵، گرد شده به بالا به ۲).

تعداد بایت

برخی از کاراکترهای یونیکد (مانند ایموجی‌ها یا حروف برجسته) چند بایتی هستند، بنابراین تعداد کل بایت‌های UTF ممکن است با تعداد کاراکترها متفاوت باشد.

برای بررسی تعداد دقیق بایت‌های یک پیام، آن را در زیر تایپ یا جای‌گذاری کنید.

پیام‌های رسانه‌ای غنی (A2P)

یک پیام در صورتی به عنوان یک پیام رسانه‌ای غنی طبقه‌بندی می‌شود که حداقل یکی از موارد زیر را داشته باشد:

• یک کارت غنی یا یک کارت چرخان (حتی بدون رسانه)
• پیوست فایل رسانه‌ای (تصویر، ویدئو، صدا)
• یک اقدام پیشنهادی غیر از شماره گیری شماره یا باز کردن URL با مرورگر، از جمله:
  • مشاهده مکان
  • اشتراک‌گذاری مکان
  • ایجاد رویداد تقویم
  • باز کردن URL در یک وب ویو

منطق پرداخت برای پیام‌های رسانه‌ای غنی

یک پیام رسانه‌ای غنی به عنوان یک رویداد واحد و با نرخ ثابت ارائه می‌شود.

• هزینه صرف نظر از طول متن، تعداد کارت‌ها یا اندازه فایل رسانه‌ای یکسان است.
• تقسیم‌بندی اعمال نمی‌شود.

مثال‌های پاسخ API A2P

این مثال‌ها فیلد richMessageClassification را در پاسخ فراخوانی موفق RBM API برای پیام‌های ارسالی توسط عامل نشان می‌دهند.

نمونه پاسخ API برای یک RICH_MESSAGE

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

نمونه پاسخ API برای یک RICH_MEDIA_MESSAGE

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

صدور صورتحساب رویداد از شخص به نماینده (P2A/MO)

این بخش شامل محاسبه‌ی هزینه‌ی پیام‌ها و اقداماتی است که توسط کاربر آغاز می‌شود (یعنی پیام‌های P2A یا MO).

پیام‌های غنی (P2A)

یک پیام کاربر در صورتی به عنوان یک پیام غنی طبقه‌بندی می‌شود که فقط شامل متن باشد. این شامل متن آزاد و متنی است که از ضربه زدن روی یک پاسخ پیشنهادی حاصل می‌شود. (پاسخ‌های پیشنهادی ممکن است شامل یک شناسه داده پس‌پست در محتوای پیام باشند.)

منطق صورتحساب : صورتحساب بر اساس بخش‌ها محاسبه می‌شود. برای جزئیات بیشتر در مورد محاسبات تعداد بخش‌ها، به منطق صورتحساب برای پیام‌های غنی مراجعه کنید.

پیام‌های رسانه‌ای غنی (P2A)

یک پیام در صورتی به عنوان یک پیام رسانه‌ای غنی طبقه‌بندی می‌شود که حاوی یک فایل آپلود شده (تصویر، ویدئو، صدا) باشد.

منطق صدور صورتحساب : به عنوان یک رویداد واحد و با نرخ ثابت صورتحساب می‌شود. تقسیم‌بندی اعمال نمی‌شود.

کلیک‌های پیشنهادی برای اقدام

ضربه کاربر روی هر اقدام پیشنهادی، یک رویداد قابل پرداخت به نام «کلیک اقدام پیشنهادی» ایجاد می‌کند. (اقدامات پیشنهادی ممکن است شامل یک شناسه داده پس‌پست در محتوای پیام باشند.)

منطق صورتحساب : به ازای هر کلیک، یک رویداد قابل پرداخت ایجاد می‌کند.

توجه: ضربه کاربر روی یک پاسخ پیشنهادی (که متن ارسال می‌کند) باعث ایجاد کلیک اقدام پیشنهادی نمی‌شود. در عوض، پیام حاصل به عنوان یک پیام غنی (Rich Message ) قابل پرداخت است.

مورد خاص: اشتراک‌گذاری مکان

اشتراک‌گذاری موقعیت مکانی از این جهت منحصر به فرد است که دو رویداد جداگانه‌ی P2A با قابلیت پرداخت هزینه ایجاد می‌کند:

• کلیک روی اقدام پیشنهادی : ضربه کاربر روی اقدام پیشنهادی اشتراک‌گذاری مکان، یک رویداد کلیک روی اقدام پیشنهادی ایجاد می‌کند.

• پیام موقعیت مکانی: پس از اینکه کاربر مکانی را از رابط نقشه انتخاب کرد، پیامی حاوی مختصات مکان به عامل ارسال می‌شود. این پیام MO یک رویداد Rich Message با تعداد قطعه یک ایجاد می‌کند.

نمونه‌هایی از پاسخ‌های وب‌هوک P2A

این مثال‌ها فیلد 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"
    }
}

مثال وب هوک برای پیام موقعیت مکانی

این دومین رویداد قابل پرداخت در جریان اشتراک‌گذاری مکان است که پس از اشتراک‌گذاری مکان کاربر از روی نقشه ارسال می‌شود.

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

نکات فنی و اجرایی

• بخش‌ها فقط برای اهداف صورتحساب هستند : پیام‌های طولانی به صورت یک واحد به دستگاه کاربر تحویل داده می‌شوند. تعداد بخش‌ها یک محاسبه مجازی برای اهداف صورتحساب است؛ این محاسبه بر نحوه تحویل یا ارائه پیام‌ها به کاربر تأثیری ندارد.
• طبقه‌بندی خودکار : طبقه‌بندی پیام‌ها بر اساس محتوای پیام کاملاً خودکار است و نمی‌توان آن را به صورت دستی لغو کرد.
• راه‌اندازی : مدل صورتحساب ایالات متحده در ۱۵ ژوئیه ۲۰۲۵ در سراسر پلتفرم RCS for Business فعال شد. از این تاریخ به بعد، گزارش‌ها و پاسخ‌های API گوگل، طبقه‌بندی‌های جدید را منعکس می‌کنند.