本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將申請的電話號碼指派給 Connect Customer 中的流量分佈群組
<a name="assign-phone-numbers-traffic-distribution-groups"></a>
+ 您已建立狀態為 `ACTIVE` 的新流量分佈群組。我們建議您使用 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API 來驗證狀態。
+ 您已向執行個體或其他流量分佈群組取得電話號碼。

 現在，您可以使用 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 將這些取得的電話號碼分配給新的流量分佈群組。在 `TargetArn` 參數中提供流量分佈群組 ARN。

**注意**  
若要更新**描述**欄位，您必須使用 Connect Customer 主控台。

## 範例工作流程
<a name="example-workflow-assign"></a>

以下是將已取得的電話號碼指派給流量分佈群組的工作流程範例：

1. 呼叫 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 將電話號碼指派給新 `TargetArn`。

   `TargetArn` 可以用於另一個 Connect Customer 執行個體，或在最初取得電話號碼的相同區域中建立的流量分佈群組。

1. 執行下列步驟，將流程與電話號碼建立關聯。

   這些步驟可確保您的電話語音流量將正確路由到您的流程，以支援流量分佈組態。

   1. 在建立流量分佈群組的區域中現有的 Connect Customer 執行個體中，執行下列步驟：

     1. 呼叫 [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API。提供與已複製之執行個體對應的 `InstanceId`。

     1. 傳回流程 ARN 的清單。使用這些流程 ARN 將流程與電話號碼相關聯；請呼叫 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API。

   至流程關聯的電話號碼將在跨 AWS 區域的 Connect Customer 執行個體之間進行鏡像。

## 為什麼 AssociatePhoneNumberContactFlow 呼叫失敗
<a name="why-associatephonenumbercontactflow-fails"></a>

如果流量分佈群組取得號碼，且您使用建立流量分佈群組 AWS 區域 的 中的執行個體呼叫 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)，則您可以使用 `PhoneNumberId` URI 請求參數的完整電話號碼 ARN 或 UUID 值。

不過，如果號碼是向流量分佈群組宣告，而您使用與流量分佈群組 AWS 區域 相關聯的複本中的執行個體呼叫此 API，您必須提供完整的電話號碼 ARN。如果在此案例中提供 UUID，您將會收到 `ResourceNotFoundException`。

## 為什麼 UpdatePhoneNumber 呼叫失敗
<a name="why-updatephonenumber-fails"></a>

在下列情況，您的 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 呼叫將失敗，並顯示 `ResourceNotFoundException`：
+ 指定的流量分佈群組不存在、流量分佈群組的狀態不是 `ACTIVE`，或者您沒有流量分佈群組的擁有權。

在下列情況，您的 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 呼叫將失敗，並顯示 `InvalidParameterException` 錯誤：
+ 您呼叫的端點不在建立流量分佈群組的相同區域中。

## 已定義電話號碼狀態
<a name="update-phone-number-status"></a>

以下是電話號碼狀態的描述：
+ `CLAIMED` 表示先前的 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 或 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作成功。
+ `IN_PROGRESS` 表示 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)、[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作仍在進行中，尚未完成。您可以稍後呼叫 [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)，以驗證先前的操作是否已完成。
+ `FAILED` 表示先前的 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 或 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作失敗。其中包含指示失敗原因的訊息。失敗的常見原因是您取得或更新電話號碼的 `TargetArn` 值已達到取得號碼總數的限制。