View a markdown version of this page

从控制台发送丰富的 RCS 消息 - AWS 最终用户消息 SMS
先决条件发送丰富的 RCS 消息输入验证相关资源

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

从控制台发送丰富的 RCS 消息

AWS 最终用户消息控制台提供了一个可视化消息编辑器，您无需编写代码即可使用它来生成和发送丰富的 RCS 消息。作曲家直接映射到 SendRcsMessage API 并支持所有内容类型：短信、文件消息、富卡片和轮播。您可以为任何消息类型添加交互式建议，配置生存时间 (TTL) 设置，并为设备不支持 RCS 的收件人设置短信或彩信回退。

您可以从 RCS 测试界面的 “出站测试消息” 选项卡撰写和发送富消息。消息会发送给经过验证的 RBM 测试人员，这样您就可以在将 SendRcsMessage API 集成到应用程序中之前验证渲染和交付。

配置消息时，实时电话预览会显示消息在收件人设备上的呈现方式。您也可以复制等效的 JSON 负载或 AWS CLI 命令，以便在应用程序代码中使用相同的消息结构。

有关消息类型及其 API 结构的更多信息，请参阅发送丰富的 RCS 消息。有关建议类型和行为的详细信息，请参阅配置 RCS 建议。

先决条件

在从控制台发送丰富的 RCS 消息之前，请确认以下内容：

  • 您的 RCS 代理处于 “测试” 或 “活动” 状态。

  • 您至少有一个与您的代理关联的经过验证的 RBM 测试人员电话号码。有关设置说明，请参阅测试 RCS 消息。

  • 如果您计划从 Amazon S3 发送媒体文件，则 S3 存储桶必须具有授予sms-voice.amazonaws.com读取权限的存储桶策略。有关更多信息，请参阅 发送 RCS 文件消息。

发送丰富的 RCS 消息

