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á.
# 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 apoiar 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.
