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: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
"status": "PERMISSION_DENIED",
}

执行 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 载荷

未在 webhook 中收到事件或消息

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

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

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

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

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

  • 包含时间戳的消息 ID
  • JSON 载荷
  • 重现问题的设备步骤（如果已知）
  • 接收消息的设备的 bug 报告
  • 有关所用设备和即时通讯应用版本的详细信息
  • 问题的屏幕截图或录像

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

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

  • 包含时间戳的消息 ID
  • JSON 载荷
  • 重现问题的设备步骤（如果已知）
  • 接收消息的设备的 bug 报告
  • 有关所用设备和即时通讯应用版本的详细信息
  • 问题的屏幕截图或录像

未能生成 P2A 网址或二维码

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

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

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

无法在启用了 RCS 的设备上接收消息

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

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

无法添加测试人员

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

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

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

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

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

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

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

与功能检查相关的问题

请提供以下详细信息，以便我们更快地排查问题：

  • 包含国家/地区代码的电话号码列表（封装在 CSV 文件中）
  • 代理 ID
  • 错误日志
  • 设备的 RCS 状态

结算事件报告中缺少信息

请提供以下详细信息，以便我们更快地排查问题：

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

运营商无法批准代理启动

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

对于紧急发布，请提供：

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

请求更新客服人员详细信息

请提供以下详细信息，以便更快地获得更新：

  • 代理 ID
  • 要更新的元数据详细信息（例如：名称、徽标、横幅、说明、详细联系信息、隐私权政策链接或服务条款链接）

请求将代理迁移到其他合作伙伴账号

请提供以下详细信息，以便更快地获得更新：

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