版本说明

本页面介绍了 RCS Business Messaging 的变化。

2025 年 8 月 28 日

文档增强

本地化退订/订阅关键字：我们更新了文档，其中包含用户退订或订阅时自动发送给代理的具体国家/地区关键字（例如 STOP、BAJA、parar）。此列表将有助于您更好地识别和处理这些事件。如需查看完整参考信息，请参阅退订和订阅文档。

2025 年 8 月 25 日

文档增强

我们更新了验证并启动代理文档。为了帮助您更快地找到相关信息：

  • 我们已为品牌验证和发布审批分别创建了单独的页面。
  • 我们将代理创建和启动文档分组放在左侧导航栏中。

2025 年 8 月 19 日

已更改

  • 对于 Google 管理的发布：在您的代理机构信息中，您必须添加至少一种联系方式：电话号码、网站或电子邮件地址。 虽然只需提供其中一项，但我们建议您提供所有信息。

2025 年 8 月 13 日

文档增强

  • 我们更新了富卡片文档，新增了缩略图部分，以明确说明富卡片中缩略图的行为和大小限制。

2025 年 8 月 4 日

新

  • 对于印度运营商的 RBM 流量：RBM 代理现在可以在 Google 信息客户端中发送富卡片中的 PDF 文件。

文档增强

我们更新了 RBM 结算常见问题解答，以说明不同的消息传递场景和用户响应如何促成对话型代理和非对话型代理的结算事件。

添加了以下部分：

2025 年 7 月 31 日

已更改

每条消息的附件总大小上限为 100 MiB

  • 为了改善用户体验并防止意外的数据消耗，我们为单个 RBM 消息中所有媒体和 PDF 附件的总大小设置了 100 MiB 的大小限制。现在，此限值适用于所有运营商的 RBM 流量。

2025 年 7 月 30 日

新

修复了截断问题：Google 信息中富卡片轮播广告的新全屏视图

此修复解决了以下主要痛点：富卡轮播界面上的文字或建议可能会因高度限制而被截断。为了清楚地表明何时有更多内容可用，截断的轮播界面卡片上现在会显示更多按钮。用户只需点按文本区域中的任意位置，即可将卡片展开为可滑动浏览的全屏视图，以便随时查看完整消息。

我们为何要进行此项更改

  • 用户体验更佳：避免用户因内容截断而感到困惑。
  • 增强了消息可靠性：让您更有信心确保整个消息（包括关键细节和号召性用语）能够成功发送并被查看。
  • 无需开发者采取任何行动：此功能会自动为所有富卡片轮播界面启用，无需对代理进行任何更改。

适用的国家/地区

如需详细了解规范、用户互动和建议行为，请参阅更新后的富卡片文档。

2025 年 7 月 28 日

新

2025 年 7 月 17 日

文档增强

我们对管理代理文档进行了多项改进。

2025 年 7 月 9 日

新

适用于多用途代理的灵活启动选项

  • 为了帮助您更快地将代理推向市场，您现在可以申请发布仅实现一个用例（促销或交易）的多用途代理。
  • 然后，您需要在首次发布后的六个月内实现并提交第二个使用情形以供审核，才能保持代理的多用途状态。
  • 如需了解详情，请参阅提交发布申请。

July 1, 2025

已更改

报告

2025 年 6 月 23 日

新

实时代理启动状态通知

  • 对于 RBM 合作伙伴：RBM 平台现在会通过网络钩子直接发送有关代理发布状态的实时更新。这样一来，您无需通过电子邮件或开发者控制台手动监控，即可立即了解代理的生命周期。

运作方式

  • 现在，每次代理的发布状态发生更改（例如从 PENDING 更改为 LAUNCHED 或 REJECTED）时，您都会收到 AgentLaunchEvent。您可以使用现有的消息传递 Webhook，也可以配置专用的通知 Webhook 来接收这些事件。

  • 如需详细了解如何配置 webhook、了解事件载荷以及解读代理启动状态，请参阅代理启动状态已更改。

2025 年 6 月 16 日

已更改

我们会不断优化用户体验，并已更新“退订”功能在以下两个市场的提供情况：

