Atribuir números de telefone solicitados a grupos de distribuição de tráfego no Amazon Connect

• Você criou um grupo de distribuição de tráfego e o status é ACTIVE. Recomendamos usar a DescribeTrafficDistributionGroupAPI para verificar o status.

• Você já reivindicou números de telefone para instâncias ou outros grupos de distribuição de tráfego.

Agora você pode atribuir esses números de telefone reivindicados ao seu novo grupo de distribuição de tráfego usando a UpdatePhoneNumberAPI. Forneça o ARN do grupo de distribuição de tráfego no parâmetro TargetArn.

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 atribuir números de telefone solicitados para o grupo de distribuição de tráfego:

1. Chame a UpdatePhoneNumberAPI para atribuir o número de telefone a um novoTargetArn.

   O TargetArn pode ser para outra instância do Amazon Connect ou um grupo de distribuição de tráfego criado na mesma região em que o número de telefone foi inicialmente solicitado.

2. Execute as etapas a seguir para associar fluxos a números de telefone.

   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. Chame a API ListContactFlows. Forneça o InstanceId que corresponde à instância que foi replicada.

      2. Uma lista do fluxo ARNs é retornada. Use esses fluxos ARNs para associar um fluxo a um número de telefone; chame a AssociatePhoneNumberContactFlowAPI.

   O número de telefone para a associação de fluxo será espelhado entre as instâncias do Amazon Connect em AWS todas as regiões.

Por que uma AssociatePhoneNumberContactFlow chamada falha

Se o número for reivindicado para um grupo de distribuição de tráfego e você estiver ligando AssociatePhoneNumberContactFlowusando uma instância na Região da AWS qual o grupo de distribuição de tráfego foi criado, você pode usar um valor completo de ARN ou UUID do número de telefone para o PhoneNumberId parâmetro de solicitação de URI.

No entanto, se o número for reivindicado para um grupo de distribuição de tráfego e você estiver chamando essa API usando uma instância na réplica Região da AWS associada ao grupo de distribuição de tráfego, você deverá fornecer um ARN completo do número de telefone. Se um UUID for fornecido nesse cenário, você receberá uma ResourceNotFoundException.

Por que uma UpdatePhoneNumber chamada falha

Sua chamada de UpdatePhoneNumberAPI falhará com a ResourceNotFoundException no seguinte caso:

• 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ê.

UpdatePhoneNumberfalhará 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:

• CLAIMEDsignifica que a operação anterior ClaimPhoneNumberou a UpdatePhoneNumberoperação foram bem-sucedidas.

• IN_PROGRESSsignifica a ClaimPhoneNumber, UpdatePhoneNumbera operação ainda está em andamento e ainda não foi concluída. Você pode ligar DescribePhoneNumbermais tarde para verificar se a operação anterior foi concluída.

• FAILEDindica que a UpdatePhoneNumberoperação anterior ClaimPhoneNumberou 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.