মার্কিন বিলিং মডেল

এই নথিতে মার্কিন ক্যারিয়ারগুলিতে RCS for Business ট্র্যাফিকের বিলিং মডেলের রূপরেখা দেওয়া হয়েছে।

মার্কিন বিলিং শ্রেণীবিভাগের সংক্ষিপ্ত বিবরণ

মার্কিন ফোন নম্বরে পাঠানো বা সেখান থেকে আসা প্রতিটি বার্তা তার ফরম্যাটের উপর ভিত্তি করে স্বয়ংক্রিয়ভাবে নিম্নলিখিত প্রকারগুলির মধ্যে একটিতে শ্রেণীবদ্ধ করা হয়:

  • রিচ মেসেজ (দ্বিমুখী)
  • রিচ মিডিয়া বার্তা (দ্বিমুখী)

একাধিক ধরনের বার্তা একটি সেশনে একত্রিত করা যেতে পারে। সেশন সম্পর্কে আরও তথ্যের জন্য, সেশন বিলিং (পাইলট) দেখুন।

বিস্তারিত বিবরণের জন্য নিম্নলিখিত বিভাগগুলি দেখুন।

পরিভাষা সংক্রান্ত একটি টীকা

মেসেজিং ট্র্যাফিকের দিক বর্ণনা করার জন্য, মার্কিন ক্যারিয়ারগুলো সাধারণত MT/MO পরিভাষা ব্যবহার করে। এই পরিভাষাগুলো RCS for Business ডকুমেন্টেশন জুড়ে ব্যবহৃত A2P/P2A পরিভাষার অনুরূপ:

  • এমটি (মোবাইল টার্মিনেটেড) হলো এ২পি (অ্যাপ্লিকেশন-টু-পার্সন) : ব্যবসা প্রতিষ্ঠান কর্তৃক প্রেরিত একটি বার্তা।
  • MO (মোবাইল থেকে উদ্ভূত) হলো P2A (ব্যক্তি থেকে অ্যাপ্লিকেশন) : ব্যবহারকারীর দ্বারা শুরু করা একটি বার্তা বা কার্যকলাপ।

এজেন্ট-টু-পার্সন (A2P/MT) ইভেন্ট বিলিং

এই বিভাগে এজেন্টের পাঠানো মেসেজের (অর্থাৎ, A2P বা MT মেসেজ) বিলিং লজিক নিয়ে আলোচনা করা হয়েছে।

সমৃদ্ধ বার্তা (এ২পি)

একটি বার্তাকে রিচ মেসেজ হিসেবে শ্রেণীবদ্ধ করা হয়, যদি তাতে শুধুমাত্র নিম্নলিখিত উপাদানগুলোর সংমিশ্রণ থাকে:

রিচ মেসেজের জন্য বিলিং লজিক

রিচ মেসেজের বিল সেগমেন্ট অনুযায়ী নির্ধারণ করা হয়।

  • সেগমেন্টের আকার : ১ সেগমেন্ট = ১৬০ বাইট UTF-8 এনকোডেড টেক্সট।
  • গণনা : বার্তার টেক্সটের মোট UTF-8 বাইট দৈর্ঘ্যকে ১৬০ দ্বারা ভাগ করা হয় এবং সর্বদা নিকটতম পূর্ণ সংখ্যায় উন্নীত করা হয়।
  • বর্জন : প্রস্তাবিত উত্তর বা ক্রিয়াকলাপের মধ্যে থাকা টেক্সট এবং পোস্টব্যাক ডেটা সেগমেন্ট গণনার অন্তর্ভুক্ত নয়
  • উদাহরণ : একটি ৩০০-বাইট টেক্সট মেসেজে ২টি সেগমেন্ট থাকে (৩০০ / ১৬০ = ১.৮৭৫, যা ২-এ উন্নীত করা হয়েছে)।

বাইট গণনা

কিছু ইউনিকোড ক্যারেক্টার (যেমন ইমোজি বা অ্যাকসেন্টেড অক্ষর) মাল্টি-বাইট হওয়ায়, মোট UTF-বাইট সংখ্যা ক্যারেক্টার সংখ্যা থেকে ভিন্ন হতে পারে।

কোনো বার্তার সঠিক বাইট সংখ্যা জানতে, সেটি নিচে টাইপ বা পেস্ট করুন।

রিচ মিডিয়া মেসেজ (এ২পি)

একটি বার্তাকে রিচ মিডিয়া বার্তা হিসেবে শ্রেণীবদ্ধ করা হয়, যদি তাতে নিম্নলিখিতগুলির মধ্যে অন্তত একটি অন্তর্ভুক্ত থাকে:

রিচ মিডিয়া মেসেজের জন্য বিলিং লজিক

একটি রিচ মিডিয়া মেসেজকে একটি একক, নির্দিষ্ট মূল্যের ইভেন্ট হিসেবে বিল করা হয়।

  • টেক্সটের দৈর্ঘ্য, কার্ডের সংখ্যা বা মিডিয়া ফাইলের আকার নির্বিশেষে বিলিং একই থাকে।
  • বিভাজন প্রযোজ্য নয়।

A2P এপিআই প্রতিক্রিয়ার উদাহরণ

এই উদাহরণগুলো এজেন্ট কর্তৃক প্রেরিত মেসেজের জন্য একটি সফল RBM API কল রেসপন্সে থাকা richMessageClassification ফিল্ডটি প্রদর্শন করে।

RICH_MESSAGE এর জন্য API প্রতিক্রিয়ার উদাহরণ

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

