Cómo actualizar la distribución de los agentes en su espacio de trabajo de agentes de Amazon Connect en todas las regiones de AWS - Amazon Connect
RequisitosCambio de las ponderaciones de inicio de sesiónCómo desplazar todo el tráfico de telefonía y los agentes entre regiones de AWS

Cómo actualizar la distribución de los agentes en su espacio de trabajo de agentes de Amazon Connect en todas las regiones de AWS

Del mismo modo que puede utilizar la API de UpdateTrafficDistribution para distribuir el tráfico de telefonía entre regiones, también puede utilizarla para distribuir los agentes entre las regiones de AWS, de forma completa o gradual como parte de las pruebas periódicas de disponibilidad operativa. Por ejemplo, podría mantener el 40% de los agentes en una región de AWS para completar los contactos activos y desplazar el resto de agentes a la región de réplica.

Una vez que haya agregado agentes a su grupo de distribución de tráfico, utilice la API UpdateTrafficDistribution para distribuir los agentes entre las instancias vinculadas de un grupo de distribución de tráfico determinado en incrementos del 10 %. Sus agentes podrán completar los contactos de voz activos antes de cambiar de región.

nota

Si un agente recibe un error cuando intenta finalizar un contacto antes de cambiar de región, deberá actualizar la página del espacio de trabajo del agente. Para obtener más información, consulte Configuración del espacio de trabajo de agente de Amazon Connect para admitir el desplazamiento de agentes entre regiones de AWS.

Requisitos

Si no se cumplen los siguientes requisitos, se producirá un error en su llamada a la API UpdateTrafficDistribution con InvalidRequestException:

  1. El grupo de distribución de tráfico especificado debe existir.

  2. El estado del grupo de distribución de tráfico debe ser ACTIVE.

  3. Si va a modificar la distribución de SignInConfig, solo podrá hacerlo para el grupo de distribución de tráfico predeterminado. El grupo de distribución de tráfico predeterminado se crea cuando se crea la réplica de la instancia de Amazon Connect. Consulte el parámetro IsDefault en el tipo de datos TrafficDistributionGroup.

Cuando llame a UpdateTrafficDistribution desde la región de origen de AWS, puede utilizar el ID de grupo de distribución de tráfico o el nombre de recurso de Amazon (ARN). Cuando llame a UpdateTrafficDistribution en la región de réplica, debe usar el ARN del grupo de distribución de tráfico.

Cambio de las ponderaciones de inicio de sesión

La API UpdateTrafficDistribution incluye una distribución llamada SignInConfig. Le permite elegir qué servidores de inicio de sesión backend se utilizan para facilitar al agente el inicio de sesión en su grupo de instancias. Independientemente del SignInConfig establecido en su grupo de distribución de tráfico, los agentes iniciarán sesión en ambas instancias del grupo de distribución de tráfico.

Para obtener la mejor experiencia, recomendamos tener habilitadas ambas regiones de AWS durante las operaciones habituales. Para lograrlo, pase true a ambas distribuciones de SignInConfig. Si necesita desplazar todo su tráfico de telefonía y agentes a una región de AWS, le recomendamos que cambie SignInConfig a false para la región de la que desplaza el tráfico.

Por ejemplo, la siguiente llamada hace que los agentes tengan un 50 % de posibilidades de utilizar el servidor de inicio de sesión de us-west-2 y un 50 % de utilizar el servidor de inicio de sesión de us-east-1 para una llamada de inicio de sesión determinada del proveedor 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
         }
      ]
   }
}'

Por el contrario, la siguiente distribución de inicio de sesión enruta el 100 % del tráfico en el punto de conexión para utilizar el servidor de inicio de sesión de 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
         }
      ]
   }
}'

Esta distribución controla solo qué región del servidor de inicio de sesión se utiliza para facilitar el inicio de sesión del agente en las dos instancias de su grupo de instancias. No afecta la distribución de los agentes controlados por la parte AgentConfig de la API UpdateTrafficDistribution.

importante

Si el punto de conexión no responde durante el inicio de sesión del agente y su distribución SignInConfig está dividida en varias regiones, puede resolver los errores si cambia la distribución a una sola región de AWS. O, si su SignInConfig se ha ponderado en una región y no responde, puede intentar efectuar el desplazamiento de SignInConfig a la región deshabilitada. Independientemente de cómo se haya configurado SignInConfig, los agentes seguirán beneficiándose de tener una sesión activa tanto en la región de origen como en la de réplica, ya que intentarán iniciar sesión en su instancia de Amazon Connect en ambas regiones.

Cómo desplazar todo el tráfico de telefonía y los agentes entre regiones de AWS

Para desplazar todos los nuevos contactos de voz entrantes, la distribución del registro de agentes y la distribución de agentes de us-west-2 a us-east-1, utilice el siguiente fragmento 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
         }
      ]
   }
}
'

Cuando llame a UpdateTrafficDistribution desde la región de origen de AWS, puede utilizar el ID de grupo de distribución de tráfico o el nombre de recurso de Amazon (ARN). Cuando llame a UpdateTrafficDistribution en la región de réplica, debe usar el ARN del grupo de distribución de tráfico.