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.
# Reclame números de teléfono a grupos de distribución de tráfico mediante Connect Customer
**nota**
**¿Usuario nuevo?** Consulta el taller [ de resiliencia global para clientes de ](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US) Connect. Este curso en línea lo guía a través del proceso de incorporación y prueba de la conmutación por error de números de teléfono y agentes mediante nuevas API a través de la AWS CLI.
La resiliencia global solo está disponible para las instancias de clientes de Connect creadas en las siguientes AWS regiones: EE. UU. Este (Norte de Virginia), EE. UU. Oeste (Oregón), Asia Pacífico (Osaka), Asia Pacífico (Tokio), Europa (Fráncfort) y Europa (Londres).
Solo puede crear una réplica en la región Este de EE. UU. (Norte de Virginia), si su origen es Oeste de EE. UU. (Oregón) o al revés.
Solo puede crear una réplica en la región de Europa (Fráncfort) si su origen es Europa (Londres) o viceversa.
Solo puede crear una réplica en la región de Asia-Pacífico (Osaka) si su origen es Asia-Pacífico (Tokio).
Para obtener acceso a esta función, póngase en contacto con su arquitecto de soluciones para clientes de Connect o con su administrador técnico de cuentas.
Una vez que su grupo de distribución de tráfico se haya creado correctamente (`Status`es`ACTIVE`), puede usarlo [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) para buscar los números de teléfono disponibles y [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) reclamarlos.
Antes de solicitar un número de teléfono a tu grupo de distribución de tráfico, te recomendamos que [ DescribeTrafficDistributionGroup ](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) utilices la API para verificar el estado del grupo de distribución de tráfico`ACTIVE`. Asignar un número de teléfono a un grupo de distribución de tráfico que no tiene el estado `ACTIVE` da como resultado `ResourceNotFoundException`.
Para reclamar un número de teléfono a un grupo de distribución de tráfico, debes proporcionar el ARN del grupo de distribución de tráfico en el ** TargetArn ** parámetro al llamar a la [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API. También puedes usar la [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API para asignar a un grupo de distribución de tráfico un número de teléfono reclamado anteriormente para una instancia.
**nota**
Para actualizar el ** campo ** Descripción, debes usar la consola Connect Customer.
## Ejemplo de flujo de trabajo
A continuación, se muestra un ejemplo de flujo de trabajo para solicitar números de teléfono y utilizarlos en varias Regiones de AWS:
1. Cree una réplica de su instancia:
1. Llame a la API [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html).
1. Cree un grupo de distribución de tráfico que vincule estas instancias:
1. Llame a la API [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html).
1. Busque números de teléfono disponibles que puedan solicitarse para su grupo de distribución de tráfico:
1. Llame a la [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API de la región en la que se creó el grupo de distribución del tráfico. Proporcione el ARN de grupo de distribución de tráfico para el parámetro `TargetArn`.
1. En la región en la que se creó el grupo de distribución del tráfico, llame a la [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API:
1. Proporcione el ARN de grupo de distribución de tráfico para el parámetro `TargetArn`.
1. Proporcione el valor del número de teléfono E164 que devolvió la llamada a la [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API en el paso 3.
Se devuelven `PhoneNumberId` y `PhoneNumberArn`. Puede utilizar estos valores para las operaciones de seguimiento.
1. Compruebe que el estado del número de teléfono es `CLAIMED`:
1. Llame a la API [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html).
(también se DescribePhoneNumber puede llamar en la otra región asociada al grupo de distribución de tráfico. Devolverá los mismos detalles del número de teléfono).
El número de teléfono puede utilizarse mediante operaciones de seguimiento solo después de que su estado sea `CLAIMED`.
Para obtener una descripción de los posibles estados, consulte [Definición de los estados de número de teléfono](#claim-phone-number-status).
1. Repita los pasos del 3 al 5 para todos los números de teléfono que necesite solicitar para su grupo de distribución de tráfico.
1. Realice los siguientes pasos para asociar flujos a números de teléfono. Hágalos en las dos regiones en las que opera el grupo de distribución de tráfico.
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 la instancia de Connect Customer que tengas en la región en la que se creó el grupo de distribución del tráfico, sigue estos pasos:
1. [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API de llamadas. Proporcione el `InstanceId` que corresponda a la instancia que se ha replicado.
1. Se devuelve una lista de ARN de flujo. Usa estos ARN de flujo para asociar un flujo a un número de teléfono; llama a la [ AssociatePhoneNumberContactFlow ](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API.
1. En la instancia replicada de Connect Customer en la otra AWS región, siga los pasos siguientes:
1. Llame a la [ ListContactFlows ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API. Proporcione el `InstanceId` que corresponda a la instancia que se ha replicado.
1. Se devuelve una lista de ARN de flujo. Usa estos ARN de flujo para asociar un flujo a un número de teléfono; llama a la [ AssociatePhoneNumberContactFlow ](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API.
## Por qué falla una ClaimPhoneNumber llamada
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.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.
+ El número de teléfono no está disponible para realizar una solicitud. En algunos casos, un número de teléfono desde el que se encontró [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) podría haber sido reclamado por otro cliente.
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)fallará con 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 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 una [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 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) en otro momento para comprobar si la operación anterior se ha completado.
+ `FAILED`indica 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 han 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.
Si ha recibido un estado `FAILED` de una llamada a la API `ClaimPhoneNumber`, dispone de un día para volver a intentar solicitar el número de teléfono antes de que el número se devuelva al inventario para que otros clientes lo soliciten.