将申请的电话号码分配给流量分配组

• 您创建了一个新的流量分配组，其状态为 ACTIVE。我们建议使用 DescribeTrafficDistributionGroupAPI 来验证状态。

• 您已经向实例或其他流量分配组申请电话号码。

现在，您可以使用 UpdatePhoneNumberAPI 将这些已申报的电话号码分配给新的流量分配组。在 TargetArn 参数中提供流量分配组 ARN。

注意

要更新描述字段，必须使用 Amazon Connect 控制台。

工作流示例

以下是将申请的电话号码分配给您的流量分配组的工作流示例：

1. 调用 UpdatePhoneNumberAPI 将电话号码分配给新的TargetArn。

   TargetArn 可以用于其他 Amazon Connect 实例，也可用于在最初申请电话号码的同一区域中创建的流量分配组。

2. 执行以下步骤，以将流与电话号码相关联。在流量分配组运作的两个区域均这样做。

   这些步骤可确保您的电话流量正确路由到您的流，以支持您的流量分配配置。

   1. 在创建流量分配组的区域的现有 Amazon Connect 实例中，执行以下步骤：

      1. 调用 ListContactFlows API。提供与所复制的实例相对应的 InstanceId。

      2. 会返回流 ARN 的列表。使用这些流程 ARN 将流程与电话号码相关联；调用 AssociatePhoneNumberContactFlowAPI。

   2. 在其他区域的复制 Amazon Connect 实例中，执行以下步骤：

      1. 调用 ListContactFlows API。提供与所复制的实例相对应的 InstanceId。

      2. 会返回流 ARN 的列表。使用这些流程 ARN 将流程与电话号码相关联；调用 AssociatePhoneNumberContactFlowAPI。

为什么通 AssociatePhoneNumberContactFlow 话失败

如果该号码已向流量分配组申领，并且您AssociatePhoneNumberContactFlow使用创建流量分配组的 AWS 区域 实例进行呼叫，则可以为 PhoneNumberId URI 请求参数使用完整的电话号码 ARN 或 UUID 值。

但是，如果向流量分配组申领了该号码，并且您使用与流量分配组 AWS 区域 关联的副本中的实例调用此 API，则必须提供完整的电话号码 ARN。如果在这种情况下提供了 UUID，您会收到 ResourceNotFoundException。

为什么通 UpdatePhoneNumber 话失败

ResourceNotFoundException在以下情况下，您UpdatePhoneNumber的 API 调用将失败，并显示为：

• 指定的流量分配组不存在、流量分配组的状态并非 ACTIVE，或者您没有流量分配组的所有权。

UpdatePhoneNumber在以下情况下，将因InvalidParameterException错误而失败：

• 您要调用的端点不在创建流量分配组的同一区域中。

已定义电话号码状态

以下是电话号码状态的描述：

• CLAIMED表示前一个UpdatePhoneNumber操作ClaimPhoneNumber或操作成功。

• IN_PROGRESS表示 a ClaimPhoneNumber，UpdatePhoneNumber操作仍在进行中，尚未完成。您可以稍后DescribePhoneNumber致电以验证之前的操作是否已完成。

• FAILED表示之前的ClaimPhoneNumber或UpdatePhoneNumber操作已失败。它包括一条消息，指示失败原因。失败的一个常见原因是您申请电话号码或将其更新为的 TargetArn 值已达到其申请总数的限制。