使用以下过程从 AWS 最终用户消息控制台撰写和发送丰富的 RCS 消息。

  1. 打开 AWS 最终用户消息控制台，网址为https://console.aws.amazon.com/sms-voice/。

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

  3. 选择要用作原始身份的代理。代理状态必须为 “测试中” 或 “活动”。

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

  5. 在 RCS 测试界面中，选择出站测试消息选项卡。

  6. 在 “发送测试 RCS 消息” 部分中，在 “选择 RBM 测试人员” 中，选择经过验证的 RBM 测试人员电话号码。

  7. （可选）对于配置集，选择用于跟踪消息事件的配置集。

  8. 对于选择 API，选择SendRcsMessage。

  9. 在 “选择消息格式” 中，选择要发送的消息类型：

    • 文本：输入邮件正文（最多 3,072 个字符）。

    • 文件：对于媒体来源，选择 S3 存储桶或公共 URL，然后输入要发送的文件的 S3 URI（或 HTTPS 网址）。选择 Browse S3 以从存储桶中选择文件，或选择 “查看” 以在新的浏览器选项卡中打开引用的文件。最大 文件大小为 100MB。（可选）提供视频或 PDF 文件的缩略图 URL。

    • 富卡：配置以下卡片字段。标题、描述或媒体中至少有一条是必填的。

      • 卡片方向：选择VERTICAL或HORIZONTAL。

      • 卡片标题：输入标题（最多 200 个字符）。

      • 卡片描述：输入描述（最多 2,000 个字符）。

      • 媒体 URL：对于媒体来源，选择 S3 存储桶或公共 URL，然后输入 S3 URI（或 HTTPS 网址）。选择 “浏览 S3” 选择文件，或选择 “查看” 在新的浏览器选项卡中将其打开。最大 文件大小为 100MB。

      • （可选）媒体缩略图 URL：在加载完整媒体之前显示的预览图像。

      • （仅限水平方向）缩略图对齐方式：选择LEFT或RIGHT以放置缩略图图像。

      • 卡片建议：最多添加 4 条建议，这些建议以卡片边界内的按钮形式呈现。有关建议类型，请参阅配置 RCS 建议。

    • 旋转木马：配置以下内容：

      • 卡片宽度：选择SMALL或MEDIUM。

      • 介质高度（所有卡片）：选择SHORT或MEDIUM。旋转木马中的所有牌都使用相同的介质高度。

      • 卡牌：添加 2 到 10 张牌。每张卡片均包含卡片标题、卡片描述、媒体网址（S3 存储桶或公共网址，最大 100 MB）以及最多 4 张卡片建议。每张卡片至少需要一个标题、描述或媒介。

    • JSON：直接粘贴原始 RcsMessageContent JSON 有效负载。选择 “格式化 JSON” 以格式化有效负载。控制台会验证结构并实时更新电话预览。

  10. （可选）使用 S3 浏览器配置媒体文件：

    1. 选择浏览 S3。

    2. 从下拉列表中选择一个存储桶。

    3. 浏览前缀（文件夹）以找到您的文件。

    4. 选择 文件。URL 字段会自动填充。

    注意

    S3 存储桶必须具有授予对象sms-voice.amazonaws.com读取权限的存储桶策略。有关所需的策略，请参阅发送 RCS 文件消息。

  11. （可选）添加消息级建议。在 “建议” 部分：

    1. 选择 “添加建议”。

    2. 对于 “建议类型”，选择 “回复”、“打开 URL”、“拨打电话”、“显示位置”、“请求位置” 或 “日历事件” 之一。

    3. 输入所选类型的必填字段。所有建议类型都需要一个Text值（最多 25 个字符）和PostbackData（最多 2,048 个字符）。

    4. 重复此操作，最多可添加 11 条消息级建议。

    Message-level 建议在整条消息下方以筹码列表的形式呈现。您可以将消息级别的建议附加到任何内容类型（文本、文件、富卡片或轮播）。有关更多信息，请参阅 配置 RCS 建议。

  12. （可选）配置生存时间 (TTL) 设置。展开 “高级选项”，然后在 “生存时间（秒）” 字段中输入一个值。有效值范围为 1 到 172,800 秒（48 小时）。我们建议将最小值设置为 10 秒。

    如果消息未在 TTL 到期之前传送，则该服务会触发 TTL 过期事件。如果您配置了回退，则将在此时发送回退消息。

    高级选项部分还包含最高价格（美元）、试运行、消息反馈、保护配置和上下文（可选的键值元数据）。

  13. （可选）配置短信或彩信回退。展开 “备用配置” 部分：

    1. 对于备用频道，请选择短信或彩信。

    2. 在备用邮件正文中，输入消息文本（最多 1,600 个字符）。选择备用频道时，需要消息正文。

    3. 对于彩信，您还可以提供一个或多个媒体网址。

    4. 对于来源身份，请输入用于后备短信或彩信的电话号码或发件人 ID。从 RCS 代理发送时，这是必需的。

    当消息无法通过 RCS 传送时（例如，当收件人的设备不支持 RCS 或 TTL 到期时），就会触发回退。有关更多信息，请参阅 发送丰富的 RCS 消息。

  14. （可选）在 “高级” 选项中，启用 D ry run，无需发送即可验证消息结构。这不会产生费用，也不会将邮件传送给收件人。

  15. 查看作曲家右侧的手机预览。预览会实时更新并显示：

    • 内容呈现（文本、媒体、卡片布局、轮播滚动）

    • 消息下方的建议芯片

    • Card-level 卡片中的按钮

    注意

    预览版近似于安卓渲染。在 iOS 或其他 RCS 客户端上的显示可能有所不同。预览不会模拟建议选择行为。

  16. 选择 “发送测试消息” 将消息发送给选定的 RBM 测试员，或者使用以下选项之一：

    • 复制 JSON：将消息 JSON 复制到剪贴板。选择RcsMessageContent仅复制内容部分，或选择完整 API 请求以复制完整的SendRcsMessage请求正文。

    • 复制 CLI 命令：复制等效的aws pinpoint-sms-voice-v2 send-rcs-message命令。

输入验证

控制台会在您配置消息时执行实时验证。验证错误以内联方式显示在受影响的字段旁边。下表汇总了验证规则。

控制台验证规则
字段 规则
Phone number（电话号码） 必须是 E.164 格式化的
媒体网址 必须以https://或开头 s3://
媒体文件大小 最大 100 MB
建议文本 最多 25 个字符
回发数据 最多 2,048 个字符
卡牌标题 最多 200 个字符
卡片描述 最多 2000 个字符
旋转木马卡 最少 2 个，最大 10 个
Card-level 建议 每张卡最多 4 张
Message-level 建议 最多 11
短信正文 最多 3,072 个字符
TTL 1 到 172,800 秒
备用消息正文 最多 1,600 个字符