Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Introducción a la Resiliencia global de Amazon Connect **importante** Amazon Connect a las instancias creadas antes del 31 de marzo de 2021 se les asignó un dominio con el siguiente formato: ``` https://your-instance-alias.awsapps.com/connect/ ``` Si su dominio usa el formato anterior, no podrá configurar correctamente la característica Resiliencia global de Amazon Connect . Para habilitar esta característica, tendrá que [actualizar el dominio](update-your-connect-domain.md) al formato más reciente: ``` https://your-instance-alias.my.connect.aws/ ``` **nota** **¿Usuario nuevo?** Consulte el taller [Amazon Connect Global Resiliency Workshop](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Este curso en línea lo guía a través del proceso de incorporación y prueba de la conmutación por error de números de teléfono y agentes utilizando nuevos APIs a través de la AWS CLI. La resiliencia global solo está disponible para las instancias de Amazon Connect creadas en las siguientes AWS regiones: EE. UU. Este (Virginia del Norte), EE. UU. Oeste (Oregón), Asia Pacífico (Osaka), Asia Pacífico (Tokio), Europa (Fráncfort) y Europa (Londres). Solo puede crear una réplica en la región Este de EE. UU. (Norte de Virginia), si su origen es Oeste de EE. UU. (Oregón) o al revés. Solo puede crear una réplica en la región de Europa (Fráncfort) si su origen es Europa (Londres) o viceversa. Solo puede crear una réplica en la región de Asia-Pacífico (Osaka) si su origen es Asia-Pacífico (Tokio). Para obtener acceso a esta característica, contacte con su arquitecto de soluciones o administrador técnico de cuentas de Amazon Connect. Para empezar a utilizar Amazon Connect Global Resiliency, debe crear una réplica de su instancia de Amazon Connect existente en otra Región de AWS y crear un grupo de distribución de tráfico. Un *grupo de distribución de tráfico* es un recurso de Amazon Connect que permite vincular instancias de Amazon Connect que se encuentran en diferentes Regiones de AWS. Los números de teléfono pueden asociarse al grupo de distribución de tráfico. El tráfico hacia estos números puede distribuirse entre las instancias del grupo de distribución de tráfico. ## Cómo configurar Resiliencia global de Amazon Connect 1. [Cree una réplica de su instancia de Amazon Connect existente](create-replica-connect-instance.md). Uso de la API de [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html). 1. [Cree un grupo de distribución de tráfico](setup-traffic-distribution-groups.md). 1. Uso de la API de [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html). 1. Utilice la [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API para determinar si el grupo de distribución de tráfico se ha creado correctamente (`Status`debe serlo`ACTIVE`). 1. [Solicite números de teléfono a su grupo de distribución de tráfico](claim-phone-numbers-traffic-distribution-groups.md). Una vez que el grupo de distribución de tráfico `Status` se `ACTIVE` haya creado correctamente, puede reclamar sus números de teléfono mediante la [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API. **nota** La distribución de tráfico predeterminada para estos números de teléfono se establece a 100 % - 0 %. Es decir, el 100 % del tráfico de telefonía entrante se dirigirá a la instancia de Amazon Connect de origen que se utilizó para crear una réplica. Además, una vez solicitados los números de teléfono para una instancia, puede asignarlos a varias instancias en varias Regiones de AWS. Para ello, utiliza la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API para asignar los números a un grupo de distribución de tráfico. 1. [Actualice su distribución de tráfico](update-telephony-traffic-distribution.md). Usa la [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API para distribuir el tráfico entre las instancias vinculadas en incrementos del 10%. # Creación de una réplica de su instancia de Amazon Connect existente **nota** **¿Usuario nuevo?** Consulte el taller [Amazon Connect Global Resiliency Workshop](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Este curso en línea lo guía a través del proceso de incorporación y prueba de la conmutación por error de números de teléfono y agentes utilizando nuevos APIs a través de la AWS CLI. La resiliencia global solo está disponible para las instancias de Amazon Connect creadas en las siguientes AWS regiones: EE. UU. Este (Virginia del Norte), EE. UU. Oeste (Oregón), Asia Pacífico (Osaka), Asia Pacífico (Tokio), Europa (Fráncfort) y Europa (Londres). Solo puede crear una réplica en la región Este de EE. UU. (Norte de Virginia), si su origen es Oeste de EE. UU. (Oregón) o al revés. Solo puede crear una réplica en la región de Europa (Fráncfort) si su origen es Europa (Londres) o viceversa. Solo puede crear una réplica en la región de Asia-Pacífico (Osaka) si su origen es Asia-Pacífico (Tokio). Para obtener acceso a esta característica, contacte con su arquitecto de soluciones o administrador técnico de cuentas de Amazon Connect. Llama a la [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API para crear una réplica de su instancia de Amazon Connect en otra Región de AWS y para copiar la información de configuración de todos los recursos de Amazon Connect Regiones de AWS. **Topics** + [Cosas importantes que debe saber](#important-info-automated-config) + [Características de la instancia de réplica](#replica-characteristics) + [Qué recursos se reflejan en la instancia de réplica](#mirrored-resources) + [Qué hacer después de crear la instancia de réplica](#configure-replica-instance) + [Cuándo ponerse en contacto con AWS Support](#replica-cs) + [¿Por qué falla una ReplicateInstance llamada](#why-replicateinstance-fails) + [Búsqueda de la región de origen de su instancia](#how-to-find-source-region-of-instances) ## Cosas importantes que debe saber + Antes de ejecutar [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html): + Asegúrese de que dispone de los permisos de IAM mínimos necesarios para crear una instancia. Consulte [Permisos necesarios para utilizar políticas de IAM personalizadas para administrar el acceso a la consola de Amazon Connect](security-iam-amazon-connect-permissions.md). + Actualice sus flujos para reemplazar cualquier región codificada con un parámetro `$.AwsRegion` o `$['AwsRegion']`. En el tiempo de ejecución del flujo, estos parámetros se sustituyen por la región en la que se ejecuta el flujo. + Asegúrese de que sus funciones de Lambda en todas las Regiones de AWS tienen el mismo nombre. + En el caso de los bots de Amazon Lex, puede hacer una de las siguientes acciones: + Utilice Resiliencia global de Amazon Lex para replicar los bots en todas las regiones de AWS y conservar el ID del bot. + Cambie sus flujos para que se ramifiquen en función de la AWS región en la que se ejecute el flujo. En el tiempo de ejecución del flujo, estos parámetros se sustituyen por la región en la que se ejecuta el flujo, como se muestra en el ejemplo siguiente. ![\[La página de propiedades del bloque Comprobar atributos de contacto.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/acgr-requirements.png) + Para permitir Claves administradas por AWS la entrada de la instancia de réplica, mediante la AWS consola, cree una instancia temporal de Amazon Connect en la región en la que planea crear la instancia de réplica. Esto creará el valor predeterminado Claves administradas por AWS para Amazon Connect. + [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)copia la configuración de Amazon Connect Regiones de AWS como parte del proceso de replicación inicial. Una vez completado este primer paso, cualquier cambio realizado en los [recursos reflejados](#mirrored-resources) o en los originales en un momento posterior se sincroniza continuamente. Esto ocurre de forma bidireccional, del origen a la réplica y de la réplica al origen. + Todos los números de teléfono de la instancia de origen que no estén ya asociados a grupos de números se agregarán automáticamente al grupo de distribución de tráfico predeterminado. Este paso permite que los números de teléfono estén disponibles tanto en las regiones de origen como en las de réplica y que las asociaciones de flujo de números de teléfono se reflejen en todas las Regiones de AWS. + En el caso de las instancias de Asia-Pacífico (Tokio), solo los números de teléfono que estén habilitados explícitamente para la Resiliencia global de Amazon Connect (ACGR) admitirán un comportamiento de replicación completo en Asia-Pacífico (Osaka). Al pasar por Asia-Pacífico (Osaka), las llamadas entrantes pueden tener tiempos de entrega de hasta 20 segundos. + El acceso de emergencia para iniciar sesión en la instancia de réplica solo está disponible después de que el perfil de enrutamiento predeterminado y la cola se hayan replicado en todas las regiones. + A medida que la configuración se propaga Regiones de AWS, puede ver el progreso en los AWS CloudTrail registros. O bien, en el sitio web de Amazon Connect administración, puedes ir a **Administración de usuarios** y **ver el historial de cambios** para ver un registro de auditoría de los cambios en los usuarios. Los registros de auditoría también están disponibles para otras configuraciones. + Es posible que veas los siguientes errores en el CloudTrail registro, que no afectan a la duplicación de las configuraciones. + Errores Http 409 (conflicto): estos errores se producen debido a conflictos de duplicación al procesar varias actualizaciones de configuración realizadas en el mismo recurso del centro de contacto de forma rápida y sucesiva. Si bien estos errores pueden aparecer en sus registros, no afectan a la duplicación real de los recursos de su centro de contacto. + Se producirá un conflicto de nombre de recurso si los recursos de la instancia de origen y de la instancia de réplica tienen el mismo nombre pero un recurso diferente. IDs Esto podría ocurrir, por ejemplo, si el recurso en la instancia de réplica se creara manualmente fuera del proceso de replicación. En caso de conflictos de nombres de recursos, [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)no sincroniza el recurso en todas las regiones. En su lugar, genera un error `ResourceConflictException`. Después de resolver el conflicto de nombres (por ejemplo, al eliminar el recurso en la instancia de réplica), puede volver a ejecutar `ReplicateInstance` para sincronizar el recurso. + Después de `ReplicateInstance` ejecutarla, debe usar la [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API para asociar los agentes al grupo de distribución de tráfico predeterminado o a un grupo de distribución de tráfico personalizado. + [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)La ejecución no sincroniza las funciones de Lambda ni los bots de Amazon Lex ni otras integraciones o integraciones de terceros que pueda tener. ## Características de la instancia de réplica + La réplica de la instancia de Amazon Connect se crea en la misma cuenta de AWS que su instancia de Amazon Connect existente. + [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)crea un grupo de distribución de tráfico predeterminado si aún no existe ninguno. Este grupo de distribución de tráfico predeterminado tiene tres tipos de distribución de tráfico: + Inicie sesión + Agente + Telefonía Utilice la [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API para crear más grupos de distribución de tráfico; sin embargo, estos grupos de distribución de tráfico adicionales no son grupos de distribución de tráfico predeterminados y, por lo tanto, solo admiten distribuciones de agentes y telefonía. + El grupo de distribución de tráfico predeterminado es el único grupo de distribución de tráfico en el que puede cambiar la distribución de `SignInConfig`. Consulte el `IsDefault` parámetro en el tipo de [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html)datos. + Utilice `SignInConfig` para elegir los servidores de inicio de sesión backend a fin de facilitar al agente el inicio de sesión en su instancia de Amazon Connect. Por ejemplo, si llama `UpdateTrafficDistribution` con un `SignInConfig` modificado y un `TrafficDistributionGroup` no predeterminado, se devuelve un `InvalidRequestException`. + La instancia de réplica tiene el mismo ID de instancia que la instancia de Amazon Connect desde la que se replica. ## Qué recursos se reflejan en la instancia de réplica [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)refleja los siguientes Amazon Connect recursos Regiones de AWS. **importante** Las cuotas de servicio de estos recursos se hacen coincidir automáticamente entre Regiones de AWS *antes* de que los recursos se reflejen en las distintas regiones. Para aumentar cualquier otra cuota en la instancia de réplica, envíe una solicitud. + Competencias del agente + Flujos + Módulos de flujo + Users + Perfiles de enrutamiento + Colas + Perfiles de seguridad + Horas de funcionamiento + Conexiones rápidas + Atributos predefinidos + Mensajes (sin incluir los almacenados en S3) + Jerarquías de usuarios (grupos y niveles) + Estado del agente + Atributos predefinidos + Informes guardados + Vistas + Tablas de datos + Espacios de trabajo + Versiones del módulo de flujo + Alias del módulo de flujo + Métricas personalizadas + Casos de prueba + Notificaciones **Notas importantes sobre recursos específicos** **Informes guardados**: si bien los informes guardados se replican, las programaciones asociadas a los informes guardados *no* se replican. **Vistas**: solo se replican las vistas en un estado *publicado*. Las vistas en estado de borrador *no* se replican. Tablas de datos: los valores de **las tablas** de datos que contienen referencias de ARN literales ajustarán automáticamente el código de región a la región local cuando se repliquen. ARNs si se construyen con expresiones, es posible que no se ajuste automáticamente el código de región. [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)también reproduce las siguientes asociaciones en todas Regiones de AWS partes: + Número de teléfono a flujo + Cola a perfil de enrutamiento + Usuario a perfil de seguridad, perfil de enrutamiento y jerarquía de usuarios + Perfiles de enrutamiento + Cola a conexiones rápidas + Cola a horas de funcionamiento + Cola a flujo **nota** Tras la replicación inicial, los cambios de configuración se replican bidireccionalmente entre las instancias replicadas prácticamente en tiempo real. Si esto no funciona, la Resiliencia global de Amazon Connect intentará sincronizar las actualizaciones en 30 minutos. ## Qué hacer después de crear la instancia de réplica Una vez creada su instancia de réplica de Amazon Connect, deberá configurarla: 1. Garantice la redundancia de las integraciones frontend y backend (por ejemplo, SSO, Lambda o Lex) entre regiones. 1. Realice actualizaciones manuales de coincidencia en las instancias vinculadas. 1. Utilice la [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API para asociar los agentes al grupo de distribución de tráfico predeterminado. Para poder asociar los agentes a un grupo de distribución de tráfico, deben estar presentes tanto en la instancia de origen como en la de réplica. No puede asociar usuarios a un grupo de distribución de tráfico cuando se han agregado recientemente a la instancia de origen y aún no están en la réplica. ## Cuándo ponerse en contacto con AWS Support Ponte en contacto con AWS Support para obtener ayuda con las siguientes actividades: + Para entender el estado de la duplicación más allá de lo que está disponible en los CloudTrail registros y la pista de auditoría del sitio web de Amazon Connect administración. ## ¿Por qué falla una llamada ReplicateInstance Se produce un error en una llamada a la [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API y se produce un error `InvalidRequestException` en los siguientes casos: 1. La Región en la que está creando la réplica es la misma que la de su instancia existente. 1. La instancia ya estaba replicada como parte de una llamada a la [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API diferente. 1. La instancia no tiene ningún alias. 1. La instancia no se encuentra en estado `ACTIVE`. 1. La instancia no tiene SAML habilitado. 1. Hay un conflicto de nombres de recurso. ## Cómo encontrar la región de origen de sus instancias de Amazon Connect Si olvida cuál es la región de origen de sus instancias de Amazon Connect, realice los pasos siguientes para encontrarla: 1. Llama a la [ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html)API con tu. `InstanceId` 1. Para cualquier grupo de distribución de tráfico de la lista de respuesta, el `InstanceARN` devuelto incluye la región de origen. Por ejemplo, en el siguiente ARN, *source-region* sería la región de su instancia de Amazon Connect. `arn:aws:connect:source-region:account-id:traffic-distribution-group/ traffic-distribution-group-id` # Creación de grupos de distribución de tráfico para su instancia de Amazon Connect Puede crear un grupo de distribución de tráfico para su instancia de Amazon Connect existente mediante la [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API. Un *grupo de distribución de tráfico* es un recurso de Amazon Connect que permite vincular instancias de Amazon Connect que se encuentran en diferentes Regiones de AWS. Los números de teléfono pueden asociarse al grupo de distribución de tráfico. El tráfico hacia estos números puede distribuirse entre las instancias del grupo de distribución de tráfico. ## Cosas importantes que debe saber + Al crear un grupo de distribución de tráfico, debe crearse en la Región de AWS de origen. Una *región de origen* es la región donde se configura la instancia de Amazon Connect existente. + Al asociar números de teléfono a un grupo de distribución de tráfico: + Solo puede asociar los números de teléfono solicitados para la región de origen. + El número de teléfono debe estar en la misma región en la que se creó el grupo de distribución de tráfico. + Puede solicitar números a un grupo de distribución de tráfico u obtener o actualizar la distribución de tráfico para un grupo de distribución de tráfico solo cuando su `Status` es `ACTIVE`. Utilice la [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API para determinar si se ha creado correctamente (`Status`debe serlo`ACTIVE`). + Al crear una instancia de Amazon Connect de réplica, se crea para ella un grupo de distribución de tráfico predeterminado. El grupo de distribución de tráfico predeterminado es el único grupo de distribución de tráfico en el que puede cambiar la distribución de `SignInConfig`. Consulte el `IsDefault` parámetro en el tipo [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html)de datos. Utilice `SignInConfig` para elegir los servidores de inicio de sesión backend a fin de facilitar al agente el inicio de sesión en su instancia de Amazon Connect. Por ejemplo, si llama `UpdateTrafficDistribution` con un `SignInConfig` modificado y un `TrafficDistributionGroup` no predeterminado, se devuelve un `InvalidRequestException`. ## Estados de los grupos de distribución de tráfico A continuación, se describen los estados de los grupos de distribución de tráfico: + `CREATION_IN_PROGRESS`: la creación del grupo de distribución de tráfico está en curso. + `ACTIVE`: se ha creado el grupo de distribución de tráfico. + `CREATION_FAILED`: se ha producido un error en la creación del grupo de distribución de tráfico. + `PENDING_DELETION`: la eliminación del grupo de distribución de tráfico está en curso. + `DELETION_FAILED`: se ha producido un error en la eliminación del grupo de distribución de tráfico. + `UPDATE_IN_PROGRESS`: la actualización del grupo de distribución de tráfico está en curso. ## Por qué falla una CreateTrafficDistributionGroup llamada Se produce un error en una llamada a la [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API y se produce un error `InvalidRequestException` en los siguientes casos: + No se llamó a la [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API antes de crear un grupo de distribución de tráfico para las instancias vinculadas. + No se llamó a la [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API en la misma región en la que se llamó a la [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API. La región a la que se llama a esta API debe coincidir con la región de la instancia que se utilizó para crear una réplica. # Cómo solicitar números de teléfono para grupos de distribución de tráfico con Amazon Connect **nota** **¿Usuario nuevo?** Consulte el taller [Amazon Connect Global Resiliency Workshop](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Este curso en línea lo guía a través del proceso de incorporación y prueba de la conmutación por error de números de teléfono y agentes utilizando nuevos APIs a través de la AWS CLI. La resiliencia global solo está disponible para las instancias de Amazon Connect creadas en las siguientes AWS regiones: EE. UU. Este (Virginia del Norte), EE. UU. Oeste (Oregón), Asia Pacífico (Osaka), Asia Pacífico (Tokio), Europa (Fráncfort) y Europa (Londres). Solo puede crear una réplica en la región Este de EE. UU. (Norte de Virginia), si su origen es Oeste de EE. UU. (Oregón) o al revés. Solo puede crear una réplica en la región de Europa (Fráncfort) si su origen es Europa (Londres) o viceversa. Solo puede crear una réplica en la región de Asia-Pacífico (Osaka) si su origen es Asia-Pacífico (Tokio). Para obtener acceso a esta característica, contacte con su arquitecto de soluciones o administrador técnico de cuentas de Amazon Connect. Una vez que su grupo de distribución de tráfico se haya creado correctamente (`Status`es`ACTIVE`), puede utilizarlo [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)para buscar los números de teléfono disponibles y [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)reclamarlos. Antes de solicitar un número de teléfono para tu grupo de distribución de tráfico, te recomendamos que [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)utilices la API para comprobar el estado del grupo de distribución de tráfico`ACTIVE`. Asignar un número de teléfono a un grupo de distribución de tráfico que no tiene el estado `ACTIVE` da como resultado `ResourceNotFoundException`. Para solicitar un número de teléfono a un grupo de distribución de tráfico, proporciona el ARN del grupo de distribución de tráfico en el **TargetArn**parámetro al llamar a la [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API. También puedes usar la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API para asignar un número de teléfono previamente reclamado a una instancia a un grupo de distribución de tráfico. **nota** Para actualizar el campo **Descripción**, debe utilizar la consola de Amazon Connect. ## Ejemplo de flujo de trabajo A continuación, se muestra un ejemplo de flujo de trabajo para solicitar números de teléfono y utilizarlos en varias Regiones de AWS: 1. Cree una réplica de su instancia: 1. Llame a la API [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html). 1. Cree un grupo de distribución de tráfico que vincule estas instancias: 1. Llame a la API [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html). 1. Busque números de teléfono disponibles que puedan solicitarse para su grupo de distribución de tráfico: 1. Llama a la [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API de la región en la que se creó el grupo de distribución de tráfico. Proporcione el ARN de grupo de distribución de tráfico para el parámetro `TargetArn`. 1. En la región en la que se creó el grupo de distribución de tráfico, llama a la [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API: 1. Proporcione el ARN de grupo de distribución de tráfico para el parámetro `TargetArn`. 1. Proporcione el valor del número de teléfono E164 que devolvió la llamada a la [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API en el paso 3. Se devuelven `PhoneNumberId` y `PhoneNumberArn`. Puede utilizar estos valores para las operaciones de seguimiento. 1. Compruebe que el estado del número de teléfono es `CLAIMED`: 1. Llame a la API [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html). (también se DescribePhoneNumber puede llamar en la otra región asociada al grupo de distribución de tráfico. Devolverá los mismos detalles del número de teléfono). El número de teléfono puede utilizarse mediante operaciones de seguimiento solo después de que su estado sea `CLAIMED`. Para obtener una descripción de los posibles estados, consulte [Definición de los estados de número de teléfono](#claim-phone-number-status). 1. Repita los pasos del 3 al 5 para todos los números de teléfono que necesite solicitar para su grupo de distribución de tráfico. 1. Realice los siguientes pasos para asociar flujos a números de teléfono. Hágalos en las dos regiones en las que opera el grupo de distribución de tráfico. Estos pasos garantizan que el tráfico de telefonía se enrute correctamente hacia sus flujos para admitir su configuración de distribución de tráfico. 1. En su instancia de Amazon Connect existente en la región en la que se creó el grupo de distribución de tráfico, realice los pasos siguientes: 1. Llame a [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)la API. Proporcione el `InstanceId` que corresponda a la instancia que se ha replicado. 1. Se devuelve una lista ARNs de flujos. Utilice estos flujos ARNs para asociar un flujo a un número de teléfono; llame a la [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API. 1. En la instancia de Amazon Connect replicada en la otra AWS región, lleve a cabo los siguientes pasos: 1. Llame a la [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API. Proporcione el `InstanceId` que corresponda a la instancia que se ha replicado. 1. Se devuelve una lista ARNs de flujos. Utilice estos flujos ARNs para asociar un flujo a un número de teléfono; llame a la [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API. ## ¿Por qué falla una ClaimPhoneNumber llamada [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)La llamada a la API fallará con un `ResourceNotFoundException` en los siguientes casos: + El grupo de distribución de tráfico especificado no existe, el estado del grupo de distribución de tráfico no es `ACTIVE` o usted no tiene la propiedad del grupo de distribución de tráfico. + El número de teléfono no está disponible para realizar una solicitud. En algunos casos, un número de teléfono encontrado [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)puede haber sido reclamado por otro cliente. [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)fallará y se producirá un `InvalidParameterException` error en el siguiente caso: + El punto de conexión al que llama no se encuentra en la misma región en la que se creó el grupo de distribución de tráfico. ## Definición de los estados de número de teléfono A continuación, se describen los estados de número de teléfono: + `CLAIMED`significa que la operación anterior [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)o la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)operación se realizó correctamente. + `IN_PROGRESS`significa que [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html), [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)la operación aún está en curso y aún no se ha completado. Puede llamar [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)más adelante para comprobar si la operación anterior se ha completado. + `FAILED`indica que la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)operación [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)o operación anterior ha fallado. Incluye un mensaje que indica el motivo del error. Un motivo habitual de error es que el valor de `TargetArn` del que está solicitando o actualizando un número de teléfono haya alcanzado su límite de números totales solicitados. Si ha recibido un estado `FAILED` de una llamada a la API `ClaimPhoneNumber`, dispone de un día para volver a intentar solicitar el número de teléfono antes de que el número se devuelva al inventario para que otros clientes lo soliciten. # Asignación de números de teléfono solicitados a grupos de distribución de tráfico en Amazon Connect + Ha creado un nuevo grupo de distribución de tráfico y su estado es `ACTIVE`. Recomendamos usar la [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API para verificar el estado. + Ya ha solicitado números de teléfono a instancias u otros grupos de distribución de tráfico. Ahora puedes asignar esos números de teléfono reclamados a tu nuevo grupo de distribución de tráfico mediante la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API. Proporcione el ARN de grupo de distribución de tráfico en el parámetro `TargetArn`. **nota** Para actualizar el campo **Descripción**, debe utilizar la consola de Amazon Connect. ## Ejemplo de flujo de trabajo A continuación, se muestra un flujo de trabajo de ejemplo para asignar números de teléfono solicitados a su grupo de distribución de tráfico: 1. Llama a la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API para asignar el número de teléfono a uno nuevo`TargetArn`. `TargetArn` puede ser para otra instancia de Amazon Connect o para un grupo de distribución de tráfico creado en la misma región en la que se solicitó inicialmente el número de teléfono. 1. Realice los siguientes pasos para asociar flujos a números de teléfono. Estos pasos garantizan que el tráfico de telefonía se enrute correctamente hacia sus flujos para admitir su configuración de distribución de tráfico. 1. En su instancia de Amazon Connect existente en la región en la que se creó el grupo de distribución de tráfico, realice los pasos siguientes: 1. Llame a la API [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html). Proporcione el `InstanceId` que corresponda a la instancia que se ha replicado. 1. Se devuelve una lista ARNs de flujos. Utilice estos flujos ARNs para asociar un flujo a un número de teléfono; llame a la [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API. La asociación entre el número de teléfono y el flujo se reflejará entre las instancias de Amazon Connect de todas AWS las regiones. ## ¿Por qué falla una llamada AssociatePhoneNumberContactFlow Si el número se reclama a un grupo de distribución de tráfico y llamas [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)mediante una instancia en la que se creó el Región de AWS grupo de distribución de tráfico, puedes usar un número de teléfono completo (ARN) o un valor UUID para el parámetro de solicitud de `PhoneNumberId` URI. Sin embargo, si el número se reclama a un grupo de distribución de tráfico y llamas a esta API mediante una instancia de la réplica Región de AWS asociada al grupo de distribución de tráfico, debes proporcionar un número de teléfono completo (ARN). Si se proporciona un UUID en este escenario, recibirá un `ResourceNotFoundException`. ## ¿Por qué falla una UpdatePhoneNumber llamada? [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)La llamada a la API fallará con un `ResourceNotFoundException` en los siguientes casos: + El grupo de distribución de tráfico especificado no existe, el estado del grupo de distribución de tráfico no es `ACTIVE` o usted no tiene la propiedad del grupo de distribución de tráfico. [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)fallará y se producirá un `InvalidParameterException` error en el siguiente caso: + El punto de conexión al que llama no se encuentra en la misma región en la que se creó el grupo de distribución de tráfico. ## Definición de los estados de número de teléfono A continuación, se describen los estados de número de teléfono: + `CLAIMED`significa que la operación anterior [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)o la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)operación se realizó correctamente. + `IN_PROGRESS`significa que [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html), [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)la operación aún está en curso y aún no se ha completado. Puede llamar [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)más adelante para comprobar si la operación anterior se ha completado. + `FAILED`indica que la [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)operación [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)o operación anterior ha fallado. Incluye un mensaje que indica el motivo del error. Un motivo habitual de error es que el valor de `TargetArn` del que está solicitando o actualizando un número de teléfono haya alcanzado su límite de números totales solicitados. # Actualice la distribución del tráfico de telefonía entre las instancias de Amazon Connect y Regiones de AWS La [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API se utiliza para distribuir el tráfico de telefonía y [los agentes de turno](update-agents-across-regions.md) entre las regiones. **nota** Cuando cambias el tráfico de telefonía, también cambias los and/or registros de los agentes para asegurarte de que pueden gestionar las llamadas en la otra región. Si no cambia los agentes, las llamadas de voz se enviarán a la región cambiada, pero no habrá ningún agente disponible para recibirlas. Una vez que hayas reclamado los números de teléfono de tu grupo de distribución de tráfico, puedes usar la [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API para distribuir los contactos de voz entrantes entre las instancias vinculadas de un grupo de distribución de tráfico determinado en incrementos del 10%. Si no se cumplen los siguientes requisitos, la llamada a la [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API fallará y mostrará un error: `InvalidRequestException` + Debe proporcionar la distribución para la configuración del tráfico de telefonía. + Debe especificar la distribución del tráfico para las dos instancias vinculadas y la distribución total debe sumar 100 %. + Debe especificar la distribución de tráfico en incrementos del 10 %. + La instancia ARNs especificada en la configuración de telefonía debe coincidir con ARNs las instancias vinculadas. 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. # Configuración de la experiencia del agente con Resiliencia global de Amazon Connect Resiliencia global de Amazon Connect le permite ofrecer una experiencia global a los agentes gracias al inicio de sesión global, la API de distribución de agentes y las mejoras de Agent Workspace. Con este conjunto de características, puede: + Habilitar a sus agentes para que inicien sesión una vez al comienzo de su jornada y procesen los contactos de su región activa actual sin necesidad de saber qué región está activa en cada momento. + Agregar agentes a su grupo de distribución de tráfico y distribuir agentes entre las regiones de AWS. + Redirigir los nuevos contactos de voz entrantes al espacio de trabajo del agente para la región activa con una simple actualización de página. **Topics** + [Integración del IdP con un punto de conexión de inicio de sesión de SAML de Resiliencia global de Amazon Connect](integrate-idp.md) + [Asocie agentes a instancias de varias AWS regiones](associate-agents-across-regions.md) + [Actualización de la distribución de agentes entre regiones](update-agents-across-regions.md) + [Configuración del espacio de trabajo de agente](setup-agentworkspace-switchover.md) + [Consejos para evitar problemas al trasladar agentes entre regiones](possible-issues-shifting-regions.md) # Integración del proveedor de identidades (IdP) con un punto de conexión de inicio de sesión de SAML de Resiliencia global de Amazon Connect Para permitir que sus agentes inicien sesión una vez e inicien sesión en ambas AWS regiones para procesar los contactos de la región activa actual, debe configurar los ajustes de IAM para utilizar el punto final de inicio de sesión global SAML. ## Antes de empezar Debe habilitar SAML para su instancia de Amazon Connect a fin de utilizar Resiliencia global de Amazon Connect. Para obtener más información sobre cómo empezar a utilizar la federación de IAM, consulte [Concesión de acceso a la Consola de administración de AWS a los usuarios federados SAML 2.0](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-saml.html). ## Cosas importantes que debe saber + La conmutación por error del agente solo se admite cuando se utiliza el terminal de inicio de sesión global. + Para realizar los pasos de este tema, necesitará su ID de instancia. Para obtener instrucciones sobre cómo encontrarlo, consulte [Búsqueda del ARN o del ID de instancia de Amazon Connect](find-instance-arn.md). + También necesitará conocer la región de origen de sus instancias de Amazon Connect. Para obtener instrucciones sobre cómo encontrarlo, consulte [Cómo encontrar la región de origen de sus instancias de Amazon Connect](create-replica-connect-instance.md#how-to-find-source-region-of-instances). + Si va a incrustar su aplicación de Connect en un iframe, debe asegurarse de que su dominio esté presente en la lista de orígenes aprobados tanto en la instancia de origen como en la de réplica para que funcione el inicio de sesión global. Para configurar Orígenes aprobados en la instancia, siga los pasos que se indican en [Uso de una lista de permitidos para aplicaciones integradas en Amazon Connect](app-integration.md). + Los agentes deben estar ya creados en *ambas* instancias de Amazon Connect de origen y de réplica y tener el mismo nombre de usuario que el nombre de sesión del rol de su proveedor de identidades (IdP). De lo contrario, recibirá una excepción `UserNotOnboardedException` y se arriesgará a perder la capacidad de redundancia de agentes entre sus instancias. + Debe asociar los agentes a un grupo de distribución de tráfico antes de que los agentes intenten iniciar sesión. De lo contrario, se producirá un error `ResourceNotFoundException` en el inicio de sesión del agente. Para obtener información sobre cómo configurar sus grupos de distribución de tráfico y asociarles agentes, consulte [Asocie agentes a instancias de Amazon Connect en varias AWS regiones](associate-agents-across-regions.md). + Cuando sus agentes se federan en Amazon Connect con la nueva URL de inicio de sesión de SAML, Resiliencia global de Amazon Connect siempre intenta iniciar la sesión del agente en sus regiones o instancias de origen y réplica, independientemente de cómo `SignInConfig` esté configurado en su grupo de distribución de tráfico. Puede comprobarlo CloudTrail consultando los registros. + La `SignInConfig` distribución en el grupo de distribución de tráfico predeterminado solo determina cuál Región de AWS se utiliza para facilitar el inicio de sesión. Independientemente de cómo esté configurada su distribución de `SignInConfig`, Amazon Connect siempre intenta registrar agentes en ambas regiones de su instancia de Amazon Connect. + Tras replicar una instancia de Amazon Connect, solo se genera un punto de conexión de inicio de sesión de SAML para sus instancias. Este punto final siempre contiene la fuente Región de AWS en la URL. + No es necesario configurar un estado de retransmisión cuando se utiliza la URL de inicio de sesión de SAML personalizada con Resiliencia global de Amazon Connect. ## Cómo integrar su proveedor de identidades 1. Al crear una réplica de la instancia de Amazon Connect mediante la [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API, se genera una URL de inicio de sesión SAML personalizada para las instancias de Amazon Connect. La URL se genera con el siguiente formato: `https://instance-id.source-region.sign-in.connect.aws/saml` 1. *instance-id*es el ID de instancia de cualquiera de las instancias de tu grupo de instancias. El ID de instancia es idéntico en las regiones de origen y de réplica. 1. *source-region*corresponde a la AWS región de origen en la que se llamó a la [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API. 1. Agregue la siguiente política de confianza a su rol de federación de IAM. Utilice la URL del punto de conexión de SAML de inicio de sesión global como se muestra en el siguiente ejemplo. ------ #### [ 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` es el recurso del proveedor de identidades creado en IAM. 1. Conceda acceso a `connect:GetFederationToken` para su `InstanceId` en su rol de federación de IAM. Por ejemplo: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "GetFederationTokenAccess", "Effect": "Allow", "Action": "connect:GetFederationToken", "Resource": "*", "Condition": { "StringEquals": { "connect:InstanceId": "your-instance-id" } } } ] } ``` ------ 1. Agregue una asignación de atributos a su aplicación de proveedor de identidades mediante las siguientes cadenas de atributos y valores. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/integrate-idp.html) 1. Configure la URL del servicio de consumidor de aserción (ACS) de su proveedor de identidades para que apunte a su URL de inicio de sesión de SAML personalizada. Utilice el siguiente ejemplo para la URL de 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. Establezca los siguientes campos en los parámetros de URL: + `instanceId`: el identificador de la instancia de Amazon Connect. Para obtener instrucciones sobre cómo encontrar el ID de instancia, consulte [Búsqueda del ARN o del ID de instancia de Amazon Connect](find-instance-arn.md). + `accountId`: el ID de AWS cuenta en el que se encuentran las instancias de Amazon Connect. + `role`: establézcalo al nombre o al nombre de recurso de Amazon (ARN) del rol de SAML utilizado para la federación de Amazon Connect. + `idp`: establézcalo al nombre o nombre de recurso de Amazon (ARN) del proveedor de identidades de SAML en IAM. + `destination`: establézcalo a la ruta opcional a la que llegarán los agentes a la instancia después de iniciar sesión (por ejemplo: `/agent-app-v2`). # Asocie agentes a instancias de Amazon Connect en varias AWS regiones Para permitir que sus agentes inicien sesión en ambas regiones Regiones de AWS y procesen los contactos de cualquiera de ellas, primero debe asignarlos a un grupo de distribución de tráfico. 1. Si aún no ha establecido un grupo de distribución de tráfico, hágalo ahora. Para obtener instrucciones, consulte [Creación de grupos de distribución de tráfico para su instancia de Amazon Connect](setup-traffic-distribution-groups.md). 1. Una vez creado correctamente su grupo de distribución de tráfico (`Status` es `ACTIVE`), puede asignarle agentes. Asocie siempre a los usuarios a un grupo de distribución de tráfico en la región de origen. La asignación de un agente a un grupo de distribución de tráfico sin un estado `ACTIVE` da como resultado `ResourceNotFoundException`. Utilice la [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API para determinar si se ha creado correctamente (`Status`debe serlo`ACTIVE`). 1. Puede asignar un agente a un grupo de distribución de tráfico llamando a la [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API. ## Ejemplos El siguiente comando de `associate-traffic-distribution-group-user` ejemplo muestra cómo se pueden asociar los agentes a varias AWS regiones y utilizarlos en ellas. ``` aws connect associate-traffic-distribution-group-user --traffic-distribution-group-id UUID --user-id UUID --instance-id ``` El siguiente [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)ejemplo asocia un agente a un grupo de distribución de tráfico. ``` PUT /traffic-distribution-group/trafficDistributionGroupId/user HTTP/1.1 Content-type: application/json { "UserId": "string" } ``` El siguiente ejemplo de `disassociate-traffic-distribution-group-user` desasocia un agente de un grupo de distribución de tráfico. ``` aws connect disassociate-traffic-distribution-group-user --instance-id your instance ID --traffic-distribution-group-id UUID --user-id UUID ``` El siguiente [DisassociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_DisassociateTrafficDistributionGroupUser.html)ejemplo desasocia a un agente de un grupo de distribución de tráfico. ``` DELETE /traffic-distribution-group/trafficDistributionGroupId/user/UserId HTTP/1.1 ``` ## Por qué se produce un error en una AssociateTrafficDistributionGroupUser llamada Se produce un error en una llamada a la [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API y se produce un error `ResourceNotFoundException` en los siguientes casos: 1. El grupo de distribución de tráfico especificado no existe. 1. El estado del grupo de distribución de tráfico no es `ACTIVE`. 1. El `user-id UUID` no es un usuario de la instancia de Amazon Connect de origen. # Actualiza la distribución de los agentes en tu espacio de trabajo de agentes de Amazon Connect en todas AWS las regiones Del mismo modo que puede utilizar la API de `UpdateTrafficDistribution` para [distribuir el tráfico de telefonía entre regiones](update-telephony-traffic-distribution.md), 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, puede mantener el 40% de los agentes en una AWS región para completar los contactos activos y trasladar los agentes restantes a la región de réplica. **nota** Cuando cambies el tráfico de telefonía, cambia también los inicios de sesión de los and/or agentes para garantizar que puedan gestionar las llamadas en la otra región. Si no cambia los agentes, las llamadas de voz se enviarán a la región cambiada, pero no habrá ningún agente disponible para recibirlas. Una vez que haya agregado agentes a su grupo de distribución de tráfico, utilice la [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API 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 [Configure Amazon Connect Agent Workspace para ayudar a los agentes que se desplazan de una AWS región a otra](setup-agentworkspace-switchover.md). **Topics** + [Requisitos](#update-agent-traffic-distribution-requirements) + [Activación de ambas regiones durante las operaciones habituales](#change-signin-weights) + [¿Cómo transferir todo el tráfico y los agentes de telefonía de una AWS región a otra](#shift-all-traffic) + [Banner de interfaz de usuario del conmutador regional](#regional-switch-ui-banner) ## Requisitos Si no se cumplen los siguientes requisitos, la llamada a la [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API fallará y mostrará un `InvalidRequestException` error: 1. El grupo de distribución de tráfico especificado debe existir. 1. El estado del grupo de distribución de tráfico debe ser `ACTIVE`. 1. 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 `IsDefault` parámetro en el tipo [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html)de datos. 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. ## Habilite ambos Regiones de AWS durante las operaciones normales 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 disfrutar de la mejor experiencia, te recomendamos tener ambas AWS regiones habilitadas durante las operaciones normales. Para lograrlo, pase `true` a ambas distribuciones de `SignInConfig`. Si necesita trasladar todo su tráfico de telefonía y sus agentes a una sola AWS región, le recomendamos que lo cambie `SignInConfig` a `false` la región desde la que vaya a transferir 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 transferir todo el tráfico y los agentes de telefonía de una AWS región a otra 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. ## Banner de interfaz de usuario del conmutador regional Agent Workspace y CCP proporcionarán un banner en la interfaz de usuario que destaque el cambio de región. Si un agente se encuentra **en un contacto** y su región cambia debido a los ajustes del grupo de distribución del tráfico (TDG), verá un banner similar al que se muestra a continuación. Cuando complete el contacto de voz y cierre el estado de la ACW, el agente se actualizará automáticamente a la nueva región, sin necesidad de realizar ninguna acción. Si el agente tiene problemas para cerrar el contacto, puede seleccionar **Continuar en Backup** y aparecerá una ventana emergente solicitando confirmación para cambiar a la región alternativa. Le recomendamos que modifique su manual de instrucciones y su guía de formación de agentes para reflejar esta situación ![\[La interfaz de usuario de Agent Workspace muestra un banner que destaca la conmutación por error regional durante los ajustes de TDG.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/acgr-failover-banner.png) ![\[La ventana emergente de confirmación que aparece cuando un agente selecciona Continuar en Backup.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/acgr-failover-confirmation.png) # Configure Amazon Connect Agent Workspace para ayudar a los agentes que se desplazan de una AWS región a otra Realice los siguientes pasos para permitir que Amazon Connect Agent Workspace integre el panel de control de contactos de la AWS región de réplica a la región de origen y cambie de una región a otra a medida que cambie la región activa del agente. Si aún no ha creado una réplica de su instancia de Amazon Connect de origen ni ha configurado un grupo de distribución de tráfico, consulte [Introducción a la Resiliencia global de Amazon Connect](get-started-connect-global-resiliency.md). 1. Ve a la consola de AWS Amazon Connect para recuperar la **URL de acceso** de tu instancia de origen. Anote la URL. 1. En la región de réplica, la consola AWS Amazon Connect para recuperar la **URL de acceso** de la instancia de réplica. Anote la URL. 1. En la misma ventana de su instancia de réplica de Amazon Connect, en el panel izquierdo, elija **Orígenes aprobados**. 1. Agregue el dominio para la **URL de acceso** de la instancia de origen, que anotó en el paso 1. **nota** No incluya un carácter **/** final en la URL de acceso. 1. Repita los pasos anteriores en su instancia de origen: vaya a **Orígenes aprobados** y agregue la URL de acceso para la instancia de réplica. **nota** Los agentes deben establecer su estado en **Disponible** después de desplazarlos entre regiones. # Consejos para evitar problemas al trasladar agentes entre regiones de Amazon Connect + Siempre que actualice la distribución del tráfico para los agentes, asegúrese de actualizar también la distribución del tráfico para los contactos de voz entrantes. De lo contrario, podría encontrarse en una situación en la que una región está sobrecargada de agentes mientras que la otra lo está de tráfico de telefonía. + Antes de asociar agentes a un grupo de distribución de tráfico, asegúrese de que exista el mismo nombre de usuario en las instancias de Amazon Connect tanto de origen como de réplica. De lo contrario, cuando asocie un usuario a un grupo de distribución de tráfico, pero el usuario con el nombre de usuario no exista en la región de réplica, obtendrá un error `InvalidRequestException`. + Debe llamar a la [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API para asociar los agentes a un grupo de distribución de tráfico en la región de origen. Si intenta hacerlo mientras se encuentra en la región de réplica, recibirá un error `ResourceNotFoundException`.