本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 管理 RCS 代理 AWS RCS 代理是 AWS 最终用户消息中的顶级资源，它代表您的 RCS 消息传递品牌。它充当将您的测试代理和国家/地区启动代理绑定在一起的统一资源（RCS for Bus IDs iness）。关键字和双向消息配置在 AWS RCS 代理上定义。品牌资产是在每次注册时定义的（测试代理或国家/地区发布代理）。有关 AWS RCS 代理与企业版 RCS 的关系的概述 IDs，请参阅。[什么是 RCS？](rcs-overview.md) AWS RCS 代理遵循以下生命周期： 1. **创建** AWS RCS 代理。 1. **添加测试代理**（包含在控制台创建流程中；通过 CLI 可选）。 1. 使用注册的@@ **测试设备测试**您的 RCS 消息。无需承运人批准即可进行测试。 1. 为要向其发送@@ **正式版 RCS 消息的每个国家/地区提交国家/地区发布**注册表。 1. **部分批准**：至少有一家承运人批准了您的代理。您可以开始使用经批准的承运人向收件人发送邮件。 1. **完全批准**：该国的所有承运人均已批准您的代理。在那个国家全力以赴。 一个 AWS RCS 代理映射到一个测试代理（企业编号为 RCS）和多个国家/地区的启动代理（每个国家/地区一个 RCS 代表企业编号）。当您在控制台中创建 AWS RCS 代理时，该工作流程会立即指导您创建测试代理。然后，使用测试代理商的品牌配置来预先填充国家/地区发布注册表，从而减少重复的数据输入。 **Topics** + [了解 AWS RCS 代理](#rcs-agents-concept) + [了解两级身份模型](#rcs-agents-identity-model) + [创建 AWS RCS 代理](#rcs-agents-create) + [更新 AWS RCS 代理](#rcs-agents-update) + [查看 AWS RCS 代理](#rcs-agents-view) + [审查您的测试代理](#rcs-agents-review-test-agent) + [查看国家/地区发布状态](#rcs-agents-country-launch-status) + [删除 AWS RCS 代理](#rcs-agents-delete) ## 了解 AWS RCS 代理 AWS RCS 代理不同于其管理的企业 IDs 版 RCS。下表汇总了差异： **AWS RCS 代理与 RCS 对企业身份证的比较** | 属性 | AWS RCS 代理 | 适用于企业身份证的 RCS | | --- | --- | --- | | 管理者 | 您，通过 AWS 最终用户消息控制台或 API | AWS 注册过程中的最终用户消息 | | Scope | 每个品牌或每个用例一个 | 每个国家发布一个，外加一个测试代理 | | 配置 | 友好名称、删除保护、退出列表、标签、关键字、双向消息目的地 | 注册期间定义的品牌资产和其他设置 | | 标识符 | rcs-a1b2c3d4 格式 | 由 RCS 基础设施提供商进行内部管理 | ### 代理 ID 和 ARN 每个 AWS RCS 代理都有一个格式的唯一标识符`rcs-a1b2c3d4`（前缀`rcs-`后跟一个十六进制字符串）。在调用和之类的 API 操作时`UpdateRcsAgent`，您可以使用此 ID `DeleteRcsAgent`。 每个 AWS RCS 代理还具有 AWS 以下格式的资源 ARN： ``` arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id ``` 在 `SendTextMessage` API 中将 AWS RCS 代理指定为发起身份或将代理添加到电话池时，您可以使用 ARN。 ### 生命周期状态 AWS RCS 代理会进入以下生命周期状态： **已创建** AWS RCS 代理资源已在 AWS 最终用户消息中创建，但尚未提交注册。您可以在此状态下更新品牌资产和配置。 **等待** 注册已提交，正在等待处理。该代理尚无法发送消息。 **测试** 测试注册已获得批准。该代理具有测试代理（RCS 代表企业 ID），可以向注册的测试设备发送消息。尚未完成任何国家发射登记。 **部分** 至少有一个国家的发射登记已经完成，但并非所有已提交的国家发射都处于活动状态。代理可以在获得批准的国家/地区发送消息，但只能向已批准该代理的特定运营商的收件人发送消息。只要一个国家/地区至少有一家航空公司处于活动状态，该国家/地区的 “部分” 就会变为 “部分”。`CountryStatus` ACTIVE (处于活动状态) 所有提交的国家/地区启动注册均已完成且有效。该代理已在所有注册的国家/地区全面运营。请注意，当提交新的国家/地区启动注册时，活跃代理可以恢复到部分状态，因为新的国家/地区尚未获得批准。 **DELETED** AWS RCS 代理已被删除。所有关联的 RCS for Bus IDs iness（测试和国家发射代理）都已停用。并且无法撤消。 ## 了解两级身份模型 AWS 最终用户消息中的 RCS 使用两级身份模型：AWS **RCS 代理**和一个或多个企业版 **R** CS。 IDs **AWS RCS 代理** AWS RCS 代理是您在 AWS 最终用户消息中创建和管理的顶级资源。它充当将您的测试代理和国家/地区发射代理绑定在一起的统一资源。关键字和双向消息配置在 AWS RCS 代理上定义。品牌资产是在每次注册时定义的。每个 AWS RCS 代理都有一个格式的唯一标识符`rcs-a1b2c3d4`和一个 AWS 资源 ARN。可以将 AWS RCS 代理视为您品牌在所有启动 RCS 的国家/地区的统一标识。 **适用于企业身份证的 RCS** RCS for Business ID 是在注册过程中与 RCS 基础设施提供商一起创建的每个国家/地区的代理身份。每个国家/地区的发布都会在您的 AWS RCS 代理下为企业编号创建一个单独的 RCS。您不能 IDs 直接管理企业版 RCS。 AWS “最终用户消息” 将创建和生命周期作为注册过程的一部分进行处理。 一个 AWS RCS 代理可以拥有以下企业版 RCS： IDs + **一个测试代理** — 在测试注册阶段创建的企业ID的RCS。测试代理可与注册的测试设备配合使用，并允许您在生产环境中启动之前验证您的 RCS 集成。测试消息按标准费率收费。 + **多个国家/地区的启动代理** — 您启动 RCS 的每个国家/地区都会为企业编号创建单独的 RCS。例如，如果您在美国和加拿大同时启动，那么除了测试代理之外，您的 AWS RCS 代理还有两个国家/地区的启动代理（一个用于商业身份证的美国 RCS，一个用于商业身份的加拿大 RCS）。 下图显示了这些身份之间的关系： ``` AWS RCS Agent (rcs-a1b2c3d4) ├── Testing agent (RCS for Business ID) ├── US country launch agent (US RCS for Business ID) └── CA country launch agent (Canada RCS for Business ID) ``` 关键字和双向消息传递目标在 AWS RCS 代理上配置，并适用于所有关联的企业版 RCS。 IDs品牌资产特定于每项注册（测试代理或国家/地区发布代理）。AWS RCS 代理还保存账户级别的设置，例如友好名称、删除保护和选择退出列表。 ## 创建 AWS RCS 代理 您可以使用 AWS 最终用户消息控制台或 `CreateRcsAgent` API 创建 AWS RCS 代理。创建代理时，您可以在控制台中提供一个友好名称（存储为标签的仅限控制台的标签，无法通过 API 看见或显示在收件人的手机上），并配置可选设置，例如删除保护和选择退出列表关联。品牌资产是在注册时定义的，而不是在 AWS RCS 代理本身上定义的。 ### 品牌资产要求 您的品牌资产将与您的 RCS 消息一起显示给收件人。品牌资产是作为测试注册的一部分提交的，控制台将其呈现为代理创建工作流程的延续。创建 AWS RCS 代理时需要以下资产： **徽标** 代表您的品牌的方形图片。徽标显示在消息应用程序中，旁边是您的消息。 + 尺寸：224 × 224 像素 + 格式：透明的 PNG + 最大文件大小：50 KB **横幅图片** 一张宽幅图片，显示在消息应用程序中代理人个人资料的顶部。横幅图片仅在安卓设备上显示。 + 尺寸：1440 × 448 像素 + 格式：PNG 或 JPEG + 最大文件大小：200 KB **品牌颜色** 一种十六进制颜色代码（例如`#1A73E8`），在消息传递应用程序中用作强调色。颜色与白色背景的最低对比度必须为 4. 5:1，才能满足无障碍访问要求。如果对比度设置不正确，您的代理可能无法获得批准。 **重要** 品牌资产在代理创建后会受到变更的限制。代理商提交注册后，就无法修改某些品牌资产。在创建 AWS RCS 代理之前，请准备好最终的品牌资产。 ------ #### [ Console ] AWS 最终用户消息控制台将 AWS RCS 代理创建和测试注册作为一个指导性工作流程呈现。有关 step-by-step控制台的说明，请参阅[步骤 1：创建您的 AWS RCS 代理并提交测试注册](rcs-getting-started.md#rcs-getting-started-create-agent)。 ------ #### [ AWS CLI ] 使用`create-rcs-agent`命令创建 AWS RCS 代理。品牌资产（显示名称、描述、徽标、横幅和品牌颜色）不是此命令的参数。当您创建测试注册时，它们会作为注册字段提交。 ``` aws pinpoint-sms-voice-v2 create-rcs-agent \ --deletion-protection-enabled ``` 以下可选参数可用： + `--deletion-protection-enabled`— 在禁用删除保护之前，防止删除代理。 + `--opt-out-list-name`— 将现有的选择退出列表与代理关联。 + `--tags`— 用于组织和识别您的 AWS RCS 代理的键值对。 ------ ## 更新 AWS RCS 代理 使用 `UpdateRcsAgent` API 修改现有 AWS RCS 代理的设置。您可以更新以下设置： + **删除保护**-为代理启用或禁用删除保护。 + **选择退出列表**-将选择退出列表与代理关联或取消关联。 + **双向消息收发目的地** — 配置传送入站消息的 Amazon SNS 主题和 IAM 角色。RCS 始终启用双向消息传递。所有入站 RCS 消息均按标准费率向客户收费。此设置控制入站邮件的投递地点，而不是是否收到这些邮件。 **注意** 您可以立即通过 API 对您的 AWS RCS 代理设置进行更改。但是，品牌资产（徽标、横幅和显示名称等注册字段）的更新由 RCS 基础设施提供商审核，可能需要一段时间才能显示在收件人的设备上。要验证您的 API 更改是否已应用，请使用 `DescribeRcsAgents` API 在 “ AWS 最终用户消息” 中确认当前的代理配置。 ## 查看 AWS RCS 代理 您可以使用 AWS 最终用户消息控制台或 `DescribeRcsAgents` API 查看您的 AWS RCS 代理。 ------ #### [ Console ] 要在控制台中查看您的 AWS RCS 代理，请导航到导航窗格中**配置**下的 **RCS 代理**页面。列表页面显示您账户中的所有 AWS RCS 代理，包括其当前生命周期状态、代理 ID 和显示名称。 选择代理以查看其详细信息，包括品牌资产、配置设置和相关注册。 ------ #### [ AWS CLI ] 使用`describe-rcs-agents`命令列出您账户中的所有 AWS RCS 代理： ``` aws pinpoint-sms-voice-v2 describe-rcs-agents ``` 要检索特定代理的详细信息，请使用`--rcs-agent-ids`参数： ``` aws pinpoint-sms-voice-v2 describe-rcs-agents \ --rcs-agent-ids rcs-a1b2c3d4 ``` ------ ## 审查您的测试代理 在提交国家/地区发布注册之前，请查看您的测试代理配置，确保您的品牌资产、关键词和消息设置正确无误。测试代理是国家发射注册的模板，因此任何问题都应在继续之前得到解决。 要查看您的测试代理，请在 AWS 最终用户消息控制台中导航到您的 AWS RCS 代理，然后选择 “**注册**” 选项卡。测试注册会显示您当前的品牌配置，包括徽标、横幅图片、品牌颜色和显示在接收方设备上的显示名称。 您也可以使用 `DescribeRegistrationFieldValues` API 以编程方式检索测试注册的当前字段值。 ## 查看国家/地区发布状态 在您为 AWS RCS 代理提交国家/地区启动注册后，您可以跟踪该国家/地区每家承运人的批准状态。 ------ #### [ Console ] 要在控制台中查看国家/地区的启动状态，请导航到您的 AWS RCS 代理的详细信息页面，然后选择**国家/地区启动状态**选项卡。此选项卡显示您已提交启动注册的每个国家/地区的每家承运人的批准状态。 ------ #### [ AWS CLI ] 使用`describe-rcs-agent-country-launch-status`命令检索每艘运营商的启动状态： ``` aws pinpoint-sms-voice-v2 describe-rcs-agent-country-launch-status \ --rcs-agent-id rcs-a1b2c3d4 ``` 回复中包含您已提交启动注册的每个国家/地区的每家承运人的批准状态。 ------ 每家承运人独立审查和批准您的代理商。只要某个国家/地区至少有一家承运人批准了该代理，您的 AWS RCS 代理就可以在该国家/地区发送消息。您无需等待所有运营商批准后即可开始发送 RCS 消息。随着更多承运人批准您的代理，您在该国家/地区的覆盖范围就会增加。 **注意** 您可以从国家/地区启动状态屏幕请求其他国家/地区发布。每一次新的国家/地区发布都会创建单独的注册，并经过自己的承运人批准程序。 ## 删除 AWS RCS 代理 使用 `DeleteRcsAgent` API 永久删除 AWS RCS 代理。删除代理时，所有关联的 RCS for Business IDs （包括测试代理和所有国家/地区的发射代理）都将被停用。 **警告** 删除 AWS RCS 代理是永久性的，无法撤消。与代理相关的所有注册、国家/地区发布和测试配置都将丢失。 在删除 AWS RCS 代理之前，必须先删除所有关联的注册（包括测试注册和国家/地区启动注册），然后禁用删除保护。如果启用了删除保护，`DeleteRcsAgent`API 将返回错误。要禁用删除保护，请使用删除保护设置为的 `UpdateRcsAgent` API `false`。 **删除 AWS RCS 代理** 1. 如果启用了删除保护，请在删除保护设置为的情况下调用 `UpdateRcsAgent` API 将其禁用`false`。 1. 使用要删除的 AWS RCS 代理的代理 ID 或 ARN 调用 `DeleteRcsAgent` API。 1. 通过调用 `DescribeRcsAgents` API 验证代理是否已删除。代理不应再出现在结果中，或者其状态应为 “删除”。