RBM 问题排查指南

请按照本指南提供必要的信息，以便排查 RBM 问题。

消息传送和格式问题

这些问题与消息的实际发送和接收有关，包括消息格式设置问题。

无法发送 RBM 消息

请尽可能多地分享以下详细信息，以便我们更快地排查问题：

• 包含时间戳的示例消息 ID
• 合作伙伴 ID（请参阅屏幕截图）
• 受影响的代理数量
• 代理 ID（以英文逗号分隔）
• 受影响或可能受影响的邮件的估计数量
• 您遇到问题的 API 方法（例如：上传文件、创建代理与用户之间的消息、创建代理与用户之间的事件、删除代理与用户之间的消息、获取功能、批量获取）
• 失败请求的 JSON 载荷示例
• 对于客户端问题：客户端 bug 报告

• 错误日志（调用 RBM API 时在终端中看到的错误），包括错误代码和错误消息。例如：

  "error": {
  "code": 403,
  "message": "There was an error looking up the RBM agent (ID: [email protected]) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
  "status": "PERMISSION_DENIED",
  }
  

  未在 webhook 中收到事件或消息

为确保消息顺利传递，请验证您合作伙伴账号的所有代理网络钩子是否正常运行，以及是否可以处理来自 Google 的消息。合作伙伴账号中的所有客服人员共用一个用于接收消息和事件的渠道，因此，如果网络钩子出现故障，可能会导致所有客服人员都无法接收消息。

如果问题仍然存在，请分享以下详细信息，以便我们更快地排查问题：

• 问题是从何时开始的？在此之前，您是否成功接收到消息和活动？
• 合作伙伴 ID
• 代理 ID
• 网络钩子网址
• 带有时间戳的消息 ID

以 JSON 格式发送或转换为短信的 RBM 消息

请尽可能多地分享以下详细信息，以便我们更快地排查问题：

• 带有时间戳的消息 ID
• JSON 载荷
• 如果知道，请提供重现问题的设备步骤
• 接收消息的设备的 bug 报告
• 有关所用设备和即时通讯应用版本的详细信息
• 问题的屏幕截图或视频录制

无法在支持 RCS 的设备上接收消息

请尽可能多地分享以下详细信息，以便我们更快地排查问题：

• 无法接收 RBM 消息的设备的 bug 报告
• 电话号码
• 有关设备和操作系统的详细信息
• 所用即时通讯应用的版本
• 重现步骤（如果已知）
• 显示 RCS 状态的屏幕截图
• 问题的屏幕截图或视频录制
• 运营商名称和国家/地区

客户端和设备设置/连接问题

这些问题包括客户端设置、连接和平台特定问题。

无法生成 P2A 网址或二维码

请尽可能多地分享以下详细信息，以便我们更快地排查问题：

• 代理 ID
• Business Communications 开发者控制台中显示的 JavaScript 错误的详细信息

无法打开 RBM 深层链接

请尽可能多地分享以下详细信息，以便我们更快地排查问题：

• 代理 ID
• 电话号码
• 重现步骤（如果已知）
• 打开链接的设备中的 bug 报告
• 问题的屏幕截图或视频录制

与功能检查相关的问题

分享以下详细信息有助于我们更快地排查问题：

• 包含国家/地区代码的电话号码列表（以 CSV 文件形式提供）
• 代理 ID
• 错误日志
• 设备的 RCS 状态
• 执行测试的日期和时间

测试设备未收到测试人员邀请或消息

按照设置测试设备中的步骤操作。

如果问题仍然存在，请分享以下详细信息，以便我们更快地排查问题：

• 代理 ID
• 电话号码
• 含时间戳的消息 ID
• 在发送测试邀请后的 5 分钟内提交 bug 报告

iOS 设备上的 RCS/RBM 问题

虽然 Apple 采用了富通讯解决方案 (RCS) 标准来处理消息，但他们选择开发自己的独特实现。这包括 RCS Business Messaging (RBM) 等功能。

如果您在 iOS 设备上使用 RBM 时遇到任何问题，建议您通过“反馈助理”应用直接向 Apple 报告。这有助于 Apple 识别并解决其实现中存在的任何特定问题。

1. 在 iOS 设备上打开反馈助理应用。
2. 选择一个与即时通讯应用问题相关的合适起始主题。
3. 撰写并提交反馈。
4. 为了让 RBM 支持团队及时了解情况，请同时与我们分享您的发现。 感谢您帮助我们为所有用户改进 RCS 体验。

iOS 设备上支持 RCS/RBM 的运营商

Apple 在 iOS 上推出 RCS/RBM 时，会自行选择运营商。如需咨询全球发布情况或 Apple 的未来计划，请直接与 Apple 联系。您还可以与感兴趣的运营商联系，询问其在 iOS 上推出 RCS/RBM 的状态。

如需查找有关 iPhone 的无线运营商支持和功能（按国家/地区）的信息，请访问 Apple 支持页面。

效果和展示问题

这些问题与 RBM 的性能和显示有关。

执行 RBM 操作时的延迟时间

请务必先检查以下各项：