美国：

  • 对于来自短号码和字母数字号码的 RBM 和 A2P xMS 消息：
    • 聊天底部不再显示“退订”选项。
    • 菜单中的“退订”选项仍然可用。
  • 开发者注意事项：如果用户在 Google 信息版本（低于 20250518.01）中选择聊天底部的“退订”选项，您将继续收到来自这些用户的“退订”事件。

西班牙：

  • 针对 RBM 停用了“退订”选项（包括聊天中的和菜单中的）。

这些更新会更改用户看到“退订”选项的方式。继续处理您收到的所有“退订”事件，以确保合规。

如需详细了解“取消订阅”和“订阅”功能，请参阅之前的版本说明和完整文档。

2025 年 6 月 9 日

即将推出

媒体网址重定向处理方面的变更

为了实现可靠且安全的媒体传送，我们正在更改 RBM API 调用中媒体网址重定向的处理方式：

  • files.create API：文件上传的媒体网址将支持一次重定向。
  • agentMessage.create API：这些请求中的媒体网址将不再支持重定向。

时间：新的重定向处理方式将于 2025 年 7 月 30 日生效。

建议：为确保媒体内容可靠地投放，避免出现中断，请执行以下操作：

2025 年 6 月 6 日

新

RBM Figma 贴纸集

仅限已注册的 RBM 合作伙伴：使用新的 Figma 贴纸表，获取准确的 Google 信息界面元素和设计模式。 对于设计师来说，这是直观了解 RBM 功能并为您的品牌打造一致且直观的用户体验的重要资源。

如需申请成为 RBM 合作伙伴，请填写合作伙伴注册意向表单。

2025 年 6 月 4 日

文档增强

我们对 Analytics 概览文档进行了多项改进。

2025 年 5 月 30 日

文档增强

我们更新了 RBM 代理启动文档。

2025 年 5 月 28 日

文档增强

我们对代理文档和 RBM 问题排查指南进行了多项改进。

May 12, 2025

已更改

更新了富卡片轮播界面的尺寸和字体大小

我们更新了复合信息卡轮播界面的规范，以反映最新的 Google 信息界面和针对轮播界面的特定用户体验改进。所有富卡片的字体也略大，以便于阅读。

主要变化

  • 字体大小：所有富卡片（独立卡片和轮播卡片）中的文字现在以 16 SP 的大小呈现，之前为 14 SP。
  • 小轮播广告尺寸：固定宽度为 180 DP（从 120 DP 增加），最大高度为 542 DP（保持不变）。
  • 中等轮播界面的尺寸：固定宽度为 296 DP（从 232 DP 增加），最大高度为 592 DP（保持不变）。
  • 轮播界面缩放：轮播界面已放大约 1.5 倍，以提供更多内容空间。
  • 媒体高度（未更改）：
    • 短媒体：112 DP
    • 中等媒体：168 DP
    • 高媒体：264 DP
  • 媒体宽高比发生变化：由于小型和中型轮播界面的卡片宽度增加，但媒体高度不变，因此媒体现在看起来比以前更宽。

对设计和可视化的影响

  • 富卡片：文字可能会略大，请根据需要调整布局。
  • 小型轮播界面：使用扩展的固定宽度 (180 DP) 和最大高度 (542 DP)。请注意，由于卡片变宽，但媒体高度未变，因此媒体现在看起来会更宽。您可能需要调整图片大小或布局。
  • 中等轮播界面：使用展开的固定宽度 (296 DP) 和最大高度 (592 DP)。请注意，由于卡片尺寸发生变化，这些卡片中的媒体内容也会显得更宽。检查媒体内容，确认其在此更宽的格式下显示效果良好。
  • 轮播高度：轮播中的所有卡片将继续缩放为最高卡片的高度。
  • 轮播截断：现有的截断逻辑仍然有效。

优势

  • 更大的字体可提高所有富卡片中的文字可读性。
  • 轮播界面中的空间更大，因此您可以更灵活地展示多个商品供用户探索。
  • 此次更新显著改进了 Google 信息中的复合信息卡和轮播界面的用户体验，因此您可以在广告系列中加入更具吸引力和效果的轮播界面。

