本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 Amazon Connect 向流量分配组申领电话号码
注意
新用户? 查看 Amazon Connect 全球弹性研讨会
全球弹性仅适用于在以下 AWS 区域创建的 Amazon Connect 实例:美国东部(弗吉尼亚北部)、美国西部(俄勒冈)、欧洲(法兰克福)和欧洲(伦敦)。
如果您的来源是美国西部(俄勒冈),或者相反,您只能在美国东部(弗吉尼亚北部)地区创建副本。同样,如果您的来源是欧洲(伦敦),或者相反,您只能在欧洲(法兰克福)地区创建副本。
要获得对此功能的访问权限,请联系您的 Amazon Connect 解决方案架构师或技术客户经理。
成功创建流量分发组后,您可以使用搜索SearchAvailablePhoneNumbers可用的电话号码ClaimPhoneNumber并申领这些号码。Status
ACTIVE
在向流量通讯组申领电话号码之前,我们建议使用DescribeTrafficDistributionGroupAPI来验证流量通讯组的状态是否为ACTIVE
。将电话号码分配给非 ACTIVE
的流量分配组会导致 ResourceNotFoundException
。
在调用流量分配组时,您可以在TargetArn参数ARN中提供流量分配组,从而向流量分配组申领电话号码ClaimPhoneNumberAPI。您也可以使用将之前申请UpdatePhoneNumberAPI给实例的电话号码分配给流量分配组。
注意
要更新描述字段,必须使用 Amazon Connect 控制台。
工作流示例
以下是申请电话号码并跨多个 AWS 区域使用这些号码的工作流示例:
-
创建实例的副本:
-
致电 ReplicateInstanceAPI.
-
-
创建将这些实例链接在一起的流量分配组:
-
查找可向您的流量分配组申请的可用电话号码:
-
SearchAvailablePhoneNumbersAPI在创建流量分配组的区域中致电。为
TargetArn
参数提供流量分配组ARN。
-
-
在创建流量分配组的区域中,拨打 ClaimPhoneNumberAPI:
-
ARN为
TargetArn
参数提供您的流量分配组。 -
提供步骤 3 中呼叫返回的 E164 SearchAvailablePhoneNumbersAPI电话号码值。
将会返回
PhoneNumberId
和PhoneNumberArn
。您可以将这些值用于后续操作。 -
-
验证电话号码状态是否为
CLAIMED
:-
致电 DescribePhoneNumberAPI.
(也DescribePhoneNumber 可以在与流量分配组关联的其他区域中调用。 它将返回相同的电话号码详细信息。)
只有在电话号码的状态为
CLAIMED
之后,才可以由后续操作使用该电话号码。有关可能状态的说明,请参阅已定义电话号码状态。
-
-
对需要向流量分配组申请的所有电话号码重复步骤 3-5。
-
执行以下步骤,以将流与电话号码相关联。在流量分配组运作的两个区域均这样做。
这些步骤可确保您的电话流量正确路由到您的流,以支持您的流量分配配置。
-
在创建流量分配组的区域的现有 Amazon Connect 实例中,执行以下步骤:
-
打电话ListContactFlowsAPI。提供与所复制的实例相对应的
InstanceId
。 -
返回流程ARNs列表。使用这些流程ARNs将流程与电话号码相关联;请致电AssociatePhoneNumberContactFlowAPI。
-
-
在其他 AWS 区域复制的 Amazon Connect 实例中,执行以下步骤:
-
打电话ListContactFlowsAPI。提供与所复制的实例相对应的
InstanceId
。 -
返回流程ARNs列表。使用这些流程ARNs将流程与电话号码相关联;请致电AssociatePhoneNumberContactFlowAPI。
-
-
为什么 ClaimPhoneNumber 通话失败
ResourceNotFoundException
在以下情况下,您的ClaimPhoneNumberAPI呼叫将失败,并显示为:
-
指定的流量分配组不存在、流量分配组的状态并非
ACTIVE
,或者您没有流量分配组的所有权。 -
该电话号码不可申请。在某些情况下,从中找到的电话号码SearchAvailablePhoneNumbers可能已被其他客户申领。
ClaimPhoneNumber在以下情况下,将因InvalidParameterException
错误而失败:
-
您要调用的端点不在创建流量分配组的同一区域中。
已定义电话号码状态
以下是电话号码状态的描述:
-
CLAIMED
表示前一个UpdatePhoneNumber操作ClaimPhoneNumber或操作成功。 -
IN_PROGRESS
表示 a ClaimPhoneNumber,UpdatePhoneNumber操作仍在进行中,尚未完成。您可以稍后DescribePhoneNumber致电以验证之前的操作是否已完成。 -
FAILED
表示之前的ClaimPhoneNumber或UpdatePhoneNumber操作已失败。它包括一条消息,指示失败原因。失败的一个常见原因是您申请电话号码或将其更新为的
TargetArn
值已达到其申请总数的限制。如果您通过电话收到了
FAILED
状态,则在电话号码被释放回库存供其他客户申领之前,您有一天的时间可以重试申领该电话号码。ClaimPhoneNumber
API