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