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

# 从控制台发送丰富的 RCS 消息
<a name="rcs-console-rich-messaging"></a>

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

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

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

有关消息类型及其 API 结构的更多信息，请参阅[发送丰富的 RCS 消息](rcs-rich-messaging.md)。有关建议类型和行为的详细信息，请参阅[配置 RCS 建议](rcs-suggestions.md)。

## 先决条件
<a name="rcs-console-rich-messaging-prereqs"></a>

在从控制台发送丰富的 RCS 消息之前，请确认以下内容：
+ 您的 RCS 代理处于 “**测试**” 或 “活动” **状态**。
+ 您至少有一个与您的代理关联的经过验证的 RBM 测试人员电话号码。有关设置说明，请参阅[测试 RCS 消息](rcs-testing.md)。
+ 如果您计划从 Amazon S3 发送媒体文件，则 S3 存储桶必须具有授予`sms-voice.amazonaws.com`读取权限的存储桶策略。有关更多信息，请参阅 [发送 RCS 文件消息](rcs-file-messages.md)。

## 发送丰富的 RCS 消息
<a name="rcs-console-rich-messaging-procedure"></a>

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

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

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

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

1. 选择 “**测试**” 选项卡。

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

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

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

1. 对于**选择 API**，选择**SendRcsMessage**。

1. <a name="rcs-console-rich-messaging-content-type"></a>**在 “选择消息格式**” 中，选择要发送的消息类型：
   + **文本**：输入邮件正文（最多 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 建议](rcs-suggestions.md)。
   + **旋转木马**：配置以下内容：
     + **卡片宽度**：选择`SMALL`或`MEDIUM`。
     + **介质高度（所有卡片）**：选择`SHORT`或`MEDIUM`。旋转木马中的所有牌都使用相同的介质高度。
     + **卡牌**：添加 2 到 10 张牌。每张卡片均包含卡片标题、卡片描述、媒体网址（S3 存储桶或公共网址，最大 100 MB）以及最多 4 张卡片建议。每张卡片至少需要一个标题、描述或媒介。
   + **JSON**：直接粘贴原始 `RcsMessageContent` JSON 有效负载。选择 “**格式化 JSON**” 以格式化有效负载。控制台会验证结构并实时更新电话预览。

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

   1. 选择**浏览 S3**。

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

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

   1. 选择 文件。URL 字段会自动填充。
**注意**  
S3 存储桶必须具有授予对象`sms-voice.amazonaws.com`读取权限的存储桶策略。有关所需的策略，请参阅[发送 RCS 文件消息](rcs-file-messages.md)。

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

   1. 选择 “**添加建议**”。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. 查看作曲家右侧的手机预览。预览会实时更新并显示：
   + 内容呈现（文本、媒体、卡片布局、轮播滚动）
   + 消息下方的建议芯片
   + Card-level 卡片中的按钮
**注意**  
预览版近似于安卓渲染。在 iOS 或其他 RCS 客户端上的显示可能有所不同。预览不会模拟建议选择行为。

1. 选择 “**发送测试消息**” 将消息发送给选定的 RBM 测试员，或者使用以下选项之一：
   + **复制 JSON**：将消息 JSON 复制到剪贴板。选择**RcsMessageContent**仅复制内容部分，或选择完整 **API 请求**以复制完整的`SendRcsMessage`请求正文。
   + **复制 CLI 命令**：复制等效的`aws pinpoint-sms-voice-v2 send-rcs-message`命令。

## 输入验证
<a name="rcs-console-rich-messaging-validation"></a>

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


**控制台验证规则**  

| 字段 | 规则 | 
| --- | --- | 
| 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 个字符 | 

## 相关资源
<a name="rcs-console-rich-messaging-related"></a>
+ [发送丰富的 RCS 消息](rcs-rich-messaging.md)
+ [配置 RCS 建议](rcs-suggestions.md)
+ [测试 RCS 消息](rcs-testing.md)
+ [发送 RCS 文件消息](rcs-file-messages.md)