Trang này mô tả các tệp dữ liệu mà RCS for Business tạo ra để hỗ trợ các nhà mạng ở Hoa Kỳ trong việc lập hoá đơn và kiểm toán theo Khung RBM của Hoa Kỳ. Để tìm hiểu thêm về Khuôn khổ RBM của Hoa Kỳ, bạn cũng có thể tham khảo trang usrbm.org.
Báo cáo thanh toán là một báo cáo tổng hợp về các sự kiện có tính phí giữa các tác nhân đã ra mắt và người dùng. Có thể lập hoá đơn chỉ có nghĩa là một sự kiện đủ điều kiện để tính phí. Nhà mạng sẽ xác định xem có tính phí các sự kiện có tính phí hay không và cách tính phí. Tất cả nhà mạng ở Hoa Kỳ đang sử dụng RCS for Business đều có quyền truy cập vào báo cáo thanh toán.
Để biết thông tin chi tiết về mô hình phân loại thông tin thanh toán tại Hoa Kỳ, hãy tham khảo Câu hỏi thường gặp về thông tin thanh toán tại Hoa Kỳ.
Tạo tệp
Để biết thêm thông tin, hãy xem phần Tạo tệp.
Lưu trữ và truy cập tệp
Để biết thêm thông tin, hãy xem phần Lưu trữ và truy cập tệp.
Tính sẵn có của tệp
Để biết thêm thông tin, hãy xem phần Tình trạng cung cấp tệp.
Báo cáo thanh toán
Báo cáo thanh toán là bản ghi về sự kiện có tính phí, được tính dựa trên danh mục thanh toán của tác nhân và loại thông báo mà tác nhân gửi. Tất cả những nhà mạng đang tích cực vận hành RCS for Business đều có thể sử dụng báo cáo thanh toán.
Báo cáo thanh toán chứa thông tin mật nhưng không chứa Thông tin nhận dạng cá nhân (PII) của người dùng, chẳng hạn như MSISDN, MSISDN đã băm hoặc bất kỳ giá trị nhận dạng duy nhất nào của người dùng.
Danh mục thanh toán so với sự kiện có thể lập hoá đơn
Sự khác biệt giữa danh mục thanh toán của tác nhân và sự kiện có thể tính phí là yếu tố then chốt để hiểu cách tính phí cho tác nhân của bạn.
- Danh mục thanh toán là một phân loại cố định mà bạn chọn khi tạo tác nhân. Thông số này xác định phương thức mà tác nhân của bạn có thể tính phí: theo mỗi tin nhắn (tác nhân không đàm thoại) hoặc theo mỗi phiên (tác nhân đàm thoại).
- Sự kiện có thể lập hoá đơn là những lượt tương tác giữa một nhân viên hỗ trợ RCS for Business và người dùng được theo dõi cho mục đích thanh toán (ví dụ:
rich_message).
Danh mục thanh toán của đại lý tại Hoa Kỳ
Khi tạo một tác nhân, chủ sở hữu sẽ đặt danh mục thanh toán dựa trên cách tác nhân sẽ tương tác với người dùng. Danh mục thanh toán không hạn chế số lượng hoặc loại tin nhắn mà nhân viên hỗ trợ có thể gửi. Tuy nhiên, thông tin này sẽ xác định cách tính phí cho tác nhân đối với các tin nhắn. Hai danh mục thanh toán chính được mô tả trong bảng sau.
| Danh mục thanh toán | Loại nhân viên hỗ trợ | Ví dụ về các trường hợp sử dụng | Phương thức thanh toán |
|---|---|---|---|
| Không liên quan đến hoạt động trò chuyện | Những tác nhân chủ yếu gửi tin nhắn một chiều. |
|
Tính phí cho mỗi thông báo được gửi đến người dùng. |
| Đàm thoại | Nhân viên hỗ trợ được thiết kế để trao đổi qua lại với người dùng, bất kể ai bắt đầu cuộc trò chuyện. |
|
Tính phí theo phiên: Nếu đáp ứng các tiêu chí về phiên, tất cả tin nhắn đa dạng và nội dung đa phương tiện trong khung thời gian 24 giờ của phiên đều được tính phí theo mức cố định, bất kể độ dài hay phân đoạn. Tính phí theo tin nhắn: Nếu không đáp ứng các tiêu chí về phiên hoặc tin nhắn nằm ngoài khung thời gian 24 giờ của phiên, thì tin nhắn sẽ được tính phí riêng theo mức phí cho mỗi tin nhắn đa dạng hoặc nội dung đa phương tiện theo bảng giá của từng nhà mạng. |
Nhân viên hỗ trợ đàm thoại và nhân viên hỗ trợ không đàm thoại
Có hai danh mục thanh toán cho tác nhân: đàm thoại và không đàm thoại.
Nhân viên hỗ trợ không đàm thoại sẽ bị tính phí cho mỗi tin nhắn mà họ gửi cho người dùng.
- Danh mục này phù hợp nhất với những trợ lý ảo không cần phản hồi thường xuyên.
Tác nhân đàm thoại được tính phí theo mức cố định cho (các) phiên, miễn là phiên đó được kích hoạt. Sau đó, phí này sẽ bao gồm tất cả tin nhắn được trao đổi trong khoảng thời gian 24 giờ, kể cả những tin nhắn đã kích hoạt phiên. Các tác nhân đàm thoại vẫn có thể tính phí cho những tin nhắn không thuộc phiên hoạt động kéo dài 24 giờ.
- Danh mục này phù hợp nhất với những tác nhân tham gia vào các cuộc trò chuyện nhiều lượt với người dùng.
Logic tính phí theo phiên
Theo mô hình tính phí ở Hoa Kỳ, một phiên được kích hoạt bằng một chuỗi gồm 4 tin nhắn nội dung đa phương tiện hoặc tin nhắn đa phương tiện (bao gồm ít nhất 2 tin nhắn MO và ít nhất 1 tin nhắn MT) được trao đổi trong khoảng thời gian 24 giờ kể từ tin nhắn đầu tiên trong chuỗi kích hoạt. Sau khi đạt đến ngưỡng này, tất cả tin nhắn trong khoảng thời gian 24 giờ đó đều được tính phí như một phiên duy nhất. Mọi tin nhắn nằm ngoài hoặc không kích hoạt được một phiên đều sẽ bị tính phí theo mức phí tiêu chuẩn cho mỗi tin nhắn đối với tin nhắn đa phương tiện hoặc nội dung đa phương tiện theo bảng giá của từng nhà mạng.
Sơ đồ sau đây minh hoạ ví dụ về một phiên thanh toán A2P cho các tác nhân đàm thoại.
- MT (Mobile Terminated) là tin nhắn do doanh nghiệp gửi.
- MO (Mobile Originated) là một tin nhắn hoặc hành động do người dùng bắt đầu.
Sự kiện có thể lập hóa đơn
Các quy trình nhắn tin được phân loại theo nguồn gốc và hướng. Để mô tả hướng lưu lượng tin nhắn, các nhà mạng ở Hoa Kỳ thường sử dụng thuật ngữ MT/MO. Các thuật ngữ này tương ứng với thuật ngữ A2P/P2A được dùng trong tài liệu RCS for Business. Sau đây là thông tin tóm tắt nhanh về mối tương quan giữa các thuật ngữ này:
- A2P (Ứng dụng đến người dùng) là MT (Mobile Terminated): Tin nhắn do doanh nghiệp gửi.
- P2A (Người dùng đến ứng dụng) là MO (Do thiết bị di động gửi): Một tin nhắn hoặc hành động do người dùng bắt đầu.
| Sự kiện | Mô tả | Tác nhân không liên quan đến hoạt động trò chuyện | Tác nhân đàm thoại |
|---|---|---|---|
a2p_rich_message |
Một tin nhắn do nhân viên hỗ trợ gửi, chỉ chứa văn bản, câu trả lời đề xuất hoặc hành động đề xuất cụ thể (Gọi điện, Mở URL trong trình duyệt). | Luôn được coi là một sự kiện riêng lẻ có tính phí. Tính phí theo từng tin nhắn dựa trên phân đoạn (1 phân đoạn tương đương với 160 byte UTF-8). |
Được coi là một sự kiện riêng lẻ có tính phí, trừ phi sự kiện đó trở thành một phần của phiên. |
p2a_rich_message |
Tin nhắn do người dùng gửi chỉ chứa văn bản dạng tự do hoặc văn bản từ việc nhấn vào câu trả lời được đề xuất. | Luôn được coi là một sự kiện riêng lẻ có tính phí. Tính phí theo từng tin nhắn dựa trên phân khúc. |
Được coi là một sự kiện riêng lẻ có tính phí, trừ phi sự kiện đó trở thành một phần của phiên. |
a2p_rich_media_message |
Một tin nhắn do nhân viên hỗ trợ gửi có chứa nội dung nghe nhìn (hình ảnh, video, âm thanh), thẻ đa dạng, băng chuyền hoặc các hành động phức tạp như "Xem vị trí". | Luôn được coi là một sự kiện riêng lẻ có tính phí. Tính phí theo mức cố định cho một sự kiện, bất kể quy mô hoặc nội dung. |
Được coi là một sự kiện riêng lẻ có tính phí, trừ phi sự kiện đó trở thành một phần của phiên. |
p2a_rich_media_message |
Tin nhắn do người dùng gửi có chứa một tệp đa phương tiện được tải lên (hình ảnh, video, âm thanh). | Luôn được coi là một sự kiện riêng lẻ có tính phí. Tính phí theo sự kiện có mức phí cố định duy nhất. |
Được coi là một sự kiện riêng lẻ có tính phí, trừ phi sự kiện đó trở thành một phần của phiên. |
p2a_suggested_action |
Người dùng nhấn vào một hành động được đề xuất bất kỳ (ví dụ: "Xem vị trí") không phải là câu trả lời được đề xuất. | Luôn được coi là một sự kiện riêng lẻ có tính phí. Tạo một sự kiện có tính phí cho mỗi lượt nhấp. |
Được coi là một sự kiện riêng lẻ có tính phí và tạo ra một sự kiện có tính phí cho mỗi lượt nhấp, trừ phi sự kiện đó trở thành một phần của phiên. |
a2p_session |
Khoảng thời gian tương tác là 24 giờ, bắt đầu khi một điều kiện kích hoạt phiên được khởi tạo và tin nhắn đầu tiên là MT. Để biết thêm thông tin, hãy xem bài viết Phiên là gì và hoạt động như thế nào. | Không có. Phiên không áp dụng cho các tác nhân không đàm thoại. | Sau khi được kích hoạt, tất cả tin nhắn trong khoảng thời gian 24 giờ sẽ được tính một khoản phí duy nhất cho phiên. Mọi sự kiện có thể lập hoá đơn trong phiên hoạt động kéo dài 24 giờ sẽ được chỉ định mã sự kiện có thể lập hoá đơn của phiên hoạt động đó. |
p2a_session |
Khoảng thời gian tương tác là 24 giờ, bắt đầu khi một điều kiện kích hoạt phiên được khởi tạo và tin nhắn đầu tiên là tin nhắn do người dùng gửi. Để biết thêm thông tin, hãy xem bài viết Phiên là gì và hoạt động như thế nào. | Không có. Phiên không áp dụng cho các tác nhân không đàm thoại. | Sau khi được kích hoạt, tất cả tin nhắn trong khoảng thời gian 24 giờ sẽ được tính một khoản phí duy nhất cho phiên. Mọi sự kiện có thể lập hoá đơn trong phiên hoạt động kéo dài 24 giờ sẽ được chỉ định mã sự kiện có thể lập hoá đơn của phiên hoạt động đó. |
Tạo báo cáo thanh toán
Chỉ những tác nhân có lưu lượng truy cập không phải của người kiểm thử mới tạo ra các sự kiện có thể lập hoá đơn. Hoạt động của số điện thoại kiểm thử sẽ không xuất hiện trong báo cáo thanh toán.
Các báo cáo này giả định rằng sự kiện sẽ tính phí khi tin nhắn A2P được gửi, chứ không phải khi tin nhắn được gửi. Một thư không được gửi hoặc một thư bị huỷ trước khi gửi sẽ không kích hoạt sự kiện có tính phí.
Định dạng báo cáo thanh toán
Báo cáo thanh toán sử dụng định dạng tên tệp rbm_billable_events_YYYY-MM-DD.csv.
Ngày trong tên tệp là ngày tạo tệp.
Mỗi dòng trong báo cáo là một bản ghi đại diện cho một sự kiện có tính phí.
Phiên A2P/P2A được biểu thị bằng nhiều hàng – một hàng cho mỗi tin nhắn được trao đổi. Mỗi hàng liên kết với một phiên (có cùng billing_event_id) sẽ báo cáo tổng số tin nhắn MT và MO cho toàn bộ khung thời gian 24 giờ của phiên trong các cột mt_messages và mo_messages.
Mỗi bản ghi trong báo cáo chứa những thông tin sau cho từng sự kiện có tính phí.
| Trường | Định dạng | Nội dung mô tả | Ví dụ |
|---|---|---|---|
billing_event_id |
chuỗi | Mã nhận dạng được tạo để phân biệt sự kiện có thể lập hoá đơn. Tất cả những thông báo thuộc một phiên sẽ có cùng |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
chuỗi | Loại sự kiện:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
chuỗi | Giá trị nhận dạng riêng biệt của nhân viên đã tham gia sự kiện. | acme_342h23_agent@rbm.goog |
agent_owner |
chuỗi | Địa chỉ email của chủ sở hữu hiện tại của tài khoản đối tác nơi nhân viên hỗ trợ được tạo. | marketing@xyzaggregator.com |
billing_party |
chuỗi | Bên thanh toán cho các sự kiện. | nhà mạng |
max_duration_single_message |
số | Thời gian tối đa (tính bằng giờ) mà người dùng được phép phản hồi tin nhắn của nhân viên hỗ trợ trước khi cửa sổ bắt đầu cuộc trò chuyện đóng và tin nhắn được phân loại là sự kiện single_message. Không áp dụng cho mô hình tại Hoa Kỳ đối với từng tin nhắn đa dạng. |
24 |
max_duration_a2p_conversation |
số | Đối với chương trình thí điểm về phiên, chỉ số này phản ánh khoảng thời gian 24 giờ của phiên được đo lường từ thông báo đầu tiên trong chuỗi điều kiện kích hoạt. Thời lượng được tính bằng giờ. | 24 |
max_duration_p2a_conversation |
số | Đối với chương trình thí điểm về phiên, chỉ số này phản ánh khoảng thời gian 24 giờ của phiên được đo lường từ thông báo đầu tiên trong chuỗi điều kiện kích hoạt. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | Ngày/giờ bắt đầu sự kiện theo giờ UTC (ISO 8601). Đối với các phiên, đây là dấu thời gian của thông báo đầu tiên trong chuỗi điều kiện kích hoạt. A2P a2p_rich_message và a2p_rich_media_message, đây là thời điểm thông báo được gửi đến người dùng.a2p_session, đây là thời điểm tin nhắn đầu tiên trong cuộc trò chuyện được gửi đến người dùng.P2A p2a_rich_message và p2a_rich_media_message, đây là thời điểm người dùng gửi thông báo.p2a_session, đây là thời điểm người dùng gửi tin nhắn đầu tiên trong cuộc trò chuyện. |
2025-05-20T08:00:00Z |
duration |
số | Thời lượng chỉ liên quan đến phiên và được đo bằng phút. Khi sự kiện là sự kiện không thuộc phiên, giá trị sẽ là 0. | 45 |
mt_messages |
số | Số lượng tin nhắn kết thúc trên thiết bị di động (A2P) trong sự kiện. Đối với các phiên, mỗi hàng có cùng billing_event_id cho biết tổng số tin nhắn được dịch bằng máy trong toàn bộ phiên. |
5 |
mo_messages |
số | Số lượng tin nhắn do thiết bị di động gửi (P2A) trong sự kiện. Đối với các phiên, mỗi hàng có cùng billing_event_id sẽ cho biết tổng số tin nhắn MO trong toàn bộ phiên. |
3 |
size_kilobytes |
số | Kích thước của tất cả các tệp đính kèm thư trong sự kiện, được làm tròn đến kilobyte gần nhất (1 kB bằng 1024 byte). | 912 |
agent_name |
chuỗi | Tên của nhân viên hỗ trợ đã tham gia sự kiện. | ACME Brand |
owner_name |
chuỗi | Tên của chủ sở hữu hiện tại của tài khoản đối tác nơi nhân viên hỗ trợ được tạo. | XYZ Aggregator |
segment_count |
số | Số đoạn được tính cho các sự kiện a2p_rich_message events và p2a_rich_message (1 đoạn bằng 160 byte UTF-8). Khi sự kiện không thuộc một trong những sự kiện đã đề cập, giá trị sẽ là 0. |
5 |
session_type |
chuỗi | Loại phiên:a2p_sessionp2a_session |
a2p_session |
Báo cáo thanh toán mẫu
Bạn có thể tải báo cáo mẫu xuống:
Kích thước tệp thông thường
Quy mô của báo cáo hằng ngày từ một đối tác RCS cho Doanh nghiệp đang hoạt động phụ thuộc vào mức độ hoạt động mà đối tác đó đã tạo trên mạng của nhà mạng.