前后对比

  • 小型轮播界面、短媒体、短文本内容：
功能 之前的维度 当前维度
轮播宽度 120 DP（固定） 180 DP（固定）
高度上限 592 DP 542 DP
字号 14 SP 16 SP
可视化 紧凑，文字可能非常小 更宽、更易读的文字
示例 之前的内容 当前内容
  • 中等轮播界面、中等大小的媒体、中等大小的文字内容：
功能 之前的维度 当前维度
轮播宽度 232 DP 296 DP（固定）
高度上限 592 DP 542 DP
字号 14 SP 16 SP
可视化 空间适中，文字清晰可读 更宽敞、更易读的文字
示例 之前的内容 当前内容
  • 中等轮播界面，高媒体，长文本内容：
功能 之前的维度 当前维度
轮播宽度 232 DP 296 DP（固定）
高度上限 592 DP 542 DP
字号 14 SP 16 SP
可视化 文字可能被截断，布局更紧凑 可容纳更多文字，视觉平衡性更佳
示例 之前的内容 当前内容

2025 年 4 月 29 日

新

Google 信息应用现已全面推出 WebView

  • WebView 功能已退出抢先体验阶段。现在，制作代理可以使用建议的操作 Open 网址 将 webview 直接嵌入到 RBM 对话中。这样一来，用户无需离开“信息”应用即可轻松访问付款平台等 Web 内容。WebView 可以全屏、半屏或竖屏显示。如需了解详情，请参阅代理可以执行哪些操作？。
  • 请注意，需要进行客户端更新才能启用 WebView，因此此功能会随着时间的推移而变得更加普及。在尚不支持 WebView 的设备上，指定的网页将在用户的默认浏览器中打开。

2025 年 4 月 28 日

新

  • 针对 Google 信息中的 RBM 对话，发布了退订和重新订阅功能的 Beta 版。

主要功能

  • “退订/订阅”选项（取代聊天底部的“屏蔽并举报”）：用户可以轻松选择退出或加入对话。
  • Webhook 事件通知：合作伙伴通过新的 webhook 事件接收 UNSUBSCRIBE 和 SUBSCRIBE 请求。
  • 退订原因：用户可以在退订时提供原因，也可以选择举报垃圾内容。聊天菜单中仍提供现有的屏蔽并举报垃圾内容选项。

优势

  • 可指导行动的数据洞见：合作伙伴和运营商可以深入了解用户与商家消息的互动情况。
  • 提升用户体验：用户可以更好地控制自己收到的消息，从而减少垃圾消息，并提高对 RCS 的总体满意度。
  • 品牌诚信度：通过尊重用户偏好和推广道德信息传递实践，帮助企业维护积极的品牌形象。

适用的国家/地区

  • 退订和订阅选项将适用于以下消息：
    • 美国、巴西、法国、德国、印度、墨西哥、西班牙和英国境内的 RBM 消息。
    • 来自短号码（5-6 位数的电话号码）或字母数字号码的美国境内 A2P 短信或彩信。

2025 年 4 月 15 日

新

2025 年 3 月 25 日

新

即将推出

  • 针对 Google 信息中的 RBM 对话，发布了退订和重新订阅功能的 Beta 版。

主要功能

  • “退订/订阅”选项（取代聊天底部的“屏蔽并举报”）：用户可以轻松选择退出或加入对话。
  • Webhook 事件通知：合作伙伴通过新的 webhook 事件接收 UNSUBSCRIBE 和 SUBSCRIBE 请求。
  • 退订原因：用户可以在退订时提供原因，也可以选择举报垃圾内容。聊天菜单中仍提供现有的屏蔽并举报垃圾内容选项。

优势

  • 可指导行动的数据洞见：合作伙伴和运营商可以深入了解用户与商家消息的互动情况。
  • 提升用户体验：用户可以更好地控制自己收到的消息，从而减少垃圾消息，并提高对 RCS 的总体满意度。
  • 品牌诚信度：通过尊重用户偏好和推广道德信息传递实践，帮助企业维护积极的品牌形象。