RICH_MEDIA_MESSAGE এর জন্য API প্রতিক্রিয়ার উদাহরণ

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

ব্যক্তি-থেকে-এজেন্ট (P2A/MO) ইভেন্ট বিলিং

এই বিভাগে ব্যবহারকারীর দ্বারা শুরু করা বার্তা এবং কার্যকলাপের (অর্থাৎ, P2A বা MO বার্তা) বিলিং অন্তর্ভুক্ত রয়েছে।

সমৃদ্ধ বার্তা (পি২এ)

একটি ব্যবহারকারীর বার্তাকে রিচ মেসেজ হিসেবে শ্রেণীবদ্ধ করা হয় যদি তাতে শুধুমাত্র টেক্সট থাকে। এর মধ্যে স্বতঃস্ফূর্ত টেক্সট এবং কোনো প্রস্তাবিত উত্তরে ট্যাপ করার ফলে প্রাপ্ত টেক্সট উভয়ই অন্তর্ভুক্ত। (প্রস্তাবিত উত্তরগুলোর মেসেজ পেলোডে একটি পোস্টব্যাক ডেটা আইডেন্টিফায়ার থাকতে পারে।)

বিলিং লজিক : সেগমেন্টের ভিত্তিতে বিল করা হয়। সেগমেন্ট সংখ্যা গণনার বিস্তারিত জানতে ‘রিচ মেসেজের বিলিং লজিক’ দেখুন।

রিচ মিডিয়া বার্তা (পি২এ)

কোনো বার্তায় আপলোড করা ফাইল (ছবি, ভিডিও, অডিও) থাকলে, সেটিকে রিচ মিডিয়া মেসেজ হিসেবে শ্রেণীবদ্ধ করা হয়।

বিলিং লজিক : একটি একক, নির্দিষ্ট মূল্যের ইভেন্ট হিসাবে বিল করা হয়। সেগমেন্টেশন প্রযোজ্য নয়।

প্রস্তাবিত অ্যাকশন ক্লিকগুলি

ব্যবহারকারী কোনো প্রস্তাবিত অ্যাকশনে ট্যাপ করলে 'সাজেস্টেড অ্যাকশন ক্লিক' নামক একটি বিলযোগ্য ইভেন্ট তৈরি হয়। (প্রস্তাবিত অ্যাকশনগুলোর মেসেজ পেলোডে একটি পোস্টব্যাক ডেটা আইডেন্টিফায়ার অন্তর্ভুক্ত থাকতে পারে।)

বিলিং লজিক : প্রতি ক্লিকে একটি বিলযোগ্য ইভেন্ট তৈরি করে।

বিশেষ ক্ষেত্র: অবস্থান শেয়ার করুন

অবস্থান নির্ণয় ও শেয়ারিং এই দিক থেকে অনন্য যে এটি দুটি পৃথক P2A বিলযোগ্য ইভেন্ট তৈরি করে:

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
    }
}

সেশন বিলিং (পাইলট)

যদিও প্রচলিত মার্কিন বিলিং মডেলে প্রতিটি মেসেজের জন্য আলাদাভাবে চার্জ করা হয়, সেশন বিলিং পাইলট প্রকল্পটি ব্যবহারকারী-থেকে-ব্র্যান্ড এবং/অথবা ব্র্যান্ড-থেকে-ব্যবহারকারীর সম্পূর্ণ কথোপকথনকে একটি একক বিলযোগ্য ইভেন্টে p2a_session অথবা a2p_session ) একত্রিত করার একটি উপায় চালু করেছে।

একটানা ২৪-ঘণ্টার মধ্যে নির্দিষ্ট ইন্টারঅ্যাকশন থ্রেশহোল্ডে পৌঁছালে একটি সেশন বিলযোগ্য ইভেন্ট রেকর্ড করা হয় এবং তার জন্য বিল করা হয়। আরও তথ্যের জন্য, ‘সেশন কী এবং এটি কীভাবে কাজ করে’ দেখুন।

প্রযুক্তিগত এবং বাস্তবায়ন নোট

  • সেগমেন্টগুলো শুধুমাত্র বিলিংয়ের উদ্দেশ্যে ব্যবহৃত হয় : দীর্ঘ বার্তাগুলো ব্যবহারকারীর ডিভাইসে একটি একক ইউনিট হিসেবে পৌঁছে দেওয়া হয়। সেগমেন্ট সংখ্যাটি বিলিংয়ের উদ্দেশ্যে করা একটি ভার্চুয়াল গণনা; এটি ব্যবহারকারীর কাছে বার্তা কীভাবে পৌঁছে দেওয়া বা উপস্থাপন করা হবে, তার উপর কোনো প্রভাব ফেলে না।
  • স্বয়ংক্রিয় শ্রেণিবিন্যাস : বার্তার বিষয়বস্তুর উপর ভিত্তি করে বার্তার শ্রেণিবিন্যাস সম্পূর্ণ স্বয়ংক্রিয়ভাবে সম্পন্ন হয় এবং এটি ম্যানুয়ালি পরিবর্তন করা যায় না।
  • বাস্তবায়ন : RCS for Business প্ল্যাটফর্ম জুড়ে মার্কিন বিলিং মডেলটি ১৫ জুলাই, ২০২৫ তারিখে সক্রিয় করা হয়েছে। এই তারিখ থেকে Google-এর রিপোর্টিং এবং API প্রতিক্রিয়াগুলিতে নতুন শ্রেণিবিন্যাস প্রতিফলিত হচ্ছে।