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á.
# Como configurar o Amazon Connect Global Resiliency
**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.
**Importante**
O Amazon Connect Global Resiliency (ACGR) é a única solução AWS compatível para resiliência multirregional no Amazon Connect. AWS não oferece suporte a alternativas de terceiros ou personalizadas para alcançar resiliência global. A implantação de soluções sem suporte pode resultar em limites de serviço negados ou reduzidos na instância secundária e pode afetar a cobertura do SLA se o tempo de inatividade for atribuído à implantação sem suporte.
O Amazon Connect Global Resiliency permite que você forneça atendimento ao cliente em qualquer lugar do mundo com o mais alto nível de confiabilidade, desempenho e eficiência. Com os recursos de telefonia distribuída, a central de atendimento pode atender a requisitos regulatórios internacionais.
O Amazon Connect Global Resiliency fornece um conjunto APIs que você usa para:
+ Provisione uma instância vinculada do Amazon Connect em outra Região da AWS.
+ Provisionar e gerenciar números de telefone globais e acessíveis em ambas as regiões.
+ Distribuir tráfego de telefonia e atendentes entre instâncias e regiões do Amazon Connect em incrementos de 10% ou transferir tudo de uma vez. Isso permite que você mude lentamente os contatos de voz de entrada e os atendentes entre regiões ou altere todos eles ao mesmo tempo.
Por exemplo, você pode distribuir contatos de voz de entrada e e atendentes 100% no Leste dos EUA (Norte da Virgínia) e 0% no Oeste dos EUA (Oregon) ou 50% em cada região.
+ Acessar a capacidade reservada nas regiões.
**Topics**
+ [Requisitos do Global Resiliency](connect-global-resiliency-requirements.md)
+ [Conceitos básicos](get-started-connect-global-resiliency.md)
+ [Gerenciar grupos de distribuição de tráfego](manage-traffic-distribution-groups.md)
+ [Gerenciar números de telefone em todas as regiões](manage-phone-numbers-across-regions.md)
+ [Gerenciar chats entre regiões](manage-chat-across-regions.md)
+ [Métricas, relatórios e pesquisas nas regiões do ACGR](metrics-reports-and-search-across-acgr-regions.md)
# Requisitos do Amazon Connect Global Resiliency
Se você decidiu que o Amazon Connect Global Resiliency é a implantação adequada para você, certifique-se de cumprir os seguintes pré-requisitos antes da integração:
+ [Transfira](about-porting.md) todos os números de telefone que deseja habilitar para serem multirregionais para o Amazon Connect.
+ AWS O Enterprise Support ou AWS Unified Operations são necessários para se integrar ao Amazon Connect Global Resiliency. Para obter mais informações sobre os planos de AWS suporte, consulte [AWS Support Plans](https://aws.amazon.com/premiumsupport/plans/).
+ É necessário ter uma instância de produção existente do Amazon Connect [habilitada para SAML 2.0](connect-identity-management.md) em uma região onde o Amazon Connect Global Resiliency esteja disponível. Para confirmar, consulte [Disponibilidade de resiliência global por região](regions.md#gr_region).
+ É recomendável integrar e testar os serviços do Amazon Connect Global Resiliency em um ambiente de teste antes de integrar o tráfego de produção.
+ Solicite que TODAS as cotas de serviço na instância de réplica correspondam às cotas de serviço na instância de origem: [Crie um caso de aumento de cota de serviço](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) no AWS Management Console > Support.
+ Certifique-se de que suas funções do Lambda em todas AWS as regiões tenham o mesmo nome.
+ Atualize os fluxos para substituir qualquer região codificada por um parâmetro `$.AwsRegion` or `$['AwsRegion']`.
**nota**
No bloco [Função AWS Lambda ](invoke-lambda-function-block.md), `$.AwsRegion` não é permitido no flowArn.
Para usar `$.AwsRegion`, é necessário usar um bloco [Set contact attributes (Definir atributos do contato)](set-contact-attributes.md) para definir o fluxo, por exemplo:
`flowIdKey` : `arn:aws:connect:$.AwsRegion:123456789012:instance/12345678-1234-1234-1234-123456789012/contact-flow/12345678-1234-1234-1234-123456789012`
Depois, use essa chave de atributo no bloco [Função AWS Lambda ](invoke-lambda-function-block.md) como `${flowIdKey}`.
`$.AwsRegion` só é compatível somente com ARN do Lambda e ARN do Lex.
+ Para os bots do Amazon Lex, é possível utilizar uma das seguintes opções:
+ Use o Amazon Lex Global Resiliency para replicar bots em todas AWS as regiões e reter o ID do bot.
+ Altere seus fluxos para uma ramificação com base na AWS região em que o fluxo está sendo executado. No runtime do fluxo, esses parâmetros são substituídos pela região em que o fluxo é executado, conforme mostrado no exemplo a seguir.
![\[A página de propriedades do bloco Verificar atributos de contato.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/acgr-requirements.png)
# Conceitos básicos do Amazon Connect Global Resiliency
**Importante**
Amazon Connect instâncias criadas antes de 31 de março de 2021 receberam um domínio com o seguinte formato:
```
https://your-instance-alias.awsapps.com/connect/
```
Se seu domínio usar o formato mais antigo, você não será capaz de configurar corretamente o recurso Resiliência Global do Amazon Connect . Para habilitar esse recurso, você precisará [atualizar seu domínio](update-your-connect-domain.md) para o formato mais recente:
```
https://your-instance-alias.my.connect.aws/
```
**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.
Você começa a usar a resiliência global do Amazon Connect criando uma réplica da sua instância atual do Amazon Connect em outra Região da AWS e criando um grupo de distribuição de tráfego.
Um *grupo de distribuição de tráfego* é um recurso do Amazon Connect que permite vincular instâncias do Amazon Connect que estão em diferentes Regiões da AWS. Os números de telefone podem ser anexados ao grupo de distribuição de tráfego. O tráfego para esses números pode ser distribuído entre as instâncias no grupo de distribuição de tráfego.
## Como configurar o Amazon Connect Global Resiliency
1. [Crie uma réplica da instância atual do Amazon Connect](create-replica-connect-instance.md). Use a API do [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html).
1. [Crie um grupo de distribuição de tráfego](setup-traffic-distribution-groups.md).
1. Use a API do [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html).
1. Use a [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API para determinar se o grupo de distribuição de tráfego foi criado com sucesso (`Status`deve ser`ACTIVE`).
1. [Solicite números de telefone para o grupo de distribuição de tráfego](claim-phone-numbers-traffic-distribution-groups.md). Depois que seu grupo de distribuição de tráfego for criado com sucesso (`Status`é`ACTIVE`), você pode reivindicar números de telefone para ele usando a [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API.
**nota**
A distribuição de tráfego padrão para esses números de telefone é definida como 100%-0%. Ou seja, 100% do tráfego telefônico de entrada será direcionado para a instância de origem do Amazon Connect que foi usada para criar uma réplica.
Além disso, depois que os números de telefone são solicitados para uma instância, você pode atribuí-los a várias instâncias nas Regiões da AWS. Para fazer isso, use a [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API para atribuir os números a um grupo de distribuição de tráfego.
1. [Atualize a distribuição de tráfego](update-telephony-traffic-distribution.md). Use a [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API para distribuir o tráfego entre as instâncias vinculadas em incrementos de 10%.
# Crie uma réplica da instância atual do 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.
Você chama a [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API para criar uma réplica da sua instância do Amazon Connect em outra Região da AWS e copiar as informações de configuração dos recursos do Amazon Connect. Regiões da AWS
**Topics**
+ [O que é importante saber](#important-info-automated-config)
+ [Características da instância de réplica](#replica-characteristics)
+ [Quais recursos são espelhados na instância de réplica](#mirrored-resources)
+ [O que fazer após a criação da instância de réplica](#configure-replica-instance)
+ [Quando entrar em contato com o AWS Support](#replica-cs)
+ [Por que uma ReplicateInstance chamada falha](#why-replicateinstance-fails)
+ [Encontrar a região de origem da instância](#how-to-find-source-region-of-instances)
## O que é importante saber
+ Antes de correr [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html):
+ Verifique se você tem as permissões do IAM mínimas exigidas para criar uma instância. Consulte [Permissões necessárias para usar políticas do IAM personalizadas no gerenciamento de acesso ao console do Amazon Connect](security-iam-amazon-connect-permissions.md).
+ Atualize os fluxos para substituir qualquer região codificada por um parâmetro `$.AwsRegion` or `$['AwsRegion']`. No tempo de execução do fluxo, esses parâmetros são substituídos pela região em que o fluxo é executado.
+ Garanta que todas as funções do Lambda nas Regiões da AWS tenham o mesmo nome.
+ Para os bots do Amazon Lex, é possível utilizar uma das seguintes opções:
+ Use o Amazon Lex Global Resiliency para replicar bots em todas as regiões da AWS e reter o ID do bot.
+ Altere seus fluxos para uma ramificação com base na AWS região em que o fluxo está sendo executado. No runtime do fluxo, esses parâmetros são substituídos pela região em que o fluxo é executado, conforme mostrado no exemplo a seguir.
![\[A página de propriedades do bloco Verificar atributos de contato.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/acgr-requirements.png)
+ Para permitir a entrada Chaves gerenciadas pela AWS da instância de réplica, usando o AWS console, crie uma instância temporária do Amazon Connect na região em que você planeja criar a instância de réplica. Isso criará o padrão Chaves gerenciadas pela AWS para o Amazon Connect.
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)copia a configuração do Amazon Connect Regiões da AWS como parte do processo de replicação inicial. Após a conclusão desta primeira etapa, quaisquer alterações feitas nos recursos originais ou [espelhados](#mirrored-resources) posteriormente são sincronizadas continuamente. Isso ocorre de forma bidirecional, da origem para a réplica e da réplica para a origem.
+ Todos os números de telefone na instância de origem que ainda não estão associados a grupos de números são adicionados automaticamente ao grupo de distribuição de tráfego padrão. Essa etapa permite que os números de telefone estejam disponíveis nas regiões de origem e de réplica e possibilita que as associações de fluxo de números de telefone sejam espelhadas nas Regiões da AWS.
+ Para casos na região Ásia-Pacífico (Tóquio), somente números de telefone explicitamente habilitados para o recurso Resiliência Global do Amazon Connect (ACGR) serão compatíveis com o comportamento completo de replicação para a região Ásia-Pacífico (Osaka). Ao fazer o roteamento pela região Ásia-Pacífico (Osaka), as chamadas recebidas podem ter prazos de entrega de até 20 segundos.
+ O acesso de emergência para fazer login na instância de réplica fica disponível somente depois que o perfil de roteamento padrão e a fila são espelhados nas regiões.
+ À medida que a configuração é propagada Regiões da AWS, você pode ver o progresso nos AWS CloudTrail registros. Ou, no site do Amazon Connect administrador, você pode navegar até **Gerenciamento de usuários**, **Exibir alterações históricas** para ver uma trilha de auditoria das alterações nos usuários. As trilhas de auditoria também estão disponíveis para outras configurações.
+ Você pode ver os seguintes erros no CloudTrail registro que não afetam o espelhamento das configurações.
+ Erros HTTP 409 (conflito): esses erros ocorrem devido a conflitos de espelhamento ao processar várias atualizações de configuração feitas no mesmo recurso de central de atendimento em rápida sucessão. Embora esses erros possam aparecer nos logs, eles não afetam o espelhamento real dos recursos de central de atendimento.
+ Um conflito de nome de recurso ocorrerá se os recursos na instância de origem e na instância de réplica tiverem o mesmo nome, mas recursos IDs diferentes. Isso pode acontecer, por exemplo, se o recurso na instância de réplica tiver sido criado manualmente fora do processo de replicação.
No caso de conflitos de nome de recurso, [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)não sincroniza o recurso entre regiões. Em vez disso, é gerado um erro `ResourceConflictException`. Depois de resolver o conflito de nomes (por exemplo, excluir o recurso na instância de réplica), você pode executar `ReplicateInstance` novamente para sincronizar o recurso.
+ Depois de executar`ReplicateInstance`, você deve usar a [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API para associar agentes ao grupo de distribuição de tráfego padrão ou a um grupo de distribuição de tráfego personalizado.
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)A execução não sincroniza funções do Lambda, bots do Amazon Lex ou outras integrações de terceiros que você possa ter.
## Características da instância de réplica
+ A réplica da instância do Amazon Connect é criada na mesma conta da AWS da instância atual do Amazon Connect.
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)cria um grupo de distribuição de tráfego padrão, caso ainda não exista um. Esse grupo de distribuição de tráfego padrão tem três tipos de distribuição de tráfego:
+ Faça login
+ Agente
+ Telefonia
Use a [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API para criar mais grupos de distribuição de tráfego, no entanto, esses grupos adicionais de distribuição de tráfego não são grupos de distribuição de tráfego padrão e, portanto, oferecem suporte apenas às distribuições de agentes e telefonia.
+ O grupo de distribuição de tráfego padrão é o único grupo em que você pode alterar a distribuição `SignInConfig`. Veja o `IsDefault` parâmetro no tipo [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html)de dados.
+ Você usa `SignInConfig` para escolher os servidores de login de back-end para facilitar o login do atendente na instância do Amazon Connect. Por exemplo, se você chamar `UpdateTrafficDistribution` com uma `SignInConfig` modificada e um `TrafficDistributionGroup` não padrão, será retornada uma `InvalidRequestException`.
+ A instância de réplica tem o mesmo ID da instância do Amazon Connect por meio da qual ela é replicada.
## Quais recursos são espelhados na instância de réplica
[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)espelha os seguintes Amazon Connect recursos. Regiões da AWS
**Importante**
As cotas de serviço referentes a esses recursos são automaticamente comparadas nas Regiões da AWS *antes* que os recursos sejam espelhados nas regiões. Para aumentar qualquer outra cota na instância de réplica, envie uma solicitação.
+ Proficiências do atendente
+ Fluxos
+ Módulos de fluxo
+ Usuários
+ Perfis de roteamento
+ Queues (Filas)
+ Perfis de segurança
+ Horas de operação
+ Conexões rápidas
+ Atributos predefinidos
+ Prompts (não incluindo aqueles armazenados no S3)
+ Hierarquias de usuários (grupos e níveis)
+ Status do agente
+ Atributos predefinidos
+ Relatórios salvos
+ Visualizações
+ Tabela de dados
+ Espaços de trabalho
+ Versões do módulo de fluxo
+ Aliases do módulo de fluxo
+ Métricas personalizadas
+ Casos de teste
+ Notificações
**Notas importantes sobre recursos específicos**
**Relatórios salvos**: embora os relatórios salvos sejam replicados, os agendamentos associados aos relatórios salvos *não* são replicados.
**Visualizações**: somente as visualizações em um estado *publicado* são replicadas. As visualizações em estado de rascunho *não* são replicadas.
**Tabelas** de dados: os valores da tabela de dados que contêm referências literais de ARN ajustarão automaticamente o código da região à região local quando replicados. ARNs construído usando expressões pode não ajustar automaticamente o código da região.
[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)também replica as seguintes associações em Regiões da AWS:
+ Número de telefone e fluxo
+ Fila e perfil de roteamento
+ Usuário e perfil de segurança, perfil de roteamento e hierarquia de usuários
+ Perfis de roteamento
+ Fila e conexões rápidas
+ Fila e horas de operação
+ Fila e fluxo
**nota**
Após a replicação inicial, as alterações de configuração são replicadas de forma bidirecional entre as instâncias replicadas quase em tempo real. Se isso falhar, o recurso Resiliência Global do Amazon Connect tentará sincronizar as atualizações em 30 minutos.
## O que fazer após a criação da instância de réplica
Depois que a instância de réplica do Amazon Connect for criada, será necessário configurá-la:
1. Garanta redundância para integrações de front-end e back-end (por exemplo, SSO, Lambda, Lex) em todas as regiões.
1. Faça atualizações manuais correspondentes nas instâncias vinculadas.
1. Use a [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API para associar agentes ao grupo de distribuição de tráfego padrão.
Antes de associar atendentes a um grupo de distribuição de tráfego, eles devem estar presentes nas instâncias de origem e de réplica. Você não pode associar usuários a um grupo de distribuição de tráfego que tenham sido recém-adicionados à instância de origem e ainda não estejam na réplica.
## Quando entrar em contato com o AWS Support
Entre em contato com o AWS Support para obter ajuda com as seguintes atividades:
+ Para entender o status do espelhamento além do que está disponível nos CloudTrail registros e na trilha de auditoria no site do Amazon Connect administrador.
## Por que uma ReplicateInstance chamada falha
Uma chamada de [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API falha com um `InvalidRequestException` nos seguintes casos:
1. A região em que você está criando a réplica é a mesma região da instância existente.
1. A instância já foi replicada como parte de uma chamada de [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API diferente.
1. A instância não tem um alias.
1. A instância não está no status `ACTIVE`.
1. A instância não tem o SAML habilitado.
1. Há um conflito de nome de recurso.
## Como encontrar a região de origem das instâncias do Amazon Connect
Se você esquecer qual é sua região de origem para instâncias do Amazon Connect, execute as seguintes etapas para encontrá-la:
1. Chame a [ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html)API com seu`InstanceId`.
1. Para qualquer grupo de distribuição de tráfego na lista de respostas, o `InstanceARN` retornado inclui a região de origem. Por exemplo, no seguinte ARN, *source-region* seria a região da sua instância do Amazon Connect.
`arn:aws:connect:source-region:account-id:traffic-distribution-group/ traffic-distribution-group-id`
# Criar grupos de distribuição de tráfego para a instância do Amazon Connect
Você pode criar um grupo de distribuição de tráfego para sua instância atual do Amazon Connect usando a [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API.
Um *grupo de distribuição de tráfego* é um recurso do Amazon Connect que permite vincular instâncias do Amazon Connect que estão em diferentes Regiões da AWS. Os números de telefone podem ser anexados ao grupo de distribuição de tráfego. O tráfego para esses números pode ser distribuído entre as instâncias no grupo de distribuição de tráfego.
## O que é importante saber
+ Ao criar um grupo de distribuição de tráfego, ele deve ser criado na Região da AWS de origem. A *região de origem* é aquela em que você configura a instância atual do Amazon Connect.
+ Ao associar números de telefone a um grupo de distribuição de tráfego:
+ Você pode associar somente números de telefone solicitados na região de origem.
+ O número de telefone deve estar na mesma região em que que o grupo de distribuição de tráfego foi criado.
+ Você pode solicitar números para um grupo de distribuição de tráfego ou obter ou atualizar a distribuição de tráfego de um grupo de distribuição de tráfego somente quando o `Status` é `ACTIVE`. Use a [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API para determinar se ela foi criada com sucesso (`Status`deve ser`ACTIVE`).
+ Quando você cria uma instância de réplica do Amazon Connect, um grupo de distribuição de tráfego padrão é criado para ela. O grupo de distribuição de tráfego padrão é o único grupo em que você pode alterar a distribuição `SignInConfig`. Veja o `IsDefault` parâmetro no tipo [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html)de dados. Use `SignInConfig` para escolher quais servidores de login de back-end são usados para facilitar o login do atendente na instância do Amazon Connect. Por exemplo, se você chamar `UpdateTrafficDistribution` com uma `SignInConfig` modificada e um `TrafficDistributionGroup` não padrão, será retornada uma `InvalidRequestException`.
## Status do grupo de distribuição de tráfego
Veja abaixo uma descrição dos status do grupo de distribuição de tráfego:
+ `CREATION_IN_PROGRESS`: a criação do grupo de distribuição de tráfego está em andamento.
+ `ACTIVE`: o grupo de distribuição de tráfego foi criado.
+ `CREATION_FAILED`: a criação do grupo de distribuição de tráfego apresentou falha.
+ `PENDING_DELETION`: a exclusão do grupo de distribuição de tráfego está em andamento.
+ `DELETION_FAILED`: a exclusão do grupo de distribuição de tráfego apresentou falha.
+ `UPDATE_IN_PROGRESS`: a atualização do grupo de distribuição de tráfego está em andamento.
## Por que uma CreateTrafficDistributionGroup chamada falha
Uma chamada de [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API falha com um `InvalidRequestException` nos seguintes casos:
+ A [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API não foi chamada antes de criar um grupo de distribuição de tráfego para as instâncias vinculadas.
+ A [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API não foi chamada na mesma região em que a [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API foi chamada. A região em que essa API é chamada deve corresponder à região da instância que foi usada para criar uma réplica.
# 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.
# 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 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API 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 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API. 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 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API para atribuir o número de telefone a um novo`TargetArn`.
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.
1. 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](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html). 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.
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 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)usando 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 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API 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ê.
[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.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.
# Atualize a distribuição do tráfego de telefonia entre as instâncias do Amazon Connect e Regiões da AWS
Você usa a [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API para distribuir o tráfego de telefonia e [transferir agentes](update-agents-across-regions.md) entre regiões.
**nota**
Ao mudar o tráfego de telefonia, alterne também os logins dos and/or agentes para garantir que eles possam lidar com as chamadas na outra região. Se você não transferir os atendentes, as chamadas de voz serão enviadas para a região alterada, mas não haverá nenhum atendente disponível para recebê-las.
Depois de reivindicar números de telefone para seu grupo de distribuição de tráfego, você pode usar a [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API para distribuir contatos de voz de entrada entre instâncias vinculadas em um determinado grupo de distribuição de tráfego em incrementos de 10%.
Se os requisitos a seguir não forem atendidos, sua chamada de [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API falhará com um`InvalidRequestException`:
+ Você deve fornecer distribuição para a configuração do tráfego de telefonia.
+ É necessário especificar a distribuição do tráfego para ambas as instâncias vinculadas, e a distribuição total deve perfazer 100%.
+ Você deve especificar a distribuição do tráfego em incrementos de 10%.
+ A instância ARNs especificada na configuração de telefonia deve corresponder à ARNs das instâncias vinculadas.
Ao chamar `UpdateTrafficDistribution` da região da AWS de origem, você pode usar o ID do grupo de distribuição de tráfego ou o nome do recurso da Amazon (ARN). Ao chamar `UpdateTrafficDistribution` da região da réplica, você deve usar o ARN do grupo de distribuição de tráfego.
# Configurar a experiência do atendente com o Amazon Connect Global Resiliency
O Amazon Connect Global Resiliency permite que você forneça uma experiência global para atendentes com login global, API de distribuição de atendentes e aprimoramentos do espaço de trabalho do atendente. Com esse conjunto de recursos, você pode:
+ Habilitar os atendentes para que façam login uma vez no início do dia e processem os contatos da região ativa atual sem precisar saber qual região está ativa em um momento qualquer.
+ Adicionar atendentes ao grupo de distribuição de tráfego e distribuir atendentes nas regiões da AWS.
+ Redirecionar novos contatos de voz de entrada para o espaço de trabalho do atendente da região ativa atual com uma simples atualização de página.
**Topics**
+ [Integrar o IdP a um endpoint de login SAML do Amazon Connect Global Resiliency](integrate-idp.md)
+ [Associe agentes a instâncias em várias AWS regiões](associate-agents-across-regions.md)
+ [Atualizar a distribuição de atendentes entre regiões](update-agents-across-regions.md)
+ [Configurar o espaço de trabalho do atendente](setup-agentworkspace-switchover.md)
+ [Dicas para evitar problemas ao transferir atendentes entre regiões](possible-issues-shifting-regions.md)
# Integrar o provedor de identidades (IdP) a um endpoint de login SAML do Amazon Connect Global Resiliency
Para permitir que seus agentes façam login uma vez e estejam conectados às duas AWS regiões para processar contatos da região ativa atual, você precisa definir as configurações do IAM para usar o endpoint SAML de login global.
## Antes de começar
Você deve habilitar o SAML para a instância do Amazon Connect para usar o Amazon Connect Global Resiliency. Para obter mais informações, consulte [Habilitar o acesso de usuários federados SAML 2.0 ao AWS Management Console](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-saml.html).
## O que é importante saber
+ O failover do agente só é suportado ao usar o endpoint de login global.
+ Para executar as etapas neste tópico, você precisará do ID da instância. Para obter instruções sobre como encontrá-la, consulte [Encontrar o ID ou ARN da instância do Amazon Connect](find-instance-arn.md).
+ Você também precisará saber qual é a região de origem das instâncias do Amazon Connect. Para obter instruções sobre como encontrá-la, consulte [Como encontrar a região de origem das instâncias do Amazon Connect](create-replica-connect-instance.md#how-to-find-source-region-of-instances).
+ Se você estiver incorporando a aplicação Connect em um iframe, deverá garantir que o domínio esteja presente na lista de origens aprovadas na instância de origem e de réplica para que o login global funcione.
Para configurar as origens aprovadas no nível da instância, siga as etapas em [Usar uma lista de permissões para aplicações integradas no Amazon Connect](app-integration.md).
+ Os atendentes já devem estar criados em *ambas* as instâncias (origem e réplica) do Amazon Connect e ter um nome de usuário igual ao nome da sessão de função do provedor de identidades (IdP). Caso contrário, você receberá uma `UserNotOnboardedException` e correrá o risco de perder os recursos de redundância de atendentes entre as instâncias.
+ Você deve associar os atendentes a um grupo de distribuição de tráfego antes que eles tentem fazer login. Do contrário, o login do atendente apresentará falha com uma `ResourceNotFoundException`. Para obter informações sobre como configurar grupos de distribuição de tráfego e associar atendentes a eles, consulte [Associe agentes às instâncias do Amazon Connect em várias AWS regiões](associate-agents-across-regions.md).
+ Quando os atendentes se agrupam no Amazon Connect com o novo URL de login do SAML, o Amazon Connect Global Resiliency sempre tenta registrar o atendente em suas regiões/instâncias de origem e réplica, independentemente de como `SignInConfig` está definida no grupo de distribuição de tráfego. Você pode verificar isso verificando CloudTrail os registros.
+ A `SignInConfig` distribuição em seu grupo de distribuição de tráfego padrão determina apenas o que Região da AWS é usado para facilitar o login. Independentemente de como a distribuição `SignInConfig` está configurada, o Amazon Connect sempre tenta fazer login dos atendentes nas duas regiões da instância do Amazon Connect.
+ Após a replicação de uma instância do Amazon Connect, somente um endpoint de login do SAML é gerado para as instâncias. Esse endpoint sempre contém a fonte Região da AWS na URL.
+ Não há necessidade de configurar um estado de retransmissão ao usar o URL de login personalizado do SAML com o Amazon Connect Global Resiliency.
## Como integrar o provedor de identidades
1. Quando você cria uma réplica da sua instância do Amazon Connect usando a [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API, um URL de login SAML personalizado é gerado para suas instâncias do Amazon Connect. O URL é gerado no seguinte formato:
`https://instance-id.source-region.sign-in.connect.aws/saml`
1. *instance-id*é o ID da instância de qualquer instância em seu grupo de instâncias. O ID da instância é idêntico nas regiões de origem e réplica.
1. *source-region*corresponde à AWS região de origem na qual a [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API foi chamada.
1. Adicione a política de confiança a seguir ao seu perfil de federação do IAM. Use o URL para o endpoint de login global do SAML conforme mostrado no exemplo a seguir.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Principal":{
"Federated":[
"arn:aws:iam::111122223333:saml-provider/MySAMLProvider"
]
},
"Action":"sts:AssumeRoleWithSAML",
"Condition":{
"StringLike":{
"SAML:aud":[
"https://instance-id.source-region.sign-in.connect.aws/saml*"
]
}
}
}
]
}
```
------
**nota**
`saml-provider-arn` é o recurso do provedor de identidades criado no IAM.
1. Permita o acesso de `connect:GetFederationToken` ao `InstanceId` na federação do IAM. Por exemplo:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "GetFederationTokenAccess",
"Effect": "Allow",
"Action": "connect:GetFederationToken",
"Resource": "*",
"Condition": {
"StringEquals": {
"connect:InstanceId": "your-instance-id"
}
}
}
]
}
```
------
1. Adicione um mapeamento de atributos à aplicação do provedor de identidades usando as strings de atributos e valores a seguir.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/integrate-idp.html)
1. Configure o URL do Assertion Consumer Service (ACS) do provedor de identidades para apontar para o URL de login personalizado do SAML. Use o seguinte exemplo para o URL do ACS:
```
https://instance-id.source-region.sign-in.connect.aws/saml?&instanceId=instance-id&accountId=your AWS account ID&role=saml-federation-role&idp=your SAML IDP&destination=optional-destination
```
1. Defina os seguintes campos nos parâmetros do URL:
+ `instanceId`: o identificador da instância do Amazon Connect. Para obter instruções sobre como localizar o ID da instância, consulte [Encontrar o ID ou ARN da instância do Amazon Connect](find-instance-arn.md).
+ `accountId`: o ID da AWS conta em que as instâncias do Amazon Connect estão localizadas.
+ `role`: defina como o nome ou o nome do recurso da Amazon (ARN) da função do SAML usada para federação do Amazon Connect.
+ O nome do recurso da Amazon (ARN) do provedor de identidades SAML do IAM.
+ `destination`: defina o caminho opcional pelo qual os atendentes chegarão à instância após o login (por exemplo: `/agent-app-v2`).
# Associe agentes às instâncias do Amazon Connect em várias AWS regiões
Para permitir que seus agentes façam login em ambas Regiões da AWS e processem contatos de qualquer região, você deve primeiro atribuí-los a um grupo de distribuição de tráfego.
1. Se você ainda não configurou um grupo de distribuição de tráfego, faça isso agora. Para instruções, consulte [Criar grupos de distribuição de tráfego para a instância do Amazon Connect](setup-traffic-distribution-groups.md).
1. Depois que o grupo de distribuição de tráfego for criado com sucesso (o `Status` será `ACTIVE`), você poderá atribuir atendentes a ele. Sempre associe usuários a um grupo de distribuição de tráfego na região de origem.
A atribuição de um atendente a um grupo de distribuição de tráfego sem o status `ACTIVE` gera uma `ResourceNotFoundException`. Use a [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API para determinar se ela foi criada com sucesso (`Status`deve ser`ACTIVE`).
1. Você pode atribuir um agente a um grupo de distribuição de tráfego chamando a [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API.
## Exemplos
O `associate-traffic-distribution-group-user` exemplo de comando a seguir mostra como os agentes podem ser associados e usados em várias AWS regiões.
```
aws connect associate-traffic-distribution-group-user
--traffic-distribution-group-id UUID
--user-id UUID
--instance-id
```
O [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)exemplo a seguir associa um agente a um grupo de distribuição de tráfego.
```
PUT /traffic-distribution-group/trafficDistributionGroupId/user HTTP/1.1
Content-type: application/json
{
"UserId": "string"
}
```
O exemplo de comando `disassociate-traffic-distribution-group-user` a seguir desassocia um atendente de um grupo de distribuição de tráfego.
```
aws connect disassociate-traffic-distribution-group-user
--instance-id your instance ID
--traffic-distribution-group-id UUID
--user-id UUID
```
O [DisassociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_DisassociateTrafficDistributionGroupUser.html)exemplo a seguir desassocia um agente de um grupo de distribuição de tráfego.
```
DELETE /traffic-distribution-group/trafficDistributionGroupId/user/UserId HTTP/1.1
```
## Por que uma AssociateTrafficDistributionGroupUser chamada falha
Uma chamada de [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API falha com um `ResourceNotFoundException` nos seguintes casos:
1. O grupo de distribuição de tráfego especificado não existe.
1. O status do grupo de distribuição de tráfego não é `ACTIVE`.
1. `user-id UUID` não é um usuário da instância de origem do Amazon Connect.
# Atualize a distribuição de agentes em seu espaço de trabalho de agentes do Amazon Connect em todas as regiões AWS
Assim como você pode usar a API `UpdateTrafficDistribution` para [distribuir o tráfego de telefonia entre regiões](update-telephony-traffic-distribution.md), também pode usá-la para distribuir atendentes nas regiões da AWS , de uma vez ou gradativamente, como parte dos testes regulares de prontidão operacional. Por exemplo, você pode manter 40% dos agentes em uma AWS região para concluir os contatos ativos e transferir os agentes restantes para a região de réplica.
**nota**
Ao mudar o tráfego de telefonia, alterne também os logins dos and/or agentes para garantir que eles possam lidar com as chamadas na outra região. Se você não transferir os atendentes, as chamadas de voz serão enviadas para a região alterada, mas não haverá nenhum atendente disponível para recebê-las.
Depois de adicionar agentes ao seu grupo de distribuição de tráfego, use a [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API para distribuir agentes entre instâncias vinculadas em um determinado grupo de distribuição de tráfego em incrementos de 10%. Os atendentes poderão concluir contatos de voz ativos antes de mudar de região.
**nota**
Se um atendente receber uma mensagem de erro ao tentar encerrar um contato antes de mudar de região, ele precisará atualizar a página do espaço de trabalho do atendente. Para obter mais informações, consulte [Configure o Amazon Connect Agent Workspace para oferecer suporte a agentes que mudam de região para região AWS](setup-agentworkspace-switchover.md).
**Topics**
+ [Requisitos](#update-agent-traffic-distribution-requirements)
+ [Habilitar ambas as regiões durante operações regulares](#change-signin-weights)
+ [Como transferir todo o tráfego e agentes de telefonia entre AWS regiões](#shift-all-traffic)
+ [Banner de interface de usuário do switch regional](#regional-switch-ui-banner)
## Requisitos
Se os requisitos a seguir não forem atendidos, sua chamada de [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API falhará com um`InvalidRequestException`:
1. O grupo de distribuição de tráfego especificado deve existir.
1. O status do grupo de distribuição de tráfego deve ser `ACTIVE`.
1. Se você estiver alterando a distribuição de `SignInConfig`, poderá fazer isso somente para o grupo de distribuição de tráfego padrão. Quando você cria uma instância de réplica do Amazon Connect, um grupo de distribuição de tráfego padrão é criado para ela. Veja o `IsDefault` parâmetro no tipo [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html)de dados.
Ao chamar `UpdateTrafficDistribution` da região da AWS de origem, você pode usar o ID do grupo de distribuição de tráfego ou o nome do recurso da Amazon (ARN). Ao chamar `UpdateTrafficDistribution` da região da réplica, você deve usar o ARN do grupo de distribuição de tráfego.
## Ative ambos Regiões da AWS durante operações regulares
A API `UpdateTrafficDistribution` inclui uma distribuição chamada `SignInConfig`. Ela permite escolher quais servidores de login de back-end são usados para facilitar o login do atendente no grupo de instâncias. Independentemente da definição de `SignInConfig` no grupo de distribuição de tráfego, os atendentes serão conectados às duas instâncias do grupo de distribuição de tráfego.
Para obter a melhor experiência, recomendamos que as duas AWS regiões sejam ativadas durante as operações regulares. Para isso, utilize `true` para ambas as distribuições de `SignInConfig`. Se você precisar transferir todo o tráfego e os agentes de telefonia para uma AWS região, recomendamos alterar a `SignInConfig` `false` para a região da qual você está retirando o tráfego.
Por exemplo, a chamada a seguir possibilita que os atendentes tenham 50% de chance de usar o servidor de login us-west-2 e 50% de usar o servidor de login us-east-1 para determinada chamada de login do provedor de identidades.
```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
"SignInConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Enabled":true
},
{
"Region":"us-east-1",
"Enabled":true
}
]
}
}'
```
Em contraposição, a distribuição de login a seguir roteia 100% do tráfego no endpoint de login para usar o servidor de login us-east-1.
```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
"SignInConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Enabled":false
},
{
"Region":"us-east-1",
"Enabled":true
}
]
}
}'
```
Essa distribuição controla somente qual região do servidor de login é usada para facilitar o login do atendente em ambas as instâncias no grupo de instâncias. Isso não afeta a distribuição de atendentes controlados pela parte `AgentConfig` da API `UpdateTrafficDistribution`.
**Importante**
Se o endpoint de login não responder durante o login do atendente e a distribuição de `SignInConfig` estiver dividida entre regiões, você poderá resolver os erros alterando a distribuição para uma única região da AWS . Ou, se `SignInConfig` estiver ponderada em uma única região e não responder, tente mudar `SignInConfig` para a região desabilitada. Independentemente de como `SignInConfig` está definida, os atendentes ainda se beneficiarão de ter uma sessão ativa nas regiões de origem e de réplica, pois tentarão entrar na instância do Amazon Connect em ambas as regiões.
## Como transferir todo o tráfego e agentes de telefonia entre AWS regiões
Para mudar todos os novos contatos de voz de entrada, a distribuição de login de atendentes e a distribuição de atendentes de us-west-2 para us-east-1, use o seguinte trecho de código.
```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
"SignInConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Enabled":false
},
{
"Region":"us-east-1",
"Enabled":true
}
]
},
"AgentConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Percentage":0
},
{
"Region":"us-east-1",
"Percentage":100
}
]
},
"TelephonyConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Percentage":0
},
{
"Region":"us-east-1",
"Percentage":100
}
]
}
}
'
```
Ao chamar `UpdateTrafficDistribution` da região da AWS de origem, você pode usar o ID do grupo de distribuição de tráfego ou o nome do recurso da Amazon (ARN). Ao chamar `UpdateTrafficDistribution` da região da réplica, você deve usar o ARN do grupo de distribuição de tráfego.
## Banner de interface de usuário do switch regional
O Agent Workspace e o CCP fornecerão um banner de interface destacando a mudança de região.
Se um agente estiver **em um contato** quando sua região mudar devido aos ajustes do grupo de distribuição de tráfego (TDG), ele verá um banner semelhante ao abaixo. Depois de concluir o contato de voz e fechar o estado ACW, o agente será atualizado automaticamente para a nova região — nenhuma ação é necessária. Se o agente tiver problemas para fechar o contato, ele poderá selecionar **Continuar no Backup** e um pop-up aparecerá solicitando confirmação para mudar para a região alternativa.
Recomendamos que você ajuste seu caderno de instruções e o guia de treinamento de agentes para refletir isso.
![\[A interface do Agent Workspace mostrando um banner que destaca o failover regional durante os ajustes do TDG.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/acgr-failover-banner.png)
![\[O pop-up de confirmação que aparece quando um agente seleciona Continuar no Backup.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/acgr-failover-confirmation.png)
# Configure o Amazon Connect Agent Workspace para oferecer suporte a agentes que mudam de região para região AWS
Execute as etapas a seguir para permitir que o Amazon Connect Agent Workspace incorpore o Painel de controle de contatos da região de réplica à AWS região de origem e alterne entre elas conforme a região ativa do agente muda.
Se você ainda não criou uma réplica da instância de origem do Amazon Connect ou configurou um grupo de distribuição de tráfego, consulte [Conceitos básicos do Amazon Connect Global Resiliency](get-started-connect-global-resiliency.md).
1. Acesse o console do AWS Amazon Connect para recuperar a **URL de acesso** da sua instância de origem. Anote os URLs.
1. Na região da réplica, console do AWS Amazon Connect para recuperar a **URL de acesso** da sua instância de réplica. Anote os URLs.
1. Na mesma janela da instância de réplica do Amazon Connect, no painel esquerdo, escolha **Origens aprovadas**.
1. Adicione o domínio para o **URL de acesso** da instância de origem, do qual você tomou nota na etapa 1.
**nota**
Não inclua a **/** no final do URL de acesso.
1. Repita as etapas acima na instância de origem: acesse **Origens aprovadas** e adicione o URL de acesso para a instância de réplica.
**nota**
Os atendentes devem definir seu status como **Disponível** depois de mudarem de região para região.
# Dicas para evitar problemas ao transferir atendentes na instância do Amazon Connect entre regiões
+ Sempre que você atualizar a distribuição de tráfego para atendentes, atualize também a distribuição de tráfego para contatos de voz de entrada. Caso contrário, pode ocorrer uma situação em que uma região tenha muitos atendentes e a outra tenha muito tráfego de telefonia.
+ Antes de associar usuários a um grupo de distribuição de tráfego, certifique-se de que o mesmo nome de usuário exista nas instâncias de origem e de réplica do Amazon Connect. Caso contrário, ao associar um usuário a um grupo de distribuição de tráfego e o usuário com o nome de usuário não existir na região da réplica, você receberá um erro `InvalidRequestException`.
+ Você deve chamar a [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API para associar agentes a um grupo de distribuição de tráfego na região de origem. Se você tentar fazer isso enquanto estiver na região de réplica, receberá um erro `ResourceNotFoundException`.
# Gerencie grupos de distribuição de tráfego usando o Amazon Connect APIs
Os tópicos desta seção descrevem como gerenciar grupos de distribuição de tráfego usando o Amazon Connect APIs.
**Topics**
+ [Listar grupos de distribuição de tráfego](list-traffic-distribution-groups.md)
+ [Excluir grupos de distribuição de tráfego](delete-traffic-distribution-groups.md)
# Listar grupos de distribuição de tráfego
Use a [ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html)API para listar todos os grupos de distribuição de tráfego.
É uma boa ideia listar os grupos de distribuição de tráfego para determinar se uma instância específica do Amazon Connect faz parte de algum desses grupos.
# Excluir grupos de distribuição de tráfego no Amazon Connect
Use a [DeleteTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html)API para excluir um grupo de distribuição de tráfego que não é mais necessário.
**nota**
Não é possível excluir um grupo de distribuição de tráfego se houver números de telefone solicitados para ele. Primeiro, você deve liberar números de telefone do grupo de distribuição de tráfego usando a [ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html)API. Em seguida, é possível excluí-lo.
Não é possível liberar números de um grupo de distribuição de tráfego usando o console do Amazon Connect.
Sua chamada de [DeleteTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html)API falhará `ResourceInUseException` se os números de telefone ainda estiverem reivindicados para o grupo de distribuição de tráfego.
# Gerencie números de telefone em todas as regiões usando o Amazon Connect APIs
Os tópicos desta seção descrevem como gerenciar números de telefone Regiões da AWS usando o Amazon Connect APIs.
**Topics**
+ [Solicite números de telefone para instâncias em várias Regiões da AWS](claim-phone-number-multiple-regions.md)
+ [Mova um número de telefone reivindicado para várias instâncias Regiões da AWS](move-phone-number-multiple-regions.md)
+ [Liberar números de grupos de distribuição de tráfego](release-numbers-traffic-distribution-group.md)
# Solicite números de telefone para instâncias do Amazon Connect em várias Regiões da AWS
**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.
Para fazer ou receber chamadas para um número de telefone em várias instâncias Regiões da AWS, você precisa reivindicar um número de telefone para um grupo de distribuição de tráfego.
**Como solicitar números de telefone para o grupo de distribuição de tráfego**
1. Crie um grupo de distribuição de tráfego usando a [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API.
1. Descreva seu grupo de distribuição de tráfego usando a [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API para determinar se ele foi criado com sucesso (`Status`deve ser`ACTIVE`).
1. Depois que seu grupo de distribuição de tráfego for criado com sucesso (`Status`é`ACTIVE`), você pode reivindicar números de telefone para ele usando a [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API.
# Mova um número de telefone reivindicado para várias instâncias do Amazon Connect em Regiões da AWS
**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.
Você pode transferir um número de telefone anteriormente solicitado para uma instância e atribuí-lo para várias instâncias entre as Regiões da AWS. Para isso, atribua o número de telefone a um grupo de distribuição de tráfego.
**Como atribuir um número de telefone para o grupo de distribuição de tráfego**
1. Crie um grupo de distribuição de tráfego usando a [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API.
1. Descreva seu grupo de distribuição de tráfego usando a [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API para determinar se ele foi criado com sucesso (`Status`deve ser`ACTIVE`).
1. Depois que o grupo de distribuição de tráfego for criado com sucesso (o `Status` é `ACTIVE`), você pode atribuir números de telefone solicitados anteriormente a outras instâncias ou outros grupos de distribuição de tráfego. Use a API do [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html).
# Liberar números de telefone de grupos de distribuição de tráfego no Amazon Connect
Para liberar números de telefone de um grupo de distribuição de tráfego, use a [ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html)API. O número é liberado de volta para o inventário para que outros clientes o solicitem.
Não é possível liberar números de um grupo de distribuição de tráfego usando o console do Amazon Connect.
# Gerenciar chats na instância do Amazon Connect entre regiões
Você gerencia o bate-papo entre AWS regiões criando duas interfaces de bate-papo personalizadas ou dois widgets de out-of-the-box comunicação: um na região de origem e outro na região de réplica. Você alterna manualmente entre eles, dependendo da interface de bate-papo ou do widget de out-of-the-box comunicação da região que você deseja usar.
+ Interfaces de chat personalizadas: configure a interface de chat na região de réplica para usar o endpoint da API da região de réplica. Para exemplos de interfaces personalizadas, consulte a [biblioteca de código aberto do Amazon Connect](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master) em GitHub. Para obter mais informações, consulte [Personalizar o chat com o exemplo de código aberto do Amazon Connect](download-chat-example.md).
+ Out-the-box widgets de comunicação: crie um widget de comunicação na instância réplica do Amazon Connect. Para instruções, consulte [Configurar um widget de comunicação na instância de réplica](#communicationswidget-multiple-regions).
A seguir estão os parâmetros de configuração de chat necessários em seu site ou aplicação para iniciar um chat do lado do cliente:
+ **ID da instância** e **ID de fluxo do Amazon Connect**: estes parâmetros são os mesmos nas regiões de origem e de réplica.
+ ** AWS Região de destino** e, geralmente, um **endpoint de API** para iniciar o bate-papo (ou seja, para adquirir o token do participante): esses parâmetros são diferentes nas regiões de origem e de réplica.
Por exemplo, o diagrama a seguir mostra como a configuração do chat precisa ser atualizada para apontar para o API Gateway na região de réplica quando o tráfego do chat precisa ser movido entre regiões.
![\[Um diagrama que mostra a região de origem e a região de réplica.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/chatconfig.png)
## Configurar um widget de comunicação na instância de réplica
1. Na instância de origem do Amazon Connect, crie um widget de comunicação para chat, caso ainda não exista um. Para instruções, consulte [Adicionar uma interface de usuário de chat ao seu site hospedado pelo Amazon Connect](add-chat-to-website.md).
1. Na instância de réplica, crie outro widget de comunicação para chat. Configure o widget com o mesmo fluxo usado no widget na instância de origem. O fluxo já está na instância de réplica porque o Amazon Connect Global Resiliency copia todos os fluxos da origem para a réplica e os mantém continuamente sincronizados.
1. Copie o novo script do widget de comunicação que você criou na instância de réplica. Incorpore o script no site ou aplicação que deve ser ativado quando o tráfego do chat é encaminhado para a instância de réplica.
1. Para alternar o tráfego entre regiões, substitua o widget de comunicação da instância de origem pelo widget de comunicação da instância de réplica na sua página da web.
A imagem a seguir mostra um exemplo de script de widget.
![\[Um exemplo de script de widget de comunicação.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/source-comwidget.png)
1. Se você fizer alguma alteração no widget de comunicação na instância de origem posteriormente, também precisará fazer as mesmas alterações no widget de comunicação na instância de réplica.
## Opção para adicionar mais uniformidade
Para tornar a transferência do tráfego de chat entre as regiões mais uniforme e exigir menos alterações manuais, veja a seguir outra forma de personalizar sua experiência de chat:
1. Adicione um parâmetro a um banco de dados controlado centralmente (por exemplo, tabela global do DynamoDB). O objetivo desse parâmetro é definir qual região está ativa no momento.
1. Atualize o site ou aplicação para verificar o status do parâmetro de região no banco de dados central.
1. Dependendo da região ativa, o site ou aplicação usará o endpoint da API ou o widget de comunicação dessa região.
1. Esse parâmetro deve ser atualizado ao mesmo tempo em que a [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API é chamada para transferir o tráfego de voz e os agentes entre as regiões, quando aplicável.
# Métricas, relatórios e pesquisas nas regiões do ACGR
Os tópicos desta seção descrevem métricas consolidadas, relatórios e pesquisas nos Regiões da AWS clientes do Amazon Connect Global Resiliency (ACGR).
**Topics**
+ [Pesquisa de contatos e detalhes de contato](contact-search-and-contact-details.md)
+ [Métricas consolidadas em todas as regiões](consolidated-metrics-across-regions.md)
# Pesquisa de contatos e detalhes de contato
**Importante**
[Para habilitar a busca consolidada de contatos para sua instância do ACGR, entre em contato com o Support AWS .](https://console.aws.amazon.com/support/home)
**Importante**
Quando você incorpora esse recurso, seu alias do Amazon Connect será atualizado para um novo subdomínio com o formato. `region.sourcealias.my.connect.aws` Por exemplo, se sua instância ACGR for implantada no Leste dos EUA (Norte da Virgínia) e no Oeste dos EUA (Oregon) com o alias de origem configurado como `source.my.connect.aws` e o alias de réplica, depois de `replica.my.connect.aws` integrar suas instâncias do Amazon Connect a esse recurso, você usará e. `us-east-1.source.my.connect.aws` `us-west-2.source.my.connect.aws` Certifique-se de atualizar suas regras de firewall e integrações de terceiros para consumir esses novos subdomínios.
Ao acessar a página de pesquisa de contatos, você vê os contatos de suas instâncias emparelhadas do Amazon Connect Global Resiliency (ACGR) por padrão, oferecendo uma visão completa das interações com os clientes em toda a sua organização. Isso fornece uma experiência de pesquisa perfeita, independentemente da região de origem dos contatos ou da região em que você está conectado no momento.
+ **Região ativa**: Região da AWS onde um contato está sendo processado ou foi concluído.
## Experiência de pesquisa de contatos
### Filtro de região ativa
Você verá um novo filtro “Região ativa” no menu suspenso de filtros. Isso permite que você restrinja sua pesquisa específica a uma região quando necessário.
Para usar o filtro de região ativa:
1. Na **página de pesquisa de contatos**, escolha **Adicionar filtro**.
1. Selecione **Região ativa** no menu suspenso.
1. Escolha uma ou mais regiões.
![\[O menu suspenso do filtro de região ativa mostrando as regiões disponíveis para selecionar.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/active-region-filter.png)
### Filtros de recursos específicos da região
Quando você usa os filtros a seguir, as opções suspensas exibem somente os recursos que foram criados na sua região conectada:
+ Atributos de contato personalizados
+ Categorias de contato
+ Filtros de avaliação
+ Endereço de e-mail
+ Atributos personalizados do segmento de contato
**Importante**
Quando você digita manualmente os valores do filtro em vez de selecionar nos menus suspensos, e esses nomes de recursos são idênticos nas instâncias do ACGR, seus resultados incluirão contatos de ambas as regiões.
Atributos de contato personalizados
Endereço de e-mail
**Os filtros de avaliação** retornam somente contatos da sua região atual, pois eles pesquisam usando um formulário de avaliação exclusivo IDs que é específico da região.
### Pesquisas salvas
Suas pesquisas salvas exibem contatos de ambas as instâncias do ACGR. Todos os filtros de região salvos anteriormente continuam funcionando conforme o esperado.
## Experiência com detalhes de contato
### Visualizando informações de contato
Ao abrir uma página de detalhes de contato, você vê informações abrangentes, independentemente da região de origem do contato, incluindo:
+ Visão geral, detalhes da conexão e informações da fila
+ Etiquetas e atributos de contato
+ Dados de lentes de contato (análise conversacional, transcrições de voz, transcrições de bate-papo)
+ Gravações de tela e áudio
+ Transcrições de bate-papo e interações de IVR
+ Anexos e transcrições de e-mail
A região ativa do contato é exibida na página de detalhes do contato em **Metadados de resiliência global**.
![\[A página de detalhes do contato mostrando a seção de metadados de resiliência global com as informações da região ativa.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/global-resiliency-metadata.png)
**nota**
Se a região ativa do contato estiver comprometida, algumas informações podem ficar indisponíveis, incluindo gravações de tela e áudio, transcrições de bate-papo, interações de IVR, anexos e transcrições de e-mail e dados de lentes de contato.
### Acesso aos dados da lente de contato
Você tem acesso total aos dados de lentes de contato em todas as regiões, incluindo:
+ Contatos em andamento: análise de conversas, transcrições de voz (editadas e não editadas) e transcrições de bate-papo.
+ Contatos concluídos: todas as análises de conversas, transcrições de voz (editadas e não editadas) e transcrições de bate-papo.
+ Gravações: as gravações de tela e áudio podem ser acessadas independentemente da região ativa do contato.
+ Transcrições: transcrições de chat, IVR e e-mail estão disponíveis em todas as regiões.
### Ações de contato
Você pode realizar ações de contato, como transferir, reagendar ou encerrar contato, independentemente da região ativa do contato. Essas ações são direcionadas para a região ativa do contato.
### Avaliações de contato
As avaliações de contato só estão disponíveis para contatos ativos em sua região conectada. Você não pode visualizar ou realizar avaliações para contatos replicados de outras regiões.
### SearchContacts API
Se você usa a SearchContacts API programaticamente, a resposta inclui informações adicionais:
+ GlobalResiliencyMetadata objeto: contém os `TrafficDistributionGroupId` campos `ActiveRegion``OriginRegion`, e para todos os contatos, mostrando a região específica em que o contato está ativo.
Para obter mais informações sobre a SearchContacts API, consulte a [Referência da API Amazon Connect](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchContacts.html).
# Métricas consolidadas em todas as regiões
**Importante**
[Para habilitar métricas consolidadas de agentes e contatos para sua instância ACGR, entre em contato com o Support AWS .](https://console.aws.amazon.com/support/home)
Ao visualizar métricas no Amazon Connect, você tem uma visão consolidada das métricas de agentes e contatos em todas as suas regiões emparelhadas, independentemente da região em que você está atualmente conectado.
Por exemplo, se você tiver 5 agentes conectados em us-east-1 e disponíveis BasicQueue para, e 10 agentes conectados em us-west-2 e disponíveis para, a página de métricas em tempo real mostra um total BasicQueue de 15 agentes on-line. Essa visão consolidada permite que você monitore suas operações de contact center em uma única interface.
## Métricas disponíveis
A visão consolidada está disponível em:
+ Métricas em tempo real: visualize a atividade atual do agente e as métricas de contato em suas instâncias do ACGR.
+ Métricas históricas: acesse dados históricos de desempenho em todas as instâncias do ACGR.
+ Métricas APIs: as respostas da API retornam métricas consolidadas em suas instâncias do ACGR.
**nota**
As métricas de agentes e contatos são consolidadas em todas as regiões. Outras métricas, como análises, permanecem específicas da região.
Para obter mais informações sobre os relatórios do Amazon Connect, consulte[Métricas, painéis e relatórios no Amazon Connect](amazon-connect-metrics.md).