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.
# Configuración de Resiliencia global de 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.
**importante**
Amazon Connect Global Resiliency (ACGR) es la única solución AWS compatible para la resiliencia multirregional en Amazon Connect. AWS no admite alternativas personalizadas o de terceros para lograr una resiliencia global. La implementación de soluciones no compatibles puede provocar la denegación o la reducción de los límites de servicio en la instancia secundaria y podría afectar a la cobertura del SLA si el tiempo de inactividad se atribuye a la implementación no compatible.
Resiliencia global de Amazon Connect le permite ofrecer un servicio de atención al cliente en cualquier lugar del mundo con la máxima fiabilidad, rendimiento y eficacia. Con sus características de telefonía distribuida, su centro de contacto puede cumplir los requisitos normativos internacionales.
Amazon Connect Global Resiliency proporciona un conjunto APIs que puede utilizar para:
+ Aprovisione una instancia de Amazon Connect vinculada en otra Región de AWS.
+ Aprovisionar y administrar números de teléfono globales y accesibles en ambas regiones.
+ Distribuir el tráfico de telefonía y los agentes entre las instancias de Amazon Connect y las regiones en incrementos del 10 % o cambiarlos todos a la vez. Esto le permite cambiar lentamente los contactos de voz entrantes y los agentes de una región a otra o cambiarlos todos al mismo tiempo.
Por ejemplo, puede distribuir los contactos de voz entrantes y los agentes al 100 % en Este de EE. UU. (Norte de Virginia) y al 0 % en Oeste de EE. UU. (Oregón), o bien al 50 % en cada región.
+ Acceder a la capacidad reservada entre regiones.
**Topics**
+ [Requisitos de resiliencia global](connect-global-resiliency-requirements.md)
+ [Introducción](get-started-connect-global-resiliency.md)
+ [Administración de grupos de distribución de tráfico](manage-traffic-distribution-groups.md)
+ [Administración de números de teléfono entre regiones](manage-phone-numbers-across-regions.md)
+ [Administración del chat entre regiones](manage-chat-across-regions.md)
+ [Métricas, informes y búsquedas en todas las regiones de ACGR](metrics-reports-and-search-across-acgr-regions.md)
# Requisitos de Resiliencia global de Amazon Connect
Si ha decidido que Resiliencia global de Amazon Connect es la implementación adecuada para usted, asegúrese de cumplir los siguientes requisitos previos antes de la incorporación:
+ [Transfiera](about-porting.md) a Amazon Connect todos los números de teléfono que desee habilitar para que sean multirregionales.
+ AWS Se necesita Enterprise Support o AWS Unified Operations para incorporarse a Amazon Connect Global Resiliency. Para obtener más información sobre los planes de AWS Support, consulte [AWS Support Plans](https://aws.amazon.com/premiumsupport/plans/).
+ Debe tener una instancia de Amazon Connect de producción compatible con [SAML 2.0](connect-identity-management.md) en una región en la que esté disponible Resiliencia global de Amazon Connect. Para confirmarlo, consulte [Disponibilidad de resiliencia global por región](regions.md#gr_region).
+ Se recomienda incorporar y probar los servicios de Resiliencia global de Amazon Connect en un entorno de prueba antes de incorporar el tráfico de producción.
+ Solicite que TODAS las cuotas de servicio de la instancia de réplica coincidan con las cuotas de servicio de la instancia de origen: [cree un caso de aumento de la cuota de servicio](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) en AWS Management Console > Support.
+ Asegúrese de que sus funciones Lambda en todas AWS las regiones tengan el mismo nombre.
+ Actualice sus flujos para reemplazar cualquier región codificada con un parámetro `$.AwsRegion` o `$['AwsRegion']`.
**nota**
En el bloque [Función de AWS Lambda ](invoke-lambda-function-block.md), `$.AwsRegion` no está permitido en el flowArn.
Para usar `$.AwsRegion`, debe utilizar un bloque [Establecer atributos de contacto](set-contact-attributes.md) para configurar el flujo, por ejemplo:
`flowIdKey` : `arn:aws:connect:$.AwsRegion:123456789012:instance/12345678-1234-1234-1234-123456789012/contact-flow/12345678-1234-1234-1234-123456789012`
Luego, puede usar esa clave de atributo en el bloque [Función de AWS Lambda ](invoke-lambda-function-block.md) como `${flowIdKey}`.
`$.AwsRegion` solo es compatible con Lambda ARN y Lex ARN.
+ En el caso de los bots de Amazon Lex, puede hacer una de las siguientes acciones:
+ Utilice Amazon Lex Global Resiliency para replicar los bots en todas AWS las regiones y conservar el ID del bot.
+ Cambie sus flujos a sucursales 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)
# 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`.
# Gestione los grupos de distribución de tráfico mediante Amazon Connect APIs
En los temas de esta sección se describe cómo gestionar los grupos de distribución de tráfico mediante Amazon Connect APIs.
**Topics**
+ [Enumeración de grupos de distribución de tráfico](list-traffic-distribution-groups.md)
+ [Eliminación de grupos de distribución de tráfico](delete-traffic-distribution-groups.md)
# Enumeración de grupos de distribución de tráfico
Usa la [ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html)API para enumerar todos los grupos de distribución de tráfico.
Es posible que desee enumerar los grupos de distribución de tráfico para determinar si una instancia de Amazon Connect concreta forma parte de algún grupo de distribución de tráfico.
# Eliminación de grupos de distribución de tráfico en Amazon Connect
Usa la [DeleteTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html)API para eliminar un grupo de distribución de tráfico que ya no sea necesario.
**nota**
No puede eliminar un grupo de distribución de tráfico si los números de teléfono están solicitados para él. Primero debes publicar los números de teléfono del grupo de distribución de tráfico mediante la [ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html)API. Después, podrá eliminar el grupo de distribución de tráfico.
No puede liberar números de un grupo de distribución de tráfico mediante la consola de Amazon Connect.
Tu llamada a la [DeleteTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html)API fallará `ResourceInUseException` si los números de teléfono siguen siendo reclamados al grupo de distribución de tráfico.
# Gestione los números de teléfono de todas las regiones con Amazon Connect APIs
En los temas de esta sección se describe cómo administrar los números de teléfono Regiones de AWS mediante Amazon Connect APIs.
**Topics**
+ [Reclama los números de teléfono de las instancias de varias Regiones de AWS](claim-phone-number-multiple-regions.md)
+ [Mueva un número de teléfono reclamado a varias instancias Regiones de AWS](move-phone-number-multiple-regions.md)
+ [Liberación de números de los grupos de distribución de tráfico](release-numbers-traffic-distribution-group.md)
# Reclama números de teléfono a las instancias de Amazon Connect en múltiples instancias Regiones de 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 realizar o recibir llamadas a un número de teléfono en varias instancias Regiones de AWS, debe solicitar un número de teléfono a un grupo de distribución de tráfico.
**Para solicitar un número de teléfono para un grupo de distribución de tráfico**
1. Crea un grupo de distribución de tráfico mediante la [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API.
1. Describa su grupo de distribución de tráfico mediante 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. Una vez que tu grupo de distribución de tráfico `Status` se `ACTIVE` haya creado correctamente, puedes solicitar los números de teléfono del grupo mediante la [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API.
# Mover un número de teléfono reclamado a varias instancias de Amazon Connect Regiones de 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.
Puede trasladar un número de teléfono previamente solicitado para una instancia y, en su lugar, asignarlo a varias instancias entre Regiones de AWS. Para ello, asigne el número de teléfono a un grupo de distribución de tráfico.
**Para asignar un número de teléfono a un grupo de distribución de tráfico**
1. Cree un grupo de distribución de tráfico mediante la [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API.
1. Describa su grupo de distribución de tráfico mediante 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. Una vez creado correctamente su grupo de distribución de tráfico (`Status` es `ACTIVE`), puede asignar los números de teléfono solicitados para otras instancias u otros grupos de distribución de tráfico. Uso de la API de [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html).
# Liberación de números de teléfono de Amazon Connect de los grupos de distribución de tráfico
Para liberar números de teléfono de un grupo de distribución de tráfico, usa la [ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html)API. El número se devuelve al inventario para que otros clientes lo soliciten.
No puede liberar números de un grupo de distribución de tráfico mediante la consola de Amazon Connect.
# Administración del chat en su instancia de Amazon Connect entre regiones
Para administrar el chat en todas AWS las regiones, puede crear dos interfaces de chat personalizadas o dos widgets de out-of-the-box comunicación: uno en la región de origen y otro en la región de réplica. Puede cambiar entre ellas manualmente en función de la interfaz de chat o el widget de out-of-the-box comunicación de la región que desee utilizar.
+ Interfaces de chat personalizadas: configure la interfaz de chat en la región de réplica para usar el punto de conexión de la API de la región de réplica. Para ver ejemplos de interfaces personalizadas, consulte la [biblioteca de código abierto Amazon Connect](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master) en GitHub. Para obtener más información, consulte [Personalización del chat con el ejemplo de código abierto de Amazon Connect](download-chat-example.md).
+ Out-the-box widgets de comunicación: cree un widget de comunicación en la instancia réplica de Amazon Connect. Para obtener instrucciones, consulte [Configuración de un widget de comunicación en la instancia de réplica](#communicationswidget-multiple-regions).
A continuación, puede ver los parámetros de configuración del chat que se requieren en su sitio web o aplicación para iniciar un chat para el cliente:
+ **ID de instancia de Amazon Connect** e **ID de flujo**: estos parámetros son los mismos en las regiones de origen y réplica.
+ ** AWS Región de destino** y, por lo general, un **punto final de la API** para iniciar el chat (es decir, para adquirir el token del participante): estos parámetros son diferentes en las regiones de origen y de réplica.
Por ejemplo, en el siguiente diagrama se muestra cómo se debe actualizar la configuración del chat para que apunte a la API Gateway de la región de réplica cuando el tráfico del chat deba moverse entre regiones.
![\[Un diagrama que muestra la región de origen y la región de réplica.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/chatconfig.png)
## Configuración de un widget de comunicación en la instancia de réplica
1. En su instancia de Amazon Connect, cree un widget de comunicación para el chat si aún no existe ninguno. Para obtener instrucciones, consulte [Adición de una interfaz de usuario de chat al sitio web alojado en Amazon Connect](add-chat-to-website.md).
1. En su instancia de réplica, cree otro widget de comunicación para el chat. Configure el widget con el mismo flujo que se usa en el widget de la instancia de origen. El flujo ya está en la instancia de réplica porque Resiliencia global de Amazon Connect copia todos los flujos del origen a la réplica y los mantiene sincronizados de forma continua.
1. Copie el nuevo script del widget de comunicación que creó en la instancia de réplica. Inserte el script en el sitio web o la aplicación que debe activarse cuando el tráfico del chat se reenvíe a la instancia de réplica.
1. Para cambiar el tráfico entre regiones, sustituya el widget de comunicaciones de la instancia de origen por el widget de comunicaciones de la instancia de réplica en su página web.
En la siguiente imagen se muestra un ejemplo del script del widget.
![\[Un muestral del script del widget de comunicación.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/source-comwidget.png)
1. Si posteriormente realiza algún cambio en el widget de comunicación de la instancia de origen, también tendrá que realizar los mismos cambios en el widget de comunicación de la instancia de réplica.
## Opción para añadir más fluidez
Para que el traslado del tráfico de chat entre regiones sea más fluido y requiera menos cambios manuales, esta es otra forma de personalizar su experiencia de chat:
1. Añada un parámetro a una base de datos controlada de forma centralizada (por ejemplo, Tabla global de DynamoDB). El objetivo de este parámetro es definir qué región está activa actualmente.
1. Actualice su sitio web o aplicación para comprobar el estado del parámetro Región en la base de datos central.
1. Según la región que esté activa, el sitio web o la aplicación utilizarán el punto de conexión de la API o el widget de comunicación de esa región.
1. Este parámetro debe actualizarse al mismo tiempo que se llama a la [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API para transferir el tráfico de voz y los agentes de una región a otra, según proceda.
# Métricas, informes y búsquedas en las regiones de ACGR
En los temas de esta sección se describen las métricas, los informes y las búsquedas consolidados Regiones de AWS para los clientes de Amazon Connect Global Resiliency (ACGR).
**Topics**
+ [Búsqueda de contactos y datos de contacto](contact-search-and-contact-details.md)
+ [Métricas consolidadas en todas las regiones](consolidated-metrics-across-regions.md)
# Búsqueda de contactos y detalles de contacto
**importante**
Para habilitar la búsqueda de contactos consolidada para su instancia de ACGR, póngase en contacto con [AWS Support](https://console.aws.amazon.com/support/home).
**importante**
Cuando utilices esta función, tu alias de Amazon Connect se actualizará a un nuevo subdominio con ese formato`region.sourcealias.my.connect.aws`. Por ejemplo, si su instancia de ACGR está desplegada en EE.UU. Este (Norte de Virginia) y EE.UU. Oeste (Oregón) con un alias de origen configurado como `source.my.connect.aws` y un alias de réplica como`replica.my.connect.aws`, después de incorporar sus instancias de Amazon Connect a esta función, utilizará `us-east-1.source.my.connect.aws` y. `us-west-2.source.my.connect.aws` Asegúrese de actualizar las reglas de firewall y las integraciones de terceros para consumir estos nuevos subdominios.
Al acceder a la página de búsqueda de contactos, verá los contactos de las instancias de Amazon Connect Global Resiliency (ACGR) emparejadas de forma predeterminada, lo que le proporcionará una visión completa de las interacciones con los clientes en toda su organización. Esto proporciona una experiencia de búsqueda fluida, independientemente de la región de la que procedan los contactos o de la región en la que esté conectado actualmente.
+ **Región activa**: la región Región de AWS en la que se está procesando o se completó un contacto.
## Experiencia de búsqueda de contactos
### Filtro de región activa
Verás un nuevo filtro de «Región activa» en el menú desplegable de filtros. Esto te permite limitar tu búsqueda a una región específica cuando sea necesario.
Para usar el filtro de región activa:
1. En la **página de búsqueda de contactos**, selecciona **Añadir filtro**.
1. Selecciona **Región activa en** el menú desplegable.
1. Elige una o más regiones.
![\[El menú desplegable del filtro de región activa muestra las regiones disponibles para seleccionar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/active-region-filter.png)
### Filtros de recursos específicos de la región
Cuando utilizas los siguientes filtros, las opciones desplegables muestran solo los recursos que se crearon en la región en la que has iniciado sesión:
+ Atributos de contacto personalizados
+ Categorías de contactos
+ Filtros de evaluación
+ Dirección de correo electrónico
+ Atributos de segmentos de contactos personalizados
**importante**
Si escribe los valores de filtro manualmente en lugar de seleccionarlos de los menús desplegables y los nombres de esos recursos son idénticos en todas las instancias de ACGR, los resultados incluirán los contactos de ambas regiones.
Atributos de contacto personalizados
Dirección de correo electrónico
**Los filtros de evaluación** solo devuelven los contactos de su región actual, ya que buscan mediante un formulario de evaluación único IDs que es específico de la región.
### Búsquedas guardadas
Las búsquedas guardadas muestran los contactos de ambas instancias de ACGR. Todos los filtros de región guardados anteriormente seguirán funcionando según lo previsto.
## Datos de contacto: experiencia
### Visualización de la información de contacto
Al abrir una página de detalles de contacto, verá información completa independientemente de la región de la que provenga el contacto, que incluye:
+ Descripción general, detalles de conexión e información de cola
+ Etiquetas y atributos de contacto
+ Datos de lentes de contacto (análisis conversacional, transcripciones de voz, transcripciones de chat)
+ Grabaciones de pantalla y audio
+ Transcripciones de chat e interacciones de IVR
+ Archivos adjuntos y transcripciones de correo electrónico
La región activa del contacto se muestra en la página de detalles del contacto, en la sección Metadatos de **resiliencia global**.
![\[La página de detalles de contacto muestra la sección de metadatos sobre resiliencia global con la información de la región activa.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/global-resiliency-metadata.png)
**nota**
Si la región activa del contacto está dañada, es posible que parte de la información no esté disponible, como las grabaciones de pantalla y audio, las transcripciones de los chats, las interacciones por IVR, los archivos adjuntos y transcripciones de los correos electrónicos y los datos de la lente de contacto.
### Acceso a los datos de Contact Lens
Tiene acceso total a los datos de lentes de contacto de todas las regiones, que incluyen:
+ Contactos en curso: análisis de conversaciones, transcripciones de voz (redactadas y no redactadas) y transcripciones de chat.
+ Contactos completados: todos los análisis de las conversaciones, las transcripciones de voz (redactadas y no redactadas) y las transcripciones de los chats.
+ Grabaciones: se puede acceder a las grabaciones de pantalla y audio independientemente de la región activa del contacto.
+ Transcripciones: las transcripciones de chat, IVR y correo electrónico están disponibles en todas las regiones.
### Acciones de contacto
Puede realizar acciones de contacto como transferir, reprogramar o finalizar el contacto, independientemente de la región activa del contacto. Estas acciones se dirigen a la región activa del contacto.
### Evaluaciones de contacto
Las evaluaciones de contactos solo están disponibles para los contactos que están activos en la región en la que has iniciado sesión. No puede ver ni realizar evaluaciones de los contactos replicados de otras regiones.
### SearchContacts API
Si utilizas la SearchContacts API mediante programación, la respuesta incluye información adicional:
+ GlobalResiliencyMetadata objeto: contiene los `TrafficDistributionGroupId` campos `ActiveRegion``OriginRegion`, y para todos los contactos, que muestran la región específica en la que el contacto está activo.
Para obtener más información sobre la SearchContacts API, consulte la [referencia de la API de Amazon Connect](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchContacts.html).
# Métricas consolidadas en todas las regiones
**importante**
Para habilitar las métricas consolidadas de agentes y contactos para su instancia de ACGR, póngase en contacto con [AWS Support](https://console.aws.amazon.com/support/home).
Cuando consulta las estadísticas en Amazon Connect, verá una vista consolidada de las estadísticas de agentes y contactos de todas las regiones emparejadas, independientemente de la región en la que haya iniciado sesión actualmente.
Por ejemplo, si tiene 5 agentes que han iniciado sesión en us-east-1 y están disponibles BasicQueue para, y 10 agentes que han iniciado sesión en us-west-2 y están disponibles BasicQueue para, la página de métricas en tiempo real muestra un total de 15 agentes en línea. Esta vista consolidada le permite supervisar las operaciones de su centro de contacto desde una única interfaz.
## Métricas disponibles
La vista consolidada está disponible en:
+ Métricas en tiempo real: consulte las métricas actuales de la actividad de los agentes y de los contactos en todas sus instancias de ACGR.
+ Métricas históricas: acceda a los datos históricos de rendimiento en todas las instancias de ACGR.
+ Métricas APIs: las respuestas de la API devuelven métricas consolidadas en todas sus instancias de ACGR.
**nota**
Las métricas de agentes y contactos se consolidan en todas las regiones. Otras métricas, como los análisis, siguen siendo específicas de cada región.
Para obtener más información sobre los informes de Amazon Connect, consulte[Métricas, paneles e informes en Amazon Connect](amazon-connect-metrics.md).