请按照本指南提供必要信息,以排查 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、批量获取)
- 服务端点
- 延迟时间分布(p50、p95、p99)
- 延迟时间变化和时间范围
- 合作伙伴 ID
- 受影响的代理 ID
- 带时间戳的消息 ID
- JSON 载荷
轮播界面和复合信息卡呈现问题
此类问题的示例包括无法加载、显示黑屏、剪裁和建议操作未显示。
请尽可能提供以下详细信息,以便我们更快地排查问题:
- 带时间戳的消息 ID
- JSON 载荷
- 重现问题的设备步骤(如果已知)
- 接收消息的设备上的bug 报告
- 有关所用设备和即时通讯应用版本的详细信息
- 问题的屏幕截图或录像
账号、代理和运营商管理问题
这些问题与账号管理和报告有关,包括结算查询。
无法添加测试人员
请按照设置测试设备中的步骤操作。
如果问题仍然存在,请提供以下详细信息,以便我们更快地排查问题:
- 代理 ID
- 电话号码
- 运营商名称和国家/地区
运营商无法批准代理启动
对于紧急发布,请提供:
- 运营商名称和国家/地区
- 要启动的代理 ID
- 运营商发布授权
请求更新客服人员详细信息
请提供以下详细信息,以便更快地获得更新:
- 代理 ID
- 要更新的元数据详细信息(例如:名称、徽标、横幅、说明、详细联系信息、隐私权政策链接或服务条款链接)
请求将代理迁移到其他合作伙伴账号
请提供以下详细信息,以便更快地获得更新:
- 代理 ID 列表
- 旧合作伙伴 ID
- 新的合作伙伴 ID
结算事件报告中缺少信息
请提供以下详细信息,以便我们更快地排查问题:
- 缺少文件的日期
- 代理 ID