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ề Khung 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 xác định việc tính phí và cách tính phí cho các sự kiện có tính phí. Tất cả nhà mạng ở Hoa Kỳ đang tích cực vận hành 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 ở Hoa Kỳ, hãy tham khảo Câu hỏi thường gặp về thông tin thanh toán ở 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 vào 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 còn hàng của 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 vận hành RCS cho doanh nghiệp đề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 có 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 riêng biệ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 trợ lý ảo và sự kiện có tính phí là yếu tố then chốt để hiểu cách trợ lý ảo của bạn được tính phí.
- 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 tin 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 cho tác nhâ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 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 tin nhắn đượ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à tin nhắn 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 tin nhắn 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.
Các tác nhân không đàm thoại sẽ bị tính phí cho mỗi tin nhắn mà họ gửi đến 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 sẽ được tính phí 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 trò chuyện 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ả các thông báo 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 có thể tính phí theo mức phí tiêu chuẩn cho mỗi tin nhắn đối với nội dung đ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 tính phí 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 thông báo 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 toàn bộ tài liệu về 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 thực hiện.
| Sự kiện | Mô tả | Tác nhân không liên quan đến hoạt động trò chuyện | Trợ lý đà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, Đề xuất câu trả lời hoặc hành động đề xuất cụ thể (Gọi điện, Mở URL trong trình 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 tuỳ ý hoặc văn bản từ việc nhấn vào một Đề xuất câu trả lời. | 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ẻ thông tin chi tiết, 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 tệp đa phương tiện đã 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 khung 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ã nhận dạng 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 bắt đầu phiên. Để 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 khung 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ã nhận dạng 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 có thể 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 tin nhắn không gửi được hoặc một tin nhắn 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 được 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ộ cửa sổ phiên 24 giờ trong các cột mt_messages và mo_messages.
Các tệp được mã hoá theo UTF-8 mà không có dấu thứ tự byte và sử dụng ký tự chuyển dòng cho dấu kết thúc dòng. Dòng đầu tiên của mỗi tệp là một hàng tiêu đề có tên trường.
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ả 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 bạn tạo nhân viên hỗ trợ. | 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 trả lờ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 lại 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 thông báo đa dạng thức. |
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 của phiên là 24 giờ, được đo từ tin nhắn đầu tiên trong chuỗi 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 của phiên là 24 giờ, được đo từ tin nhắn đầu tiên trong chuỗi 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 các 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 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 tác nhân đã 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ị này 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 của 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à họ đã tạo trên mạng của nhà mạng.