问题	建议
延迟时间是否为 <5s？	如果是，则属于可接受的范围。
延迟时间是否出现任何回归？	如果是，该问题是从何时开始的？之前与现在的典型延迟时间是多少？
您是否使用了文件上传 API？	尝试使用文件 ID 而不是直接发送网址。处理新的媒体网址涉及下载、处理、缩略图、滥用防护和病毒防护，其中病毒防护大约需要花费 50% 的时间。
您是否已预先上传消息媒体？	为了加快处理速度，我们建议您通过以下 API 调用来执行此操作：https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create
您是否运行过功能检查？	为了减少向无法通过 RCS 联系的用户发送消息时的延迟，请先运行功能检查。

如果问题仍然存在，请尽可能提供更多详细信息，以便我们更快地排查问题：

• 受影响的邮件数量
• 延迟来源（例如：上传文件、创建代理到用户消息、创建代理到用户事件、删除代理到用户消息、获取功能、批量获取）
• 服务端点
• 延迟时间分布（第 50、95、99 百分位）
• 延迟时间变化和时间范围
• 合作伙伴 ID
• 受影响的代理 ID
• 带有时间戳的消息 ID
• JSON 载荷

轮播和复合信息卡呈现问题

此问题的示例包括无法加载、显示黑屏、画面裁剪以及建议的操作未显示。

请尽可能多地分享以下详细信息，以便我们更快地排查问题：

• 带有时间戳的消息 ID
• JSON 载荷
• 如果知道，请提供重现问题的设备步骤
• 接收消息的设备的 bug 报告
• 有关所用设备和即时通讯应用版本的详细信息
• 问题的屏幕截图或视频录制

账号、代理和运营商管理问题

这些问题与账号管理和报告有关，包括结算查询。

无法添加测试人员

按照设置测试设备中的步骤操作。

如果问题仍然存在，请分享以下详细信息，以便我们更快地排查问题：

• 代理 ID
• 电话号码
• 运营商名称和国家/地区

运营商无法批准代理启动

通过 RBM 管理控制台报告问题（请参阅屏幕截图）。

对于紧急发布，请提供以下信息：

• 运营商名称和国家/地区
• 要启动的代理 ID
• 运营商的发布授权

请求更新代理详情

分享以下详细信息，以便更快地接收更新：

• 代理 ID
• 您要更改的详细信息
• 您确认取消发布代理

对于以下字段，RBM 支持团队将取消发布相应代理。然后，您可以对代理进行更改，并重新提交以供发布。

• 显示名称
• 说明
• 颜色
• 徽标和横幅图片
• 代理商联系信息，例如电话号码、网站和电子邮件地址
• 隐私权和服务条款

对于以下字段，RBM 支持团队将取消发布代理并修改相应字段（RBM 合作伙伴无法直接修改这些字段）：

• 结算类别
• 使用场景
• 品牌名称
• 品牌联系人姓名
• 品牌联系人电子邮件地址 ID
• 品牌的网站网址
• 消息服务合作伙伴联系人姓名
• 消息服务合作伙伴联系人电子邮件地址

如果您想在不取消发布代理的情况下修改代理信息，请从代理当前已发布的运营商管理网络中的联系人处获取电子邮件批准。收集完所有审批电子邮件后，请将这些电子邮件以及所需修改的具体信息一并发送给 RBM 支持团队。

RBM 支持团队会验证审批情况，如果一切正常，则会实施更改，并与您和相关运营商确认更改。 请注意，此流程可能会因不同国家/地区的各个运营商的程序而有所不同。

申请更改 RBM 合作伙伴账号

如果 RBM 合作伙伴在运营商管理的网络上发布了任何代理，请按以下步骤操作：

1. 从运营商管理的网络中的联系人处获取电子邮件审批，以便在这些网络中启动您的任何代理。
2. 请向 RBM 支持团队提供以下详细信息：
   • RBM 合作伙伴 ID
   • 您要更改的详细信息

在验证审批和详细信息后，RBM 支持团队会通知运营商待处理的更改。这些变更将在收到相应运输公司的通知后 24 小时内实施并确认。

请求将代理从 RBM 合作伙伴 A 迁移到合作伙伴 B

如果代理已在运营商管理的网络上发布，请按以下步骤操作：

1. 从品牌联系人和运营商管理的网络中的联系人处获取电子邮件审批。
   • 确保在这些审批电子邮件中将新的 RBM 合作伙伴添加为抄送对象。
2. 请向 RBM 支持团队提供以下详细信息：
   • 代理 ID
   • 品牌联系人和运营商的电子邮件审批
   • 新的合作伙伴 ID

在验证审批和详细信息后，RBM 支持团队会通知运营商待处理的更改。这些变更将在收到相应运输公司的通知后 24 小时内实施并确认。

请求将客服人员迁移到其他合作伙伴账号

分享以下详细信息，以便更快地接收更新：

• 代理 ID 列表
• 旧合作伙伴 ID
• 新合作伙伴 ID

结算事件报告中缺少信息

分享以下详细信息有助于我们更快地排查问题：

• 缺少文件的日期
• 代理 ID