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á.
# Solicitar números de telefone para o grupo de distribuição de tráfego usando o Amazon Connect
**nota**
**Novo usuário?** Confira o [workshop Amazon Connect Global Resiliency](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Este curso on-line orienta você no processo de integração e teste do failover do número de telefone e do agente usando o novo APIs por meio da AWS CLI.
A resiliência global está disponível somente para instâncias do Amazon Connect 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 o arquiteto de soluções ou gerente técnico de contas do Amazon Connect.
Depois que seu grupo de distribuição de tráfego for criado com sucesso (`Status`é`ACTIVE`), você pode 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 do Amazon Connect.
## 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. Chame 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 da [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. Na instância atual do Amazon Connect 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 do fluxo ARNs é retornada. Use esses fluxos ARNs para associar um fluxo a um número de telefone; chame a [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API.
1. Na instância replicada do Amazon Connect na outra AWS região, execute 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 do fluxo ARNs é retornada. Use esses fluxos ARNs para associar um fluxo a um número de telefone; chame 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 em [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 a [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html), [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)a 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)ou 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.