Mô hình thanh toán ở Hoa Kỳ

Tài liệu này trình bày mô hình tính phí cho lưu lượng truy cập RCS cho Doanh nghiệp trên các nhà mạng ở Hoa Kỳ.

Tổng quan về các phân loại thanh toán ở Hoa Kỳ

Mọi tin nhắn gửi đến hoặc gửi đi từ một số điện thoại ở Hoa Kỳ đều được tự động phân loại thành một trong ba loại dựa trên định dạng của tin nhắn:

  • Tin nhắn đa dạng thức (hai chiều)
  • Tin nhắn đa phương tiện (hai chiều)
  • Lượt nhấp vào hành động được đề xuất (do người dùng bắt đầu)

Hãy tham khảo các phần sau để biết thông số kỹ thuật chi tiết.

Lưu ý về thuật 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 điều khoản 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 cho doanh nghiệp:

  • MT (Mobile Terminated) là A2P (Application-to-Person): Tin nhắn do doanh nghiệp gửi.
  • MO (Mobile Originated) là P2A (Person-to-Application): Một thông báo hoặc hành động do người dùng bắt đầu.

Tính phí sự kiện từ tổng đài viên đến người dùng (A2P/MT)

Phần này trình bày logic tính phí cho những tin nhắn do một nhân viên gửi (tức là tin nhắn A2P hoặc MT).

Tin nhắn đa dạng thức (A2P)

Một thông báo được phân loại là Thông báo đa dạng thức nếu chỉ chứa một tổ hợp các phần tử sau:

Logic thanh toán cho Rich Messages

Tin nhắn đa phương tiện được tính phí dựa trên phân khúc.

  • Kích thước phân đoạn: 1 phân đoạn = 160 byte văn bản được mã hoá UTF-8.
  • Cách tính: Tổng độ dài byte UTF-8 của văn bản trong tin nhắn được chia cho 160 và luôn được làm tròn lên đến số nguyên gần nhất.
  • Loại trừ: Văn bản và dữ liệu postback trong các câu trả lời hoặc hành động được đề xuất không được tính vào số lượng phân đoạn.
  • Ví dụ: Một tin nhắn văn bản dài 300 byte có 2 phần (300 / 160 = 1,875, làm tròn lên thành 2).

Số lượng byte

Một số ký tự unicode (chẳng hạn như biểu tượng cảm xúc hoặc chữ cái có dấu) là ký tự nhiều byte, vì vậy, tổng số byte UTF có thể khác với số ký tự.

Để kiểm tra số byte chính xác của một thông báo, hãy nhập hoặc dán thông báo đó bên dưới.

Tin nhắn đa phương tiện (A2P)

Một thông báo được phân loại là Thông báo đa phương tiện nếu thông báo đó chứa ít nhất một trong những nội dung sau:

Logic lập hoá đơn cho tin nhắn đa phương tiện

Thông báo đa phương tiện được tính phí là một sự kiện duy nhất với mức phí cố định.

  • Phí này không thay đổi bất kể độ dài văn bản, số lượng thẻ hay kích thước của tệp nội dung nghe nhìn.
  • Không áp dụng phân đoạn.

Ví dụ về phản hồi A2P API

Các ví dụ này cho thấy trường richMessageClassification trong phản hồi thành công của lệnh gọi RBM API đối với những tin nhắn do tác nhân gửi.

Ví dụ về phản hồi API cho RICH_MESSAGE

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

Ví dụ về phản hồi API cho RICH_MEDIA_MESSAGE

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

Tính phí sự kiện Người dùng đến nhân viên hỗ trợ (P2A/MO)

Phần này đề cập đến việc tính phí cho tin nhắn và hành động do người dùng thực hiện (tức là tin nhắn P2A hoặc MO).

Tin nhắn đa dạng thức (P2A)

Tin nhắn của người dùng được phân loại là Tin nhắn đa dạng thức nếu chỉ chứa văn bản. Điều này bao gồm cả văn bản dạng tự do và văn bản có được khi bạn nhấn vào một phản hồi đề xuất. (Câu trả lời đề xuất có thể bao gồm một giá trị nhận dạng dữ liệu postback trong tải trọng thông báo.)

Logic thanh toán: Thanh toán dựa trên phân khúc. Để biết thông tin chi tiết về cách tính số đoạn, hãy xem Logic tính phí cho Tin nhắn đa phương tiện.

Tin nhắn đa phương tiện (P2A)

Một tin nhắn được phân loại là Tin nhắn đa phương tiện nếu tin nhắn đó chứa một tệp được tải lên (hình ảnh, video, âm thanh).

Logic thanh toán: Được tính phí là một sự kiện duy nhất với mức phí cố định. Không áp dụng phân đoạn.

Số lượt nhấp vào hành động được đề xuất

Khi người dùng nhấn vào một hành động được đề xuất, một sự kiện có tính phí sẽ được tạo ra, gọi là Lượt nhấp vào hành động được đề xuất. (Hành động đề xuất có thể bao gồm một giá trị nhận dạng dữ liệu đăng lại trong tải trọng thông báo.)

Logic lập hoá đơn: Tạo một sự kiện có thể lập hoá đơn cho mỗi lượt nhấp.

Trường hợp đặc biệt: Chia sẻ vị trí

Tính năng chia sẻ vị trí là tính năng duy nhất tạo ra 2 sự kiện riêng biệt có tính phí P2A:

Ví dụ về phản hồi của webhook P2A

Những ví dụ này cho thấy trường richMessageClassification trong webhook được gửi đến tác nhân cho các sự kiện do người dùng bắt đầu.

Ví dụ về webhook cho RICH_MESSAGE do người dùng gửi

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

Ví dụ về webhook cho RICH_MEDIA_MESSAGE do người dùng gửi

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "userFile": "...",
  "payload": "...",
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

Ví dụ về webhook cho SUGGESTED_ACTION_CLICK

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "suggestionResponse": {
        "text": "Click here",
        "postbackData": "...",
        "type": "ACTION"
    },
    "richMessageClassification": {
        "classificationType": "SUGGESTED_ACTION_CLICK"
    }
}

Ví dụ về webhook cho thông báo về vị trí

Đây là sự kiện có tính phí thứ hai trong quy trình Chia sẻ vị trí, được gửi sau khi người dùng chia sẻ vị trí của họ trên bản đồ.

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "location": {
      "latitude": 37.422000,
      "longitude": -122.084056
    },
    "richMessageClassification": {
        "classificationType": "RICH_MESSAGE",
        "segmentCount": 1
    }
}

Ghi chú về kỹ thuật và việc triển khai

  • Các phân đoạn chỉ dành cho mục đích thanh toán: Tin nhắn dài được gửi dưới dạng một đơn vị duy nhất đến thiết bị của người dùng. Số lượng phân khúc là một phép tính ảo cho mục đích thanh toán; số lượng này không ảnh hưởng đến cách gửi hoặc trình bày tin nhắn cho người dùng.
  • Phân loại tự động: Hệ thống sẽ tự động phân loại thư hoàn toàn dựa trên nội dung thư và bạn không thể ghi đè theo cách thủ công.
  • Triển khai: Mô hình thanh toán ở Hoa Kỳ đã được bật trên nền tảng RCS cho doanh nghiệp vào ngày 15 tháng 7 năm 2025. Kể từ ngày này, báo cáo và phản hồi API của Google sẽ phản ánh các phân loại mới.