请按照本指南提供必要信息，以排查 RBM 问题。
消息传送和格式问题
这些是消息的实际传输和接收方面的问题，包括消息格式问题。
无法发送 RBM 消息
请尽可能提供以下详细信息，以便我们更快地排查问题：
- 包含时间戳的消息 ID 示例
- 合作伙伴 ID（请参阅屏幕截图）
- 受影响的代理数量
- 代理 ID（以英文逗号分隔）
- 受影响或可能受影响的邮件数量（估算值）
- 您遇到问题的 API 方法（例如：上传文件、创建代理向用户发送的消息、创建代理向用户发送的事件、删除代理向用户发送的消息、获取功能、批量获取）
- 失败请求的 JSON 载荷示例
- 对于客户端问题：客户端 bug 报告
错误日志（调用 RBM API 时在终端中看到的错误），包括错误代码和错误消息。例如：
"error": { "code": 403, "message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.", "status": "PERMISSION_DENIED", }未在 webhook 中收到事件或消息
为确保顺利传送消息，请验证您所有合作伙伴账号的客服人员 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 发现并解决与其实现相关的任何问题。
- 在 iOS 设备上打开反馈助理应用。
- 选择与即时通讯应用问题相关的适当起始主题。
- 撰写并提交反馈。
- 为了让 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 访问的用户发送消息的延迟时间，请先运行功能检查。 |
如果问题仍然存在，请提供尽可能多的其他详细信息，以便我们更快地排查问题：
- 受影响的邮件数量
- 延迟来源（例如：上传文件、创建代理向用户发送的消息、创建代理向用户发送的事件、删除代理向用户发送的消息、获取 capability、批量获取）
- 服务端点
- 延迟时间分布（第 50 百分位、第 95 百分位、第 99 百分位）
- 延迟时间变化和时间范围
- 合作伙伴 ID
- 受影响的代理 ID
- 包含时间戳的消息 ID
- JSON 载荷
轮播界面和复合信息卡呈现问题
此类问题的示例包括无法加载、显示黑屏、剪裁和建议操作未显示。
请尽可能提供以下详细信息，以便我们更快地排查问题：
- 包含时间戳的消息 ID
- JSON 载荷
- 重现问题的设备步骤（如果已知）
- 接收消息的设备上的bug 报告
- 有关所用设备和即时通讯应用版本的详细信息
- 问题的屏幕截图或录像
账号、代理和运营商管理问题
这些问题与账号管理和报告（包括结算查询）有关。
无法添加测试人员
请按照设置测试设备中的步骤操作。
如果问题仍然存在，请提供以下详细信息，以便我们更快地排查问题：
- 代理 ID
- 电话号码
- 运营商名称和所在国家/地区
运营商无法批准代理启动
对于紧急发布，请提供以下信息：
- 运营商名称和所在国家/地区
- 要启动的代理 ID
- 运营商发布授权
请求更新客服人员详细信息
请提供以下详细信息，以便我们更快地进行更新：
- 代理 ID
- 您要更改的详细信息
- 您确认要取消启动代理
对于以下字段，RBM 支持团队将取消发布代理。然后，您可以更改代理，并重新提交以发布。
- 显示名称
- 说明
- 颜色
- 徽标和横幅图片
- 代理联系信息，例如电话号码、网站和电子邮件地址
- 隐私权和服务条款
对于以下字段，RBM 支持团队将取消发布代理并修改这些字段（RBM 合作伙伴无法直接修改这些字段）：
- 结算类别
- 使用场景
- 品牌名称
- 品牌联系人姓名
- 品牌联系人电子邮件 ID
- 品牌的网站网址
- 消息服务合作伙伴联系人姓名
- 消息服务合作伙伴联系人电子邮件地址
如果您想在不停用代理的情况下修改代理信息，请向代理目前已发布的运营商管理的网络中的联系人获取电子邮件批准。收集完所有批准电子邮件后，请将其与 RBM 支持团队分享，并提供所需修改的具体信息。
RBM 支持团队将验证批准情况，如果一切顺利，将实施更改并与您和相应运营商进行确认。请注意，此流程可能会因不同国家/地区的各个运营商的具体流程而异。
申请更改 RBM 合作伙伴账号
如果 RBM 合作伙伴在运营商管理的网络上发布了任何代理，请按以下步骤操作：
- 从运营商管理的网络（您的任何客服人员都已在其中发布）的联系人处获取电子邮件审批。
- 请向 RBM 支持团队提供以下详细信息：
- RBM 合作伙伴 ID
- 您要更改的详细信息
验证批准和详细信息后，RBM 支持团队会通知运营商待处理的更改。我们会在收到运营商通知后的 24 小时内实施并确认这些更改。
请求将代理从 RBM 合作伙伴 A 迁移到合作伙伴 B
如果代理已在运营商管理的网络上发布，请按以下步骤操作：
- 从品牌联系人和运营商管理的广告网络的联系人处获取电子邮件审批。
- 请务必抄送新的 RBM 合作伙伴这些审批电子邮件。
- 请向 RBM 支持团队提供以下详细信息：
- 代理 ID
- 品牌联系人和运营商发来的电子邮件批准
- 原始 RBM 合作伙伴 ID 和新的 RBM 合作伙伴 ID
验证批准和详细信息后，RBM 支持团队会通知运营商待处理的更改。我们会在收到运营商通知后的 24 小时内实施并确认这些更改。
请求将客服人员迁移到其他合作伙伴账号
请提供以下详细信息，以便我们更快地进行更新：
- 代理 ID 列表
- 旧合作伙伴 ID
- 新合作伙伴 ID
结算事件报告中缺少信息
请提供以下详细信息，以便我们更快地排查问题：
- 缺少文件的日期
- 代理 ID