美国结算模式

本文档简要介绍了美国运营商的 RCS for Business 流量的结算模式。

美国结算分类概览

系统会根据每条发往美国电话号码或来自美国电话号码的消息的格式,自动将其归类为以下三种类型之一:

  • 富消息(双向)
  • 富媒体消息(双向)
  • 建议操作点击(用户发起)

如需了解详细规格,请参阅以下部分。

术语说明

为了描述消息传递流量的方向,美国运营商通常使用 MT/MO 术语。这些术语与整个“RCS 商务版”文档中使用的 A2P/P2A 术语相对应:

  • MT(移动被叫)是 A2P(应用到个人):商家发送的消息。
  • MO(移动主叫)是 P2A(个人到应用):用户发起的某条消息或某项操作。

代理商到个人 (A2P/MT) 事件结算

本部分介绍了代理发送的消息(即 A2P 或 MT 消息)的结算逻辑。

富消息 (A2P)

如果消息包含以下元素的组合,则该消息会被归类为富消息:

富消息的结算逻辑

富消息的费用按段计算。

  • 分段大小:1 段 = 160 字节的 UTF-8 编码文本。
  • 计算方式:将消息文本的总 UTF-8 字节长度除以 160,然后始终向上舍入到最接近的整数。
  • 排除项:建议回复或操作中的文本和回发数据计入分段数。
  • 示例:一条 300 字节的短信有 2 个段(300 / 160 = 1.875,向上舍入为 2)。

字节数

某些 Unicode 字符(例如表情符号或带重音的字母)是多字节字符,因此 UTF 字节总数可能与字符数不同。

如需查看消息的确切字节数,请在下方输入或粘贴消息。

富媒体消息 (A2P)

如果消息包含以下内容中的至少一项,则会被归类为富媒体消息:

富媒体消息的结算逻辑

富媒体消息按单次固定费率事件计费。

  • 无论文本长度、卡数或媒体文件大小如何,账单都是一样的。
  • 细分不适用。

A2P API 响应示例

以下示例展示了代理发送的消息在成功的 RBM API 调用响应中的 richMessageClassification 字段。

针对 RICH_MESSAGE 的 API 响应示例

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

针对 RICH_MEDIA_MESSAGE 的 API 响应示例

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

人工客服 (P2A/MO) 事件结算

本部分介绍了用户发起的短信和操作(即 P2A 或 MO 短信)的结算方式。

富消息 (P2A)

如果用户消息仅包含文本,则会被归类为富消息。这包括自由格式文本和点按建议的回复后生成的文本。 (建议回复可能包含消息载荷中的回发数据标识符。)

结算逻辑:根据细分进行结算。如需详细了解分段数计算,请参阅富消息的结算逻辑

富媒体消息 (P2A)

如果消息包含上传的文件(图片、视频、音频),则该消息会被归类为富媒体消息。

结算逻辑:按单一统一费率事件结算。不适用细分。

建议操作点击次数

用户点按任何建议操作都会生成一个可结算的事件,称为“建议操作点击”。 (建议的操作可能包含消息载荷中的回发数据标识符。)

结算逻辑:每次点击生成一个可结算事件。

特殊情况:分享位置信息

定位共享的独特之处在于,它会生成两个单独的 P2A 可结算事件:

P2A Webhook 响应示例

以下示例展示了针对用户发起的事件发送给代理的 webhook 中的 richMessageClassification 字段。

用户发送的 RICH_MESSAGE 的网络钩子示例

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

用户发送的 RICH_MEDIA_MESSAGE 的网络钩子示例

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

SUGGESTED_ACTION_CLICK 的 Webhook 示例

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

位置消息的网络钩子示例

这是分享位置信息流程中的第二个可结算事件,在用户从地图中分享位置信息后发送。

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

技术和实现注意事项

  • 分段仅用于结算目的:长消息会以单个单元的形式递送到用户的设备。细分数量是出于结算目的而进行的虚拟计算,不会影响消息的传送方式或向用户的呈现方式。
  • 自动分类:邮件分类完全基于邮件内容自动进行,无法手动覆盖。
  • 推出:美国结算模式已于 2025 年 7 月 15 日在 RCS Business Messaging 平台上启用。自此日期起,Google 的报告和 API 响应将反映新的分类。