

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Asigne números de teléfono reclamados a grupos de distribución de tráfico en Connect Customer
<a name="assign-phone-numbers-traffic-distribution-groups"></a>
+ Ha creado un nuevo grupo de distribución de tráfico y su estado es `ACTIVE`. Recomendamos usar la [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API para verificar el estado.
+ Ya ha solicitado números de teléfono a instancias u otros grupos de distribución de tráfico.

 Ahora puedes asignar esos números de teléfono reclamados a tu nuevo grupo de distribución de tráfico mediante la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API. Proporcione el ARN de grupo de distribución de tráfico en el parámetro `TargetArn`. 

**nota**  
Para actualizar el campo **Descripción**, debe utilizar la consola Connect Customer. 

## Ejemplo de flujo de trabajo
<a name="example-workflow-assign"></a>

A continuación, se muestra un flujo de trabajo de ejemplo para asignar números de teléfono solicitados a su grupo de distribución de tráfico:

1. Llame a la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API para asignar el número de teléfono a uno nuevo`TargetArn`. 

   `TargetArn`Puede ser para otra instancia de Connect Customer o para un grupo de distribución de tráfico creado en la misma región en la que se reclamó inicialmente el número de teléfono. 

1. Realice los siguientes pasos para asociar flujos a números de teléfono. 

   Estos pasos garantizan que el tráfico de telefonía se enrute correctamente hacia sus flujos para admitir su configuración de distribución de tráfico.

   1. En su instancia de Connect Customer existente en la región en la que se creó el grupo de distribución de tráfico, lleve a cabo los siguientes pasos:

     1. Llame a la API [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html). Proporcione el `InstanceId` que corresponda a la instancia que se ha replicado. 

     1. Se devuelve una lista de ARN de flujo. Utilice estos ARN de flujo para asociar un flujo a un número de teléfono; llame a la [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API. 

   La asociación entre AWS el número de teléfono y el flujo se reflejará entre las instancias de Connect Customer de todas las regiones.

## Por qué se produce un error en una llamada AssociatePhoneNumberContactFlow
<a name="why-associatephonenumbercontactflow-fails"></a>

Si el número se reclama a un grupo de distribución de tráfico y llamas [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)mediante una instancia en la Región de AWS que se creó el grupo de distribución de tráfico, puedes usar un valor ARN o UUID de número de teléfono completo para el parámetro de solicitud de `PhoneNumberId` URI. 

Sin embargo, si el número se reclama a un grupo de distribución de tráfico y llamas a esta API mediante una instancia de la réplica Región de AWS asociada al grupo de distribución de tráfico, debes proporcionar un número de teléfono completo (ARN). Si se proporciona un UUID en este escenario, recibirá un `ResourceNotFoundException`.

## ¿Por qué falla una UpdatePhoneNumber llamada?
<a name="why-updatephonenumber-fails"></a>

[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)La llamada a la API fallará con un `ResourceNotFoundException` en los siguientes casos:
+ El grupo de distribución de tráfico especificado no existe, el estado del grupo de distribución de tráfico no es `ACTIVE` o usted no tiene la propiedad del grupo de distribución de tráfico.

[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)fallará y se producirá un `InvalidParameterException` error en el siguiente caso:
+ El punto de conexión al que llama no se encuentra en la misma región en la que se creó el grupo de distribución de tráfico.

## Definición de los estados de número de teléfono
<a name="update-phone-number-status"></a>

A continuación, se describen los estados de número de teléfono:
+ `CLAIMED`significa que la operación anterior [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)o la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)operación se realizó correctamente.
+ `IN_PROGRESS`significa que [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html), [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)la operación aún está en curso y aún no se ha completado. Puede llamar [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)más adelante para comprobar si la operación anterior se ha completado.
+ `FAILED`indica que la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)operación [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)o operación anterior ha fallado. Incluye un mensaje que indica el motivo del error. Un motivo habitual de error es que el valor de `TargetArn` del que está solicitando o actualizando un número de teléfono haya alcanzado su límite de números totales solicitados.