این صفحه فایل‌های داده‌ای را که «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» برای کمک به شرکت‌های مخابراتی ایالات متحده در صدور صورت‌حساب و حسابرسی تحت «چارچوب پیام‌رسانی تجاری منطقه‌ای ایالات متحده» ایجاد می‌کند شرح می‌دهد. برای کسب اطلاعات بیشتر درباره «چارچوب RBM ایالات متحده»، می‌توانید به usrbm.org نیز مراجعه کنید.
گزارش صورت‌حساب گزارش تجمیعی رویدادهای صورت‌حساب‌دار بین کاربران و نمایندگان راه‌اندازی‌شده است. صورتحسابپذیر به‌سادگی به این معنی است که رویدادی برای کسر هزینه واجدشرایط است. شرکت‌های مخابراتی تعیین می‌کنند که آیا و چگونه هزینه رویدادهای صورت‌حساب‌دار دریافت شود. همه شرکت‌های مخابراتی ایالات متحده که فعالانه «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» را ارائه می‌دهند به گزارش‌های صورت‌حساب دسترسی دارند.
برای جزئیات مربوط به مدل طبقه‌بندی صورت‌حساب ایالات متحده، به پرسشگان صورت‌حساب ایالات متحده مراجعه کنید.
تولید فایل
برای اطلاعات بیشتر، به تولید فایل مراجعه کنید.
ذخیره‌سازی و دسترسی به فایل
برای اطلاعات بیشتر، فضای ذخیره‌سازی و دسترسی به فایل را ببینید.
دردسترس بودن فایل
برای اطلاعات بیشتر، به دردسترس بودن فایل مراجعه کنید.
گزارش‌های صورت‌حساب
گزارش‌های صورت‌حساب سوابق رویدادهای صورتحسابپذیر است که براساس دسته صورت‌حساب کارگزار و نوع پیام‌هایی که ارسال می‌کند محاسبه می‌شود. گزارش‌های صورت‌حساب برای همه شرکت‌های مخابراتی که به‌طور فعال از «سرویس‌های ارتباطی غنی برای کسب‌وکار» استفاده می‌کنند دردسترس است.
گزارش‌های صورت‌حساب حاوی اطلاعات محرمانه است، اما حاوی «اطلاعات شناساننده شخصی» (PII) کاربر، مثل MSISDN، MSISDN درهم‌سازی‌شده، یا هر شناسه یکتای کاربر نیست.
دسته‌های صورت‌حساب دربرابر رویدادهای صورتحسابپذیر
تفاوت بین دسته‌های صورت‌حساب کارگزار و رویدادهای صورتحسابپذیر برای درک نحوه صورتحسابپذیر بودن کارگزار شما کلیدی است.
- دسته صورت‌حساب یک طبقه‌بندی ثابت است که هنگام ایجاد عامل خود انتخاب می‌کنید. این تنظیم روش صورت‌حساب عاملتان را تعیین می‌کند: براساس پیام (عامل‌های غیرمکالمه‌ای) یا براساس جلسه (عامل‌های مکالمه‌ای).
- رویدادهای صورتحسابپذیر تعاملات بین عامل «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» و کاربر است که برای اهداف صورت‌حساب ردیابی می‌شوند (برای مثال،
rich_message).
دسته‌های صورت‌حساب کارگزار ایالات متحده
هنگام ایجاد عامل، مالک براساس نحوه تعامل عامل با کاربران، دسته صورت‌حساب آن را تنظیم می‌کند. دسته صورت‌حساب تعداد یا نوع پیام‌هایی را که نماینده می‌تواند ارسال کند محدود نمی‌کند. اما تعیین می‌کند عامل چگونه برای پیام‌ها صورت‌حساب دریافت کند. دو دسته اصلی صورت‌حساب در جدول زیر توضیح داده شده است.
| دسته صورت‌حساب | نوع نماینده | موارد استفاده نمونه | روش صدور صورت‌حساب |
|---|---|---|---|
| غیرمکالمه‌ای | نمایندگانی که عمدتاً پیام‌های یک‌طرفه ارسال می‌کنند. |
|
برای هر پیامی که به کاربر تحویل داده می‌شود، هزینه دریافت می‌شود. |
| مکالمه‌ای | عامل‌هایی که برای تبادل‌های رفت‌وبرگشتی با کاربران طراحی شده‌اند، صرف‌نظر از اینکه چه کسی مکالمه را شروع می‌کند. |
|
قابل‌پرداخت به‌ازای هر جلسه: اگر معیارهای جلسه برآورده شود، همه پیام‌های غنی و رسانه‌های غنی در پنجره جلسه ۲۴ ساعته با نرخ ثابت قابل‌پرداخت هستند، صرف‌نظر از طول یا بخش‌ها. قابل‌پرداخت به‌ازای هر پیام: اگر معیارهای جلسه برآورده نشود یا پیامی خارج از پنجره جلسه ۲۴ ساعته قرار گیرد، پیام به‌صورت جداگانه با نرخ هر پیام برای رسانه‌های غنی یا غنی طبق کارت نرخ شرکت مخابراتی مربوطه قابل‌پرداخت است. |
عامل‌های مکالمه‌ای دربرابر عامل‌های غیرمکالمه‌ای
دو دسته صورت‌حساب عامل وجود دارد: مکالمه‌ای و غیرمکالمه‌ای.
کارگزاران غیرمکالمه‌ای برای هر پیامی که به کاربر تحویل می‌دهند صورت‌حساب می‌شوند.
- این دسته برای نمایندگانی که انتظار پاسخ‌های مکرر ندارند بهترین است.
کارمزد نمایندگان مکالمه‌ای براساس نرخ ثابت برای جلسه(ها) محاسبه می‌شود، به‌شرطی که جلسه راه‌اندازی شود و سپس همه پیام‌های ردوبدل‌شده در یک دوره ۲۴ ساعته، ازجمله پیام‌هایی که جلسه راه‌اندازی کرده‌اند، در آن گنجانده شود. کارگزاران مکالمه‌ای همچنان می‌توانند برای پیام‌هایی که بخشی از جلسه ۲۴ ساعته نیستند هزینه داشته باشند.
- این دسته برای نمایندگانی که با کاربران در مکالمه‌های چند نوبتی شرکت می‌کنند بهترین گزینه است.
منطق صورت‌حساب جلسه
تحت مدل «صدور صورت‌حساب ایالات متحده»، جلسه با توالی ۴ پیام رسانه غنی یا پیام رسانه غنی (شامل حداقل ۲ پیام MO و حداقل ۱ پیام MT) که در بازه زمانی ۲۴ ساعته از اولین پیام در توالی راه‌انداز مبادله شده است راه‌اندازی می‌شود. پس‌از رسیدن به این آستانه، همه پیام‌های داخل آن بازه زمانی ۲۴ ساعته به‌صورت یک جلسه صورت‌حساب می‌شوند. هر پیامی که خارج از جلسه باشد یا نتواند جلسه را راه‌اندازی کند، براساس نرخ استاندارد به‌ازای هر پیام برای رسانه تعاملی یا رسانه تعاملی غنی طبق کارت نرخ اپراتور تلفن همراه فرد صورت‌حساب می‌شود.
نمودار زیر نمونه‌ای از جلسه صورت‌حساب A2P برای عامل‌های مکالمه‌ای را نشان می‌دهد.
- MT (Mobile Terminated) پیامی است که کسب‌وکار ارسال می‌کند.
- MO (Mobile Originated) به پیام یا کنشی گفته می‌شود که کاربر آغاز می‌کند.
رویدادهای صورتحسابپذیر
جریان‌های پیام براساس مبدأ و جهت آن‌ها دسته‌بندی می‌شوند. شرکت‌های مخابراتی ایالات متحده معمولاً از اصطلاحات MT/MO برای توصیف جهت ترافیک پیام‌رسانی استفاده می‌کنند. این اصطلاحات با اصطلاحات A2P/P2A که در سراسر اسناد «RCS ویژه کسب‌وکارها» استفاده می‌شود مطابقت دارد. در اینجا تفکیک سریعی از نحوه هم‌راستا شدن این اصطلاحات آورده شده است:
- A2P (برنامه به شخص) همان MT (پایانه تلفن همراه) است: پیامی که کسب‌وکار ارسال می‌کند.
- P2A (شخص به برنامه) همان MO (از تلفن همراه) است: پیام یا کنش آغازشده توسط کاربر.
| رویداد | شرح | عامل‌های غیرمکالمه‌ای | عامل‌های مکالمه‌ای |
|---|---|---|---|
a2p_rich_message |
پیام ارسالی ازسوی نماینده که فقط حاوی نوشتار، پاسخ‌های پیشنهادی، یا کنش‌های پیشنهادی خاص (شماره‌گیری، باز کردن نشانی وب در مرورگر) باشد. | همیشه به‌عنوان رویداد صورتحسابپذیر جداگانه درنظر گرفته می‌شود. براساس بخش‌ها برای هر پیام هزینه دریافت می‌شود (۱ بخش برابر با ۱۶۰ بایت UTF-8 است). |
به‌عنوان رویداد صورتحسابپذیر فردی درنظر گرفته می‌شود، مگراینکه بخشی از جلسه شود. |
p2a_rich_message |
پیام ارسالی کاربر که فقط حاوی نوشتار آزاد یا نوشتار از ضربه زدن روی پاسخ پیشنهادی است. | همیشه به‌عنوان رویداد صورتحسابپذیر جداگانه درنظر گرفته می‌شود. براساس بخش‌ها، به‌ازای هر پیام هزینه دریافت می‌شود. |
به‌عنوان رویداد صورتحسابپذیر فردی درنظر گرفته می‌شود، مگراینکه بخشی از جلسه شود. |
a2p_rich_media_message |
پیام ارسال‌شده توسط کارگزار حاوی رسانه (تصویر، ویدیو، صدا)، کارت‌های غنی، گردونه‌ها، یا کنش‌های پیچیده مانند «مشاهده مکان». | همیشه به‌عنوان رویداد صورتحسابپذیر جداگانه درنظر گرفته می‌شود. صرف‌نظر از اندازه یا محتوا، به‌عنوان یک رویداد با نرخ ثابت صورت‌حساب می‌شود. |
به‌عنوان رویداد صورتحسابپذیر فردی درنظر گرفته می‌شود، مگراینکه بخشی از جلسه شود. |
p2a_rich_media_message |
پیام ارسالی کاربر حاوی فایل رسانه‌ای بارگذاری‌شده (تصویر، ویدیو، صدا). | همیشه به‌عنوان رویداد صورتحسابپذیر جداگانه درنظر گرفته می‌شود. به‌صورت رویداد تک‌نرخی صورتحسابپذیر است. |
به‌عنوان رویداد صورتحسابپذیر فردی درنظر گرفته می‌شود، مگراینکه بخشی از جلسه شود. |
p2a_suggested_action |
کاربر روی هر کنش پیشنهادی (برای نمونه، «مشاهده مکان») که پاسخ پیشنهادی نیست تک‌ضرب می‌زند. | همیشه به‌عنوان رویداد صورتحسابپذیر جداگانه درنظر گرفته می‌شود. به‌ازای هر کلیک، یک رویداد قابل‌پرداخت تولید می‌کند. |
به‌عنوان رویداد قابل‌پرداخت تکی درنظر گرفته می‌شود و به‌ازای هر کلیک یک رویداد قابل‌پرداخت تولید می‌کند، مگر اینکه بخشی از جلسه شود. |
a2p_session |
پنجره تعامل ۲۴ ساعته که وقتی راه‌انداز جلسه شروع می‌شود و اولین پیام MT است آغاز می‌شود. برای اطلاعات بیشتر، به جلسه چیست و چگونه کار می‌کند مراجعه کنید. | موجود نیست. جلسه‌ها برای نمایندگان غیرمکالمه‌ای اعمال نمی‌شود. | پس‌از راه‌اندازی، همه پیام‌های ارسالی در بازه ۲۴ ساعته تحت پوشش کارمزد جلسه واحد قرار می‌گیرند. هر رویداد صورت‌حساب‌دار در جلسه ۲۴ ساعته به شناسه رویداد صورت‌حساب‌دار جلسه اختصاص داده می‌شود. |
p2a_session |
پنجره تعامل ۲۴ ساعته که وقتی راه‌انداز جلسه شروع می‌شود و اولین پیام MO است آغاز می‌شود. برای اطلاعات بیشتر، به جلسه چیست و چگونه کار می‌کند مراجعه کنید. | موجود نیست. جلسه‌ها برای نمایندگان غیرمکالمه‌ای اعمال نمی‌شود. | پس‌از راه‌اندازی، همه پیام‌های ارسالی در بازه ۲۴ ساعته تحت پوشش کارمزد جلسه واحد قرار می‌گیرند. هر رویداد صورت‌حساب‌دار در جلسه ۲۴ ساعته به شناسه رویداد صورت‌حساب‌دار جلسه اختصاص داده می‌شود. |
تولید گزارش صورت‌حساب
فقط کارگزارانی که ترافیک غیرآزمایشی دارند رویدادهای صورت‌حساب‌دار تولید می‌کنند. فعالیت شماره تلفن‌های آزمایشی در گزارش‌های صورت‌حساب نشان داده نمی‌شود.
این گزارش‌ها فرض می‌کنند که رویدادها زمانی قابل‌پرداخت هستند که پیام‌های A2P تحویل داده می‌شوند، نه زمانی که پیام‌ها ارسال می‌شوند. پیام تحویل‌نشده یا پیامی که قبل‌از تحویل لغو شده است باعث ایجاد رویداد صورت‌حساب‌دار نمی‌شود.
قالب گزارش صورت‌حساب
گزارش‌های صورت‌حساب از قالب نام فایل rbm_billable_events_YYYY-MM-DD.csv استفاده می‌کنند.
تاریخ موجود در نام فایل، تاریخ تولید فایل است.
هر خط در گزارش یک سابقه است که نشان‌دهنده یک رویداد صورت‌حساب‌شدنی است.
جلسه‌های A2P/P2A با چند ردیف نشان داده می‌شوند—یک ردیف برای هر پیام
ردوبدل‌شده. هر ردیف مرتبط با یک جلسه (با
billing_event_id یکسان) تعداد کل پیام‌های MT و MO را برای
کل پنجره جلسه ۲۴ ساعته در ستون‌های mt_messages و mo_messages گزارش خواهد کرد.
فایل‌ها بدون علامت ترتیب بایت در قالب UTF-8 کدبندی می‌شوند و از فیدهای خط برای پایان خط استفاده می‌کنند. خط اول هر فایل ردیف سرصفحه با نام‌های فیلد است.
هر رکورد در گزارش حاوی اطلاعات زیر برای هر رویداد صورت‌حساب‌شدنی است.
| فیلد | قالب | شرح | مثال |
|---|---|---|---|
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 |
max_duration_p2a_conversation |
شماره | برای پایلوت جلسات، این مقدار نشان‌دهنده پنجره جلسه ۲۴ ساعته است که از اولین پیام در توالی راه‌انداز اندازه‌گیری می‌شود. | 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 |
شماره | مدت زمان فقط مربوط به جلسه‌ها است و برحسب دقیقه اندازه‌گیری می‌شود. وقتی رویداد غیرجلسه‌ای باشد، مقدار ۰ است. | ۴۵ |
mt_messages |
شماره | تعداد پیام‌های خاتمه‌یافته تلفن همراه (A2P) در رویداد. برای جلسه‌ها، هر ردیفی که billing_event_id یکسانی را هم‌رسانی می‌کند تعداد کل پیام‌های ترجمه ماشینی در کل جلسه را نشان می‌دهد. |
5 |
mo_messages |
شماره | تعداد پیام‌های آغازشده از تلفن همراه (P2A) در رویداد. برای جلسه‌ها، هر ردیف که billing_event_id یکسانی را هم‌رسانی می‌کند تعداد کل پیام‌های MO را در کل جلسه نشان می‌دهد. |
3 |
size_kilobytes |
شماره | اندازه همه فایل‌های پیوست‌شده به پیام‌های رویداد، گردشده به نزدیک‌ترین کیلوبایت (۱ کیلوبایت برابر با ۱۰۲۴ بایت است). | 912 |
agent_name |
رشته | نام کارگزاری که در رویداد شرکت کرده است. | ACME Brand |
owner_name |
رشته | نام مالک فعلی حساب شریک که نماینده در آن ایجاد شده است. | XYZ Aggregator |
segment_count |
شماره | تعداد بخش محاسبه‌شده برای رویدادهای a2p_rich_message events و p2a_rich_message (۱ بخش برابر با ۱۶۰ بایت UTF-8 است). وقتی رویداد یکی از موارد ذکرشده نباشد، مقدار ۰ است. |
5 |
session_type |
رشته | نوع جلسه:a2p_sessionp2a_session |
a2p_session |
گزارش صورت‌حساب نمونه
گزارش نمونه برای بارگیری دردسترس است:
اندازه معمول فایل
اندازه گزارش روزانه از شریک فعال «سرویس‌های ارتباطی غنی برای کسب‌وکار» به میزان فعالیت او در شبکه شرکت مخابراتی بستگی دارد.