Solicite números de telefone para grupos de distribuição de tráfego usando o Amazon Connect - Amazon Connect
Exemplo de fluxo de trabalhoPor que uma ClaimPhoneNumber chamada falhaStatus de número de telefone definidos

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 Amazon Connect

nota

Novo usuário? Confira o workshop de resiliência global do Amazon Connect. Este curso on-line orienta você no processo de integração e teste do número de telefone e do failover do agente usando novos APIs por meio do. 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), Europa (Frankfurt) e Europa (Londres).

Você só pode criar uma réplica na região Leste dos EUA (Norte da Virgínia) se sua origem for Oeste dos EUA (Oregon) ou vice-versa. Da mesma forma, você só pode criar uma réplica na região da Europa (Frankfurt) se sua origem for a Europa (Londres) ou vice-versa.

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 SearchAvailablePhoneNumberspara pesquisar números de telefone disponíveis e ClaimPhoneNumberreivindicá-los.

Antes de reivindicar um número de telefone para seu grupo de distribuição de tráfego, recomendamos usar o DescribeTrafficDistributionGroupAPIpara verificar se 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 grupo de distribuição de tráfego ARN no TargetArnparâmetro ao chamar ClaimPhoneNumberAPIo. Você também pode usar o UpdatePhoneNumberAPIpara 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. Ligue para ReplicateInstanceAPIo.

  2. Crie um grupo de distribuição de tráfego que vincule essas instâncias:

    1. Ligue para CreateTrafficDistributionGroupAPIo.

  3. Encontre números de telefone disponíveis que podem ser solicitados para o grupo de distribuição de tráfego:

    1. Ligue para o SearchAvailablePhoneNumbersAPIna região em que o grupo de distribuição de tráfego foi criado. Forneça o grupo de distribuição de tráfego ARN para o TargetArn parâmetro.

  4. Na região em que o grupo de distribuição de tráfego foi criado, chame ClaimPhoneNumberAPI:

    1. Forneça seu grupo de distribuição de tráfego ARN para o TargetArn parâmetro.

    2. Forneça o valor do número de telefone E164 que foi retornado pela SearchAvailablePhoneNumbersAPIchamada na etapa 3.

    O PhoneNumberId e o PhoneNumberArn são retornados. Você pode usar esses valores para operações de acompanhamento.

  5. Verifique se o status do número de telefone é CLAIMED:

    1. Ligue para DescribePhoneNumberAPIo.

      (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.

  6. 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.

  7. 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. Ligue ListContactFlowsAPI. 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; ligue para AssociatePhoneNumberContactFlowAPIo.

    2. Na instância replicada do Amazon Connect na outra AWS região, execute as seguintes etapas:

      1. Ligue ListContactFlowsAPI. 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; ligue para AssociatePhoneNumberContactFlowAPIo.

Por que uma ClaimPhoneNumber chamada falha

Sua ClaimPhoneNumberAPIchamada 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 SearchAvailablePhoneNumberspode ter sido reivindicado por outro cliente.

ClaimPhoneNumberfalhará 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.

    Se você recebeu o FAILED status de uma ClaimPhoneNumber API ligação, você tem um dia para tentar reivindicar o número de telefone novamente antes que o número seja devolvido ao inventário para que outros clientes o solicitem.