使用 Amazon Connect 向流量分配组申领电话号码 - Amazon Connect

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

使用 Amazon Connect 向流量分配组申领电话号码

注意

新用户? 查看 Amazon Connect 全球弹性研讨会。本在线课程将引导您完成新手入职和测试电话号码以及代理故障转移的APIsAWSCLI过程。

全球弹性仅适用于在以下 AWS 区域创建的 Amazon Connect 实例:美国东部(弗吉尼亚北部)、美国西部(俄勒冈)、欧洲(法兰克福)和欧洲(伦敦)。

如果您的来源是美国西部(俄勒冈),或者相反,您只能在美国东部(弗吉尼亚北部)地区创建副本。同样,如果您的来源是欧洲(伦敦),或者相反,您只能在欧洲(法兰克福)地区创建副本。

要获得对此功能的访问权限,请联系您的 Amazon Connect 解决方案架构师或技术客户经理。

成功创建流量分发组后,您可以使用搜索SearchAvailablePhoneNumbers可用的电话号码ClaimPhoneNumber并申领这些号码。Status ACTIVE

在向流量通讯组申领电话号码之前,我们建议使用DescribeTrafficDistributionGroupAPI来验证流量通讯组的状态是否为ACTIVE。将电话号码分配给非 ACTIVE 的流量分配组会导致 ResourceNotFoundException

在调用流量分配组时,您可以在TargetArn参数ARN中提供流量分配组,从而向流量分配组申领电话号码ClaimPhoneNumberAPI。您也可以使用将之前申请UpdatePhoneNumberAPI给实例的电话号码分配给流量分配组。

注意

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

工作流示例

以下是申请电话号码并跨多个 AWS 区域使用这些号码的工作流示例:

  1. 创建实例的副本:

    1. 致电 ReplicateInstanceAPI.

  2. 创建将这些实例链接在一起的流量分配组:

    1. 致电 CreateTrafficDistributionGroupAPI.

  3. 查找可向您的流量分配组申请的可用电话号码:

    1. SearchAvailablePhoneNumbersAPI在创建流量分配组的区域中致电。为TargetArn参数提供流量分配组ARN。

  4. 在创建流量分配组的区域中,拨打 ClaimPhoneNumberAPI:

    1. ARN为TargetArn参数提供您的流量分配组。

    2. 提供步骤 3 中呼叫返回的 E164 SearchAvailablePhoneNumbersAPI电话号码值。

    将会返回 PhoneNumberIdPhoneNumberArn。您可以将这些值用于后续操作。

  5. 验证电话号码状态是否为 CLAIMED

    1. 致电 DescribePhoneNumberAPI.

      (也DescribePhoneNumber 可以在与流量分配组关联的其他区域中调用。 它将返回相同的电话号码详细信息。)

    只有在电话号码的状态为 CLAIMED 之后,才可以由后续操作使用该电话号码。

    有关可能状态的说明,请参阅已定义电话号码状态

  6. 对需要向流量分配组申请的所有电话号码重复步骤 3-5。

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

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

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

      1. 打电话ListContactFlowsAPI。提供与所复制的实例相对应的 InstanceId

      2. 返回流程ARNs列表。使用这些流程ARNs将流程与电话号码相关联;请致电AssociatePhoneNumberContactFlowAPI。

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

      1. 打电话ListContactFlowsAPI。提供与所复制的实例相对应的 InstanceId

      2. 返回流程ARNs列表。使用这些流程ARNs将流程与电话号码相关联;请致电AssociatePhoneNumberContactFlowAPI。

为什么 ClaimPhoneNumber 通话失败

ResourceNotFoundException在以下情况下,您的ClaimPhoneNumberAPI呼叫将失败,并显示为:

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

  • 该电话号码不可申请。在某些情况下,从中找到的电话号码SearchAvailablePhoneNumbers可能已被其他客户申领。

ClaimPhoneNumber在以下情况下,将因InvalidParameterException错误而失败:

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

已定义电话号码状态

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

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

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

  • FAILED表示之前的ClaimPhoneNumberUpdatePhoneNumber操作已失败。它包括一条消息,指示失败原因。

    失败的一个常见原因是您申请电话号码或将其更新为的 TargetArn 值已达到其申请总数的限制。

    如果您通过电话收到了FAILED状态,则在电话号码被释放回库存供其他客户申领之前,您有一天的时间可以重试申领该电话号码。ClaimPhoneNumber API