View a markdown version of this page

测试 RCS 消息 - AWS 最终用户消息 SMS
什么是测试代理？添加测试设备测试人员邀请流程查看测试设备发送测试消息测试 SMS 备用消息RCS 测试疑难解答

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

测试 RCS 消息

在生产环境中启动 RCS 消息传送之前，您可以使用测试代理来测试您的集成。测试代理是 RCS for Business ID，在您提交 AWS RCS 代理的测试注册时创建。它提供与生产设备相同的完整 API 访问权限，但仅将消息传送到注册的测试设备。测试无需承运人批准。

本章重点介绍测试代理本身，包括如何管理测试设备以及如何解决常见问题。有关创建第一个 AWS RCS 代理和发送测试消息的分步演练，请参阅。RCS 入门有关创建 AWS RCS 代理和提交测试注册的详细信息，请参阅管理 RCS 代理。

重要

测试消息按标准 RCS 费率收费。测试代理提供了一个测试环境来验证您的集成，但是向测试设备传送消息会产生与生产消息相同的费用。

什么是测试代理？

测试代理是 AWS 最终用户消息在您提交 AWS RCS 代理的测试注册时创建的 RCS for Business ID。测试代理允许您：

  • 未经运营商批准向注册的测试设备发送 RCS 消息

  • 使用 SendTextMessage API 发送测试消息，与您在生产中使用的 API 相同

  • 为您的测试工作流程配置池、配置集、选择退出列表、关键字和其他 AWS 最终用户消息功能

  • 通过发送带有自动回复关键字的消息来测试双向消息

  • 使用或不使用经批准的 SMS 电话号码来测试短信回退行为

您注册为测试代理的测试设备可在所有国家/地区使用 AWS RCS 代理。您无需为每个国家/地区单独注册测试设备。相反，测试代理可以向任何国家的测试设备发送消息，无论您是否提交了该国家/地区的发射登记。

添加测试设备

在发送测试 RCS 消息之前，必须将一台或多台测试设备注册为经过验证的目标号码。您可以使用 AWS 最终用户消息控制台或 CreateVerifiedDestinationNumber API 添加测试设备。

Console

在控制台中，测试设备在 AWS RCS 代理的 “测试” 选项卡中的 RBM 测试器管理子选项卡上进行管理。有关控制台的分步说明，请参阅第 2 步：添加测试设备。

AWS CLI

使用带有--rcs-agent-id参数的create-verified-destination-number命令为您的 AWS RCS 代理注册测试设备：

aws pinpoint-sms-voice-v2 create-verified-destination-number \
    --destination-phone-number +12065550100 \
    --rcs-agent-id rcs-a1b2c3d4
注意

--origination-identity 参数不是必需参数。当您指定时--rcs-agent-id，该命令会向该代理注册 RCS 测试的电话号码。当您省略--rcs-agent-id并--origination-identity改用时，该命令会发送一条 OTP 短信进行短信验证。这两个参数是互斥的。

测试人员邀请流程

添加测试设备后， AWS 最终用户消息会从名为 RBM 测试人员管理的 RCS 代理发送测试人员邀请。邀请包含接受或拒绝的按钮。有关测试人员邀请流程的详细信息，包括 120 秒的等待要求和 i OS-specific 行为，请参阅。第 2 步：添加测试设备

查看测试设备

您可以使用 AWS 最终用户消息控制台或 DescribeVerifiedDestinationNumbers API 查看为您的 AWS RCS 代理注册的测试设备。

Console

要在控制台中查看您注册的测试设备，请导航到您的 AWS RCS 代理的详细信息页面，然后选择测试选项卡。选择 RBM 测试器管理子选项卡，查看与代理相关的所有经过验证的目的地号码，包括其验证状态和电话号码。

AWS CLI

使用describe-verified-destination-numbers命令列出您的 AWS RCS 代理的测试设备。使用带rcs-agent-id的--filters参数仅显示 RCS 测试设备：

aws pinpoint-sms-voice-v2 describe-verified-destination-numbers \
    --filters Name=rcs-agent-id,Values=rcs-a1b2c3d4

