Atualizar a distribuição de atendentes no espaço de trabalho de atendentes do Amazon Connect entre regiões da AWS

Assim como você pode usar a API UpdateTrafficDistribution para distribuir o tráfego de telefonia entre regiões, 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 atendentes em uma região da AWS para concluir os contatos ativos e transferir os atendentes restantes para a região de réplica.

Depois de adicionar atendentes ao grupo de distribuição de tráfego, use a API UpdateTrafficDistribution para distribuir atendentes entre instâncias vinculadas em 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.

Requisitos

Se os seguintes requisitos não forem atendidos, a chamada da API UpdateTrafficDistribution apresentará falha com uma InvalidRequestException.

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.

Alterar pesos do login

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 regiões da AWS sejam habilitadas durante as operações regulares. Para isso, utilize true para ambas as distribuições de SignInConfig. Se você precisar transferir todo o tráfego de telefonia e os atendentes para uma região da AWS, recomendamos alterar SignInConfig para false na região da qual você está afastando 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.

Como transferir todo o tráfego de telefonia e atendentes entre regiões da AWS

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.