View a markdown version of this page

在池中管理 AWS RCS 代理 - AWS 最终用户消息 SMS

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

在池中管理 AWS RCS 代理

您可以将 AWS RCS 代理作为发起身份添加到电话池中,旁边还有您的 SMS 电话号码。当池同时包含 AWS RCS 代理和 SMS 电话号码时, AWS 最终用户消息将首先尝试 RCS 交付,如果无法传送 RCS,则会自动回退到 SMS。有关后备工作原理的详细信息,请参阅使用电话池的 RCS 到 SMS 回退

注意

将 AWS RCS 代理添加到池中时,请使用ZZ作为 ISO 国家/地区代码。该ZZ代码表明 RCS 代理在池级别上不是特定国家/地区的。特定国家/地区的路线是通过代理商的国家/地区发射注册来处理的。一个地址池可以包含来自多个国家的电话号码以及RCS代理人。

ISO 国家/地区代码是在创建资源池时提供的,但不会保留在池中。如果您致电DescribePools,ISO 国家/地区代码不会出现在响应中。

使用 AWS RCS 代理创建池

您可以使用 AWS 最终用户消息控制台或 CreatePool API 创建包含您的 AWS RCS 代理的新池。

Console
使用控制台创建带有 AWS RCS 代理的池
  1. 打开 AWS 最终用户消息控制台。

  2. 在导航窗格中,选择 “电话池”。

  3. 选择创建池

  4. 要获取来源身份,请选择您的 AWS RCS 代理。该池从您选择的来源身份继承其配置。

  5. 根据需要配置池设置,然后选择创建池

  6. 创建池后,将您的 SMS 电话号码添加到池中以启用 SMS 回退。池中的所有发起身份都必须具有匹配的配置。有关更多信息,请参阅 RCS 的池配置要求

AWS CLI

使用 CreatePool API 创建以您的 AWS RCS 代理作为初始发起身份的池。创建池时,指定 AWS RCS 代理 ARN 作为发起身份。

以下示例使用 AWS CLI 创建池:

aws pinpoint-sms-voice-v2 create-pool \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ \ --message-type TRANSACTIONAL

创建池后,使用 AssociateOriginationIdentity API 向池中添加 SMS 电话号码以备后用。

将 AWS RCS 代理添加到现有池中

如果您已经有一个包含短信电话号码的池,则可以将您的 AWS RCS 代理添加到该池中,以启用带有 SMS 回退功能的 RCS 消息传送。您还可以向已包含 AWS RCS 代理的池中添加其他 SMS 电话号码。

重要

在向现有池中添加源身份之前,请验证池的配置是否与您要添加的身份相匹配。池中的所有来源身份必须具有相同的元数据。如果存在不匹配项,则操作将失败,并显示为。ConflictException有关哪些字段必须匹配以及如何解决不匹配问题的详细信息,请参阅RCS 的池配置要求

Console

在使用控制台将 AWS RCS 代理添加到池之前,请检查池的详细信息页面以查看其当前配置。确认池的消息类型、ISO 国家/地区代码和其他设置与您要添加的 AWS RCS 代理兼容。

使用控制台将 AWS RCS 代理添加到现有池中
  1. 打开 AWS 最终用户消息控制台。

  2. 在导航窗格中,选择 “电话池”。

  3. 选择您要将 AWS RCS 代理添加到的池。

  4. 在详细信息页面上查看池的配置。确认消息类型和其他设置与您要添加的 AWS RCS 代理相匹配。

  5. 在 “来源身份” 部分,选择添加来源身份。

  6. 从列表中选择您的 AWS RCS 代理,然后选择添加

AWS CLI

在使用 CLI 或 API 将 AWS RCS 代理添加到池之前,请使用 DescribePools API 检索池的当前配置。验证池的设置是否与您要添加的 AWS RCS 代理相匹配。

以下示例检索池的详细信息:

aws pinpoint-sms-voice-v2 describe-pools \ --pool-ids pool-id

确认配置匹配后,使用 AssociateOriginationIdentity API 将 AWS RCS 代理添加到池中:

aws pinpoint-sms-voice-v2 associate-origination-identity \ --pool-id pool-id \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ

RCS 的池配置要求

池中的所有来源身份必须具有相同的元数据。向池中添加发起身份时,“ AWS 最终用户消息” 会将该身份的配置与池的现有配置进行比较。如果存在不匹配项,则操作将失败ConflictException,其中包含有关不同特定字段的详细信息。

池配置字段分为两类:在创建池时设置且无法更改的不可变字段,以及创建后可以更新的可变字段。

不可变与可变池配置字段
字段 可变性 注意
消息类型 不可变的 在创建池时设置。所有身份都必须匹配。
ISO 国家/地区代码 不可变的 在创建池时设置。对于 AWS RCS 代理,值为ZZ。矿池可以包含来自多个国家的电话号码。
删除保护 Mutable 创建后可以切换。必须跨身份保持一致。
选择退出列表 Mutable 可以在创建后进行更改。必须跨身份保持一致。

以下配置字段必须与池中的所有原始身份相匹配:

  • 消息类型-必须为相同的消息类型(例如,交易或促销)配置所有身份。

  • ISO 国家/地区代码-在创建资源池时设置。对于 AWS RCS 代理,请使用ZZ作为 ISO 国家/地区代码。矿池可以包含来自多个国家的电话号码。

  • 删除保护-各身份的删除保护设置必须一致。

  • 选择退出列表 — 所有身份都必须与同一个选择退出列表相关联,否则所有身份都不应有选择退出列表。

了解 ConflictException 错误

当您尝试向池中添加发起身份但配置不匹配时,AssociateOriginationIdentityCreatePool API 会返回。ConflictException异常消息包含有关身份和池中哪些字段不同的详细信息。

例如,如果您尝试将为促销消息配置的电话号码添加到为交易消息配置的池中,则错误消息表明消息类型不匹配。

要解决以下问题ConflictException

  1. 查看错误消息以确定哪些字段不同。

  2. 更新来源标识或池配置,使字段匹配。

  3. 重试AssociateOriginationIdentityCreatePool操作。

注意

如果您无法解决配置不匹配问题,请考虑为原始身份创建一个单独的池。每个池可以有自己的配置,您可以针对不同的用例使用不同的池。

从池中移除 AWS RCS 代理

您可以使用 AWS 最终用户消息控制台或 DisassociateOriginationIdentity API 从池中删除 AWS RCS 代理。从池中删除 AWS RCS 代理会禁用通过该池发送的消息的 RCS 传输。删除代理后发送到地址池的消息仅通过 SMS 传送(使用池中剩余的电话号码)。

Console
使用控制台从池中删除 AWS RCS 代理
  1. 打开 AWS 最终用户消息控制台。

  2. 在导航窗格中,选择 “电话池”。

  3. 选择包含要删除的 AWS RCS 代理的池。

  4. 来源身份部分,选择 AWS RCS 代理。

  5. 选择 “删除”,然后确认删除。

AWS CLI

使用 DisassociateOriginationIdentity API 从池中移除 AWS RCS 代理:

aws pinpoint-sms-voice-v2 disassociate-origination-identity \ --pool-id pool-id \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ

移除 AWS RCS 代理后,通过池发送的消息仅通过 SMS 传送。要重新启用 RCS 交付,请使用 API 将 AWS RCS 代理重新添加到池中。AssociateOriginationIdentity