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 消息传递品牌。它充当将您的测试代理和国家/地区启动代理绑定在一起的统一资源（企业ID为RCS）。关键字和双向消息配置在 AWS RCS 代理上定义。品牌资产是在每次注册时定义的（测试代理或国家/地区发布代理）。有关 AWS RCS 代理与企业 ID 的 RCS 的关系的概述，请参阅。什么是 RCS？

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

  1. 创建 AWS RCS 代理。

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

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

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

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

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

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

了解 AWS RCS 代理

AWS RCS 代理不同于其管理的企业 ID 的 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 代理已被删除。所有关联的商家 ID RCS（测试和国家/地区发布代理）均已停用。并且无法撤消。

了解两级身份模型

AWS最终用户消息中的 RCS 使用两级身份模型：AWS RCS 代理和一个或多个用于企业 ID 的 RCS。

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。您不能直接管理企业编号的 RCS。AWS“最终用户消息” 将创建和生命周期作为注册过程的一部分进行处理。

一个 AWS RCS 代理可以为企业编号使用以下 RCS：

  • 一个测试代理 — 在测试注册阶段创建的企业ID的RCS。测试代理可与注册的测试设备配合使用，并允许您在生产环境中启动之前验证您的 RCS 集成。测试消息按标准费率收费。

  • 多个国家/地区的启动代理 — 您启动 RCS 的每个国家/地区都会为企业编号创建单独的 RCS。例如，如果您在多个国家/地区启动，那么除了测试代理之外，您的 AWS RCS 代理在每个国家/地区还有一个国家/地区启动代理。

下图显示了这些身份之间的关系：


AWS RCS Agent (rcs-a1b2c3d4)
├── Testing agent (RCS for Business ID)
├── US country launch agent (RCS for Business ID)
├── ...additional country launch agents
└── [Country N] country launch agent (RCS for Business ID)

关键字和双向消息传递目标在 AWS RCS 代理上配置，适用于所有关联的企业 ID 的 RCS。品牌资产特定于每项注册（测试代理或国家/地区发布代理）。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 代理创建和测试注册作为一个指导性工作流程呈现。有关控制台的分步说明，请参阅步骤 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— Key-value 配对以组织和识别您的 AWS RCS 代理。

更新 AWS RCS 代理

使用 UpdateRcsAgent API 修改现有 AWS RCS 代理的设置。您可以更新以下设置：

  • 删除保护-为代理启用或禁用删除保护。

  • Opt-out list — 将选择退出列表与代理关联或取消关联。

  • Two-way 消息收发目的地 — 配置传送入站消息的 Amazon SNS 主题和 IAM 角色。 Two-way 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 ID（包括测试代理和所有国家/地区的启动代理）都将被停用。

警告

删除 AWS RCS 代理是永久性的，无法撤消。与代理相关的所有注册、国家/地区发布和测试配置都将丢失。

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

删除 AWS RCS 代理

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

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

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