As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Solicite números de telefone para grupos de distribuição de tráfego usando o Connect Customer
**nota**
**Novo usuário?** Confira o workshop [ de resiliência global do ](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US) Connect Customer. Esse curso on-line orienta você no processo de integração e teste do número de telefone e do failover do atendente usando novas APIs por meio da CLI da AWS.
A resiliência global está disponível somente para instâncias do Connect Customer criadas nas seguintes AWS regiões: Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Ásia-Pacífico (Osaka), Ásia-Pacífico (Tóquio), Europa (Frankfurt) e Europa (Londres).
Só é possível criar uma réplica na região Leste dos EUA (N. da Virgínia) se sua origem for Oeste dos EUA (Oregon) ou vice-versa.
Só é possível criar uma réplica na região Europa (Frankfurt) se sua origem for Europa (Londres) ou vice-versa.
Só é possível criar uma réplica apenas na região Ásia-Pacífico (Osaka) se a origem for Ásia-Pacífico (Tóquio).
Para obter acesso a esse recurso, entre em contato com seu arquiteto de soluções para clientes ou gerente técnico de contas do Connect.
Depois que seu grupo de distribuição de tráfego for criado com sucesso (`Status`é`ACTIVE`), você poderá usá-lo [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) para pesquisar números de telefone disponíveis e [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) reivindicá-los.
Antes de reivindicar um número de telefone para seu grupo de distribuição de tráfego, recomendamos usar a [ DescribeTrafficDistributionGroup ](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API para verificar o status do grupo de distribuição de tráfego`ACTIVE`. Atribuir um número de telefone a um grupo de distribuição de tráfego que não está `ACTIVE` gera uma `ResourceNotFoundException`.
Você pode reivindicar um número de telefone para um grupo de distribuição de tráfego fornecendo o ARN do grupo de distribuição de tráfego no ** TargetArn ** parâmetro ao chamar a [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API. Você também pode usar a [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API para atribuir um número de telefone anteriormente reivindicado a uma instância a um grupo de distribuição de tráfego.
**nota**
Para atualizar o ** campo ** Descrição, você deve usar o console Connect Customer.
## Exemplo de fluxo de trabalho
Veja abaixo um exemplo de fluxo de trabalho para solicitar números de telefone e usá-los em várias Regiões da AWS:
1. Crie uma réplica da instância:
1. Chame a API [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html).
1. Crie um grupo de distribuição de tráfego que vincule essas instâncias:
1. Chame a API [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html).
1. Encontre números de telefone disponíveis que podem ser solicitados para o grupo de distribuição de tráfego:
1. Ligue para a [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API na região em que o grupo de distribuição de tráfego foi criado. Forneça o ARN do grupo de distribuição de tráfego para o parâmetro `TargetArn`.
1. Na região em que o grupo de distribuição de tráfego foi criado, chame a [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API:
1. Forneça o ARN do grupo de distribuição de tráfego para o parâmetro `TargetArn`.
1. Forneça o valor do número de telefone E164 que foi retornado pela chamada de [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API na etapa 3.
O `PhoneNumberId` e o `PhoneNumberArn` são retornados. Você pode usar esses valores para operações de acompanhamento.
1. Verifique se o status do número de telefone é `CLAIMED`:
1. Chame a API [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html).
(também DescribePhoneNumber pode ser chamado na outra região associada ao grupo de distribuição de tráfego. Ele retornará os mesmos detalhes do número de telefone.)
O número de telefone poderá ser usado para operações de acompanhamento somente depois que o status for `CLAIMED`.
Para obter uma descrição dos possíveis status, consulte [Status de número de telefone definidos](#claim-phone-number-status).
1. Repita as etapas de 3 a 5 para todos os números de telefone que você precisa solicitar para o grupo de distribuição de tráfego.
1. Execute as etapas a seguir para associar fluxos a números de telefone. Faça isso nas duas regiões em que o grupo de distribuição de tráfego opera.
Essas etapas garantem que o tráfego de telefonia seja roteado corretamente para os fluxos para comportar a configuração de distribuição de tráfego.
1. Em sua instância existente do Connect Customer na região em que o grupo de distribuição de tráfego foi criado, siga as seguintes etapas:
1. [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API de chamadas. Forneça o `InstanceId` que corresponde à instância que foi replicada.
1. Uma lista de ARNs de fluxo é retornada. Use esses ARNs de fluxo para associar um fluxo a um número de telefone; ligue para a [ AssociatePhoneNumberContactFlow ](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API.
1. Na instância replicada do Connect Customer na outra AWS região, siga as seguintes etapas:
1. [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API de chamadas. Forneça o `InstanceId` que corresponde à instância que foi replicada.
1. Uma lista de ARNs de fluxo é retornada. Use esses ARNs de fluxo para associar um fluxo a um número de telefone; ligue para a [ AssociatePhoneNumberContactFlow ](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API.
## Por que uma ClaimPhoneNumber chamada falha
Sua chamada de [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API falhará com a `ResourceNotFoundException` nos seguintes casos:
+ O grupo de distribuição de tráfego especificado não existe, o status do grupo de distribuição de tráfego não é `ACTIVE` é ou o grupo de distribuição de tráfego não pertence a você.
+ O número de telefone não está disponível para solicitação. Em alguns casos, um número de telefone encontrado [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) pode ter sido reivindicado por outro cliente.
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)falhará com um `InvalidParameterException` erro no seguinte caso:
+ O endpoint que você está chamando não está na mesma região em que o grupo de distribuição de tráfego foi criado.
## Status de número de telefone definidos
Veja abaixo uma descrição dos status dos números de telefone:
+ `CLAIMED`significa que a operação anterior [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) ou a [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) operação foram bem-sucedidas.
+ `IN_PROGRESS`significa que [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) a [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) operação ainda está em andamento e ainda não foi concluída. Você pode ligar [ DescribePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html) mais tarde para verificar se a operação anterior foi concluída.
+ `FAILED`indica que a [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) operação anterior [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) falhou. Esse status inclui uma mensagem indicando o motivo da falha.
Um motivo de falha comum é que o valor de `TargetArn` para o qual você está solicitando ou atualizando um número de telefone atingiu o limite do total de números solicitados.
Ao receber um status `FAILED` de uma chamada de API `ClaimPhoneNumber`, você tem um dia para tentar solicitar novamente o número de telefone antes que o número seja liberado de volta ao inventário para que outros clientes o solicitem.