您注册为测试代理的测试设备在全球范围内适用于该 AWS RCS 代理。在一个 AWS 区域注册的测试设备可以接收从您的 AWS RCS 代理可用的任何 AWS 区域发送的测试消息。

发送测试消息

在测试设备接受测试人员邀请后，您可以向其发送 RCS 消息。您可以使用 AWS 最终用户消息控制台或 SendTextMessage API 发送测试消息。

Console
使用控制台发送测试消息

  1. 打开 AWS 最终用户消息控制台。

  2. 在导航窗格的 “配置” 下，选择 RCS 代理。

  3. 选择您要测试的 AWS RCS 代理。

  4. 选择 “测试” 选项卡。

  5. 在发送测试消息部分，从列表中选择经过验证的测试设备。

  6. 输入您的消息文本。

  7. 选择发送测试消息。

AWS CLI

使用该send-text-message命令向经过验证的目标号码发送测试消息。指定 AWS RCS 代理 ARN 作为原始身份：

aws pinpoint-sms-voice-v2 send-text-message \
    --destination-phone-number +12065550100 \
    --origination-identity arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4 \
    --message-body "Hello from RCS testing!"

测试 SMS 备用消息

您可以测试 SMS 回退行为，以验证在无法传送 RCS 时您的消息是否通过 SMS 传送。有关测试 SMS 后备的完整说明，包括在没有经批准的 SMS 号码的情况下进行测试以及完整的端到端流程，请参阅测试短信回退。

RCS 测试疑难解答

以下各节描述了您在测试 RCS 消息时可能遇到的常见问题以及如何解决这些问题。

测试设备未收到 RCS 消息

如果您的测试设备未收到 RCS 消息，请检查以下内容：

  • 确认测试设备已接受测试人员邀请。使用带有rcs-agent-id过滤器DescribeVerifiedDestinationNumbers的 API 来检查设备的验证状态。

  • 确认测试设备已启用 RCS。在 Android 上，检查消息应用程序中是否有 RCS 或聊天功能的设置。在 iPhone 上，RCS 需要 iOS 18 或更高版本。

  • 验证测试设备的数据连接是否处于活动状态。RCS 消息通过数据传送，而不是通过短信渠道传送。

  • 确认您以正确的 E.164格式发送到正确的电话号码。

消息以 SMS 而不是 RCS 的形式发送

如果您的测试消息以 SMS 而不是 RCS 的形式发送，请检查以下内容：

  • 验证您是否使用 AWS RCS 代理 ARN 或包含 AWS RCS 代理作为发起身份的池发送消息。如果您仅指定 SMS 电话号码，则消息将通过 SMS 发送。

  • 确认测试设备已接受测试人员邀请并已注册为正确 AWS RCS 代理的经过验证的目的地号码。

  • 检查传送事件，以确定该消息最初是通过 RCS 尝试后回退到 SMS，还是直接通过 SMS 发送。

未收到测试者邀请

如果测试设备未收到测试者邀请，请检查以下内容：

  • 添加测试设备后，测试者邀请可能需要 20 分钟才能到达。如果 20 分钟后仍未收到邀请，请移除测试设备并重新添加。

  • 验证电话号码的 E.164 格式是否正确并且是有效的手机号码。

  • 确认测试设备具有活动数据连接并且 RCS 已启用。

iOS：“未知发件人” 中的测试者邀请

在 iOS 设备（装有 iOS 18 或更高版本的 iPhone）上，来自 RBM 测试人员管理的测试人员邀请可能会被过滤到 “消息” 应用程序中的 “未知发件人” 文件夹中。这是来自未知联系人的消息的默认 iOS 行为。

要查找邀请，请执行以下操作：

在 iOS 上查找测试者邀请

  1. 在 iPhone 上打开 “消息” 应用程序。

  2. 点按左上角的 “过滤器”（或从消息列表向右滑动）。

  3. 点击 “未知发件人”。

  4. 查找 RBM 测试人员管理消息，然后点击 “让我成为测试员” 以接受邀请。