适用的国家/地区

  • 退订和订阅选项将适用于以下消息：
    • 美国、巴西、法国、德国、印度、墨西哥、西班牙和英国境内的 RBM 消息。
    • 来自短号码（5-6 位数的电话号码）或字母数字号码的美国境内 A2P 短信或彩信。

2025 年 3 月 4 日

已更改

  • 如果设备不支持 webview 的用户在即时通讯应用中打开网页链接，网页现在会在用户的浏览器中打开。

2025 年 3 月 4 日

新

  • 为了与 GSMA RCC.07 规范保持一致，RBM API 中新增了 messageTrafficType 字段。您可以使用此字段指定每条消息的使用情形或“流量类型”（例如：身份验证、交易和促销类型的流量）。通过识别每条消息的流量类型，此字段可让一个代理支持多个用例。

您需要做些什么？

  • 如需设置消息流量类型，请在发送消息时使用 RBM API 中的 messageTrafficType 字段。
  • 该字段目前为可选，但我们强烈建议您立即开始使用该字段，以免日后该字段成为必填字段时出现错误。

2025 年 2 月 24 日

已更改

每条发送给美国号码的消息的附件总大小上限为 100 MiB

  • 为了改善用户体验并防止意外的数据消耗，我们对发送给美国手机号码的单个 RBM 消息中所有媒体和 PDF 附件的总大小实施了 100 MiB 的大小限制。此限制仅适用于美国运营商的 RBM 流量。
  • 在多个国家/地区（例如加拿大和美国）运营的代理只有在向美国电话号码发送消息时才会受到此限制。

2025 年 2 月 11 日

已更改

为了改进错误处理，RBM 平台更新了针对失败的 phones.getCapabilities 和 phones.agentMessages.create 请求的错误响应。具体而言，在目标用户或网络无法访问或未配置 RCS 的所有情况下，平台现在都会返回 404 Not Found 错误代码。

新的 404 错误行为：

  • 现在，RBM 平台将在以下情况下返回 404 NOT_FOUND 错误代码：
    • 向设备不支持 RCS 或未启用 RCS 的用户发送功能检查或消息。
    • 向代理未启动或 RCS 流量未启用的网络中的用户发送功能检查或消息。

从 403 错误更改：

  • 之前，当向网络上未启动代理或未启用 RCS 流量的 RCS 用户发送功能检查或消息时，系统会返回 403 PERMISSION_DENIED 错误。

对开发者的影响：开发者应更新其错误处理逻辑，以正确解读对 phones.getCapabilities 和 phones.agentMessages.create 的响应中的 404 错误。

2025 年 2 月 4 日

文档增强

  • 新的复合信息卡指南提供了有关复合信息卡和轮播界面的规范。了解这些规范对于在 Google 信息中创建富有吸引力且实用的富卡片至关重要。重要的更新包括：

    • 明确了媒体支持（图片和视频格式、大小和宽高比）。

    • 标题、说明以及建议的回复和操作的详细字符数限制。

    • 垂直和水平复合信息卡布局的说明。

    • 轮播界面的规范，包括尺寸和内容限制。

    • 有关处理内容截断和空白的指南。

2025 年 1 月 29 日

文档增强

我们对 RBM 结算文档进行了多项改进。

2024 年 12 月 23 日

新

  • RBM 支持短信深层链接，允许用户通过网址与您的代理开始对话。通过在电子邮件、网站、应用甚至实体位置中嵌入网址（以链接、按钮或二维码的形式），您可以为用户提供顺畅的方式来与您的客服人员联系。

2024 年 12 月 19 日

已更改

  • RBM 现在支持两种聊天机器人信息中的电话号码格式：完整的 E.164 格式（例如“+12223334444”）或不含“+”、前缀或国家/地区代码的未格式化本地/免费电话号码（例如“6502530000”）。不允许使用紧急服务号码。

2024 年 12 月 18 日

已更改

  • 批量功能检查现在要求每个请求包含 500 到 10,000 个唯一电话号码。 现在，如果请求中的号码少于 500 个、超过 10,000 个或包含重复号码，系统会返回错误。对于包含超过 10,000 个号码的列表，请将请求拆分为不超过 10,000 个号码的批次。

2024 年 11 月 1 日

已更改

  • 我们已完全过渡到基于合作伙伴的 RBM 模型。旧版 RBM 模型已被弃用，相关文档也已移除。基于合作伙伴的模型可实现以下功能：

2024 年 10 月 31 日

已更改

  • 如果打开网址建议操作中提供的网址不符合 RFC 3986 中定义的 URI 语法，则会被拒绝。

2024 年 10 月 21 日

新

  • 打开网址建议操作现在支持 webview，允许用户直接在即时通讯应用中打开指定的网页（例如付款平台）。
  • WebView 可以全屏、半屏或高屏模式显示。如需了解详情，请参阅代理可以做什么？。

新

  • 新增了用于撰写消息的建议操作，可打开用户的消息应用，向预定义的电话号码（例如客户支持号码）发送文字、音频或视频消息。

2024 年 8 月 30 日

新

RBM 代理现在可以发送音频文件，从而实现更易于访问且更具吸引力的互动：

  • 提高无障碍性：帮助有视觉障碍、读写障碍或运动技能限制的用户进行沟通。
  • 提升客户服务：通过提供音频指南或实时建议（附带分步说明）来帮助用户排查技术问题。
  • 支持多语言客户：支持使用客户的首选语言进行沟通，这对于旅游或酒店服务尤其有用。
  • 展现品牌个性：使用角色配音和音效增添趣味，非常适合媒体和娱乐行业。

如需详细了解兼容的音频格式，请参阅支持的媒体类型。

2024 年 8 月 1 日

新

我们已明确品牌验证和代理发布流程（流程本身并未发生根本性变化）：

  • 更直观的开发者控制台体验：验证标签页中的新说明明确指出，您必须先提供验证信息，然后才能提交代理以进行首次发布。为避免混淆，发布标签页现在处于停用状态，直到您提供验证信息为止。
  • 为确保始终使用最准确的数据进行验证：
  • 说明品牌验证的运作方式：新增了品牌验证常见问题解答，其中涵盖了常见问题。

新

  • 您将无法再通过合作伙伴账号设置修改合作伙伴名称或显示名称。 如需请求更改这些名称，请发送电子邮件至 rbm-support@google.com。

2024 年 4 月 1 日

新

  • 现在，您可以在 RBM 控制台中查看代理的启动历史记录。历史数据自 2024 年 3 月 7 日起提供。
  • 如需查看最新的启动状态更改，请参阅代理概览。如需查看启动状态更新的历史记录，请参阅“代理历史记录”。详细信息包括更改内容、更改者、更改时间，以及（如果是中止或拒绝）原因。

2024 年 3 月 26 日

新

  • 现在，所有使用基于合作伙伴的 RBM 模型的合作伙伴都可以访问 RBM Management API。此 API 可复制 Play 管理中心的功能，因此合作伙伴可以通过 API 以程序化方式执行以下操作：
    • 创建品牌和代理
    • 列出为品牌创建的所有代理
    • 检索和修改代理信息
    • 提交代理以进行品牌验证并检索验证状态
    • 提交代理以在所选运营商处发布，并检索发布状态
    • 添加和移除代理网络钩子集成

新

  • 运营商（以及代表运营商工作的合作伙伴）现在可以访问 RBM Operations API，以便在其网络上管理 RBM 代理审批。此 API 复制了管理控制台的功能，因此移动网络运营商可以通过 API 以编程方式执行以下操作：
    • 获取已提交的要在其网络上发布的所有 RBM 代理的列表
    • 查看代理信息
    • 检索代理发布状态和调查问卷
    • 启动或拒绝待处理的代理
    • 暂停和终止实时代理

2024 年 2 月 27 日

新

  • 在代理机构信息中，您现在可以提供电子邮件联系信息或电话号码。（只需提供一种联系方式，但建议同时提供两种。）

新

  • 现在，您可以使用 RBM 在已向 SMS Retriever API 注册的应用中发送一次性密码 (OTP)，以自动验证用户身份。
    • 借助 SMS Retriever API，您可以简化用户验证流程，而无需进行额外的开发工作。
    • 由于延迟时间缩短、验证成功率提高以及自动输入 OTP 的便利性，用户可以享受更快、更顺畅的验证流程。

2023 年 12 月 21 日

新

  • 现在，注册 RBM 的合作伙伴可以访问基于合作伙伴的 RBM 模型。基于合作伙伴的模型可实现以下功能：

2023 年 12 月 20 日

已更改

  • 您现在无法再删除 RBM 代理。

2023 年 12 月 8 日

已更改

2023 年 11 月 29 日

新

  • 对于时效性消息（例如一次性密码、紧急通知、提醒和限时优惠），消息过期至关重要。现在，您可以简化开发者逻辑并设置消息过期时间，以便及时递送消息。通过设置新的 expiration 字段，您可以自动撤消在特定时间未送达的消息，然后将其重新路由到备用渠道。

2023 年 11 月 13 日

新

  • 现在，您的代理可以通过上传文件或指定公开可用的网址来发送 PDF 文件。

2023 年 10 月 16 日

新

2023 年 9 月 30 日

新

  • Google 已将 RBM 可达性扩展到连接不太稳定的用户。因此，您可能会发现，向这些用户发送的消息的传送率更高，但传送延迟时间也更长。为了帮助及时递送消息，您可以设置消息过期时间或手动撤消消息，然后通过其他渠道发送消息。

2023 年 7 月 3 日

已更改

2023 年 6 月 23 日

新

2023 年 5 月 10 日

新

  • RBM 与 Google 钱包的新集成功能可让您通过 Google 信息中的丰富对话来发放登机牌。这意味着，钱包和“信息”应用的用户可以直接在 Google 的“信息”应用中完成值机流程、接收登机牌并将其添加到钱包中。
  • 新用例介绍了如何从 Google 的“信息”应用中将登机牌无缝添加到 Google 钱包。该用例包含一个示例对话，其中提供了完整的办理值机流程的技术步骤和设计提示。

2023 年 4 月 14 日

新

2023 年 4 月 13 日

新

  • 添加了 Pub/Sub 拉取的 C# 代码段。

已更改

2023 年 4 月 11 日

已更改

2022 年 12 月 13 日

新

已更改

  • 更新了运营商控制台链接，以与最近的控制台更改保持一致。

2022 年 11 月 15 日

已更改

新

  • 使用场景现在是创建代理时必须填写的字段，用于标识 RBM 对话的性质，并帮助商家遵守业务规则。

新

  • 借助新的持久性且可关闭的用户界面，用户现在可以更轻松地使用“屏蔽和举报”功能。

2022 年 11 月 3 日

新

  • Aware RBM 开发者注册。 RBM 开发者使用的 Google 账号现在必须与公司电子邮件地址相关联，而不能与 Gmail 账号相关联。

2022 年 11 月 2 日

新

2021 年 8 月 26 日

新

  • agentId 字段用于标识用户生成的消息或事件所属的代理。请参阅接收消息和活动。

2021 年 5 月 3 日

新

  • 代理可以使用 users.batchGet 通过一次 API 调用对最多 10,000 个电话号码执行批量功能检查。请参阅功能检查。

已更改

2020 年 4 月 2 日

新

  • RBM 代理现在可以为不支持原生应用的客户端设置 DialAction、ViewLocationAction、CreateCalendarEventAction 和 ShareLocationAction 的 fallbackUrl。请参阅指南和参考。
  • 所有示例和客户端库均已更新，以支持 fallbackUrl。 请参阅示例。

2019 年 12 月 20 日

新

  • 除了通过网址上传文件之外，RBM 代理现在还可以上传媒体文件二进制文件。请参阅指南和参考。

2019 年 12 月 2 日

新

  • 批量功能检查脚本（登录即可下载） 演示了如何使用 RBM SDK 检查大量设备的 RBM 功能。如需针对未注册为测试人员的设备运行此脚本，必须启动代理。

已更改

  • 功能检查现在涵盖批量功能检查脚本的配置和使用。
  • 示例现在包含“工具”部分。