View a markdown version of this page

管理 RCS 代理 - AWS 最终用户消息 SMS
了解 AWS RCS 代理了解两级身份模型创建 AWS RCS 代理更新 AWS RCS 代理查看 AWS RCS 代理审查您的测试代理查看国家/地区发布状态删除 AWS RCS 代理

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

管理 RCS 代理

AWS RCS 代理是 AWS 最终用户消息中的顶级资源，它代表您的 RCS 消息传递品牌。它充当将您的测试代理和国家/地区启动代理绑定在一起的统一资源（RCS for Bus IDs iness）。关键字和双向消息配置在 AWS RCS 代理上定义。品牌资产是在每次注册时定义的（测试代理或国家/地区发布代理）。有关 AWS RCS 代理与企业版 RCS 的关系的概述 IDs，请参阅。什么是 RCS？

AWS RCS 代理遵循以下生命周期：

  1. 创建 AWS RCS 代理。

  2. 添加测试代理（包含在控制台创建流程中；通过 CLI 可选）。

  3. 使用注册的@@ 测试设备测试您的 RCS 消息。无需承运人批准即可进行测试。

  4. 为要向其发送@@ 正式版 RCS 消息的每个国家/地区提交国家/地区发布注册表。

  5. 部分批准：至少有一家承运人批准了您的代理。您可以开始使用经批准的承运人向收件人发送邮件。

  6. 完全批准：该国的所有承运人均已批准您的代理。在那个国家全力以赴。

一个 AWS RCS 代理映射到一个测试代理（企业编号为 RCS）和多个国家/地区的启动代理（每个国家/地区一个 RCS 代表企业编号）。当您在控制台中创建 AWS RCS 代理时，该工作流程会立即指导您创建测试代理。然后，使用测试代理商的品牌配置来预先填充国家/地区发布注册表，从而减少重复的数据输入。

了解 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 代理并提交测试注册。

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 代理之前，必须先删除所有关联的注册（包括测试注册和国家/地区启动注册），然后禁用删除保护。如果启用了删除保护，DeleteRcsAgentAPI 将返回错误。要禁用删除保护，请使用删除保护设置为的 UpdateRcsAgent API false。

删除 AWS RCS 代理

  1. 如果启用了删除保护，请在删除保护设置为的情况下调用 UpdateRcsAgent API 将其禁用false。

  2. 使用要删除的 AWS RCS 代理的代理 ID 或 ARN 调用 DeleteRcsAgent API。

  3. 通过调用 DescribeRcsAgents API 验证代理是否已删除。代理不应再出现在结果中，或者其状态应为 “删除”。