Mettez à jour la répartition des agents dans votre espace de travail d'agent Amazon Connect entre AWS les régions - Amazon Connect

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mettez à jour la répartition des agents dans votre espace de travail d'agent Amazon Connect entre AWS les régions

Tout comme vous pouvez utiliser l'API UpdateTrafficDistribution pour répartir le trafic téléphonique entre les régions, vous pouvez également l'utiliser pour répartir les agents entre les régions AWS , totalement ou progressivement dans le cadre de tests réguliers de préparation opérationnelle. Par exemple, vous pouvez conserver 40 % des agents dans une AWS région pour compléter les contacts actifs et transférer les agents restants dans la région répliquée.

Note

Lorsque vous transférez le trafic téléphonique, déplacez également les agents et/ou les connexions des agents pour qu'ils puissent traiter les appels dans l'autre région. Si vous ne changez pas d'agent, les appels vocaux seront dirigés vers la région déplacée, mais aucun agent ne sera disponible pour recevoir les appels.

Après avoir ajouté des agents à votre groupe de distribution de trafic, utilisez l'UpdateTrafficDistributionAPI pour répartir les agents entre les instances liées d'un groupe de distribution de trafic donné par incréments de 10 %. Vos agents pourront établir des contacts vocaux actifs avant de changer de région.

Note

Si un agent reçoit une erreur lorsqu'il tente de mettre fin à un contact avant de changer de région, il doit actualiser la page de l'espace de travail de l'agent. Pour de plus amples informations, veuillez consulter Configurez Amazon Connect Agent Workspace pour aider les agents à passer d'une AWS région à l'autre.

Prérequis

Si les conditions suivantes ne sont pas remplies, votre appel UpdateTrafficDistributiond'API échouera avec un InvalidRequestException :

  1. Le groupe de répartition du trafic spécifié doit exister.

  2. Le statut du groupe de répartition du trafic doit être ACTIVE.

  3. Si vous modifiez la répartition SignInConfig, vous ne pouvez le faire que pour le groupe de répartition du trafic par défaut. Le groupe de répartition du trafic par défaut est créé en même temps que l'instance de réplica Amazon Connect. Consultez le IsDefault paramètre dans le type de TrafficDistributionGroupdonnées.

Lorsque vous appelez UpdateTrafficDistribution depuis la région  AWS source, vous pouvez utiliser l'ID du groupe de répartition du trafic ou l'Amazon Resource Name (ARN). Lorsque vous appelez UpdateTrafficDistribution dans la région du réplica, vous devez utiliser l'ARN du groupe de répartition du trafic.

Activez les deux Régions AWS lors des opérations régulières

L'API UpdateTrafficDistribution inclut une répartition appelée SignInConfig. Elle vous permet de choisir les serveurs de connexion backend à utiliser afin de faciliter la connexion de l'agent à leur groupe d'instances. Quel que soit le paramètre SignInConfig défini dans votre groupe de répartition du trafic, les agents sont connectés aux deux instances dans le groupe de répartition du trafic.

Pour une expérience optimale, nous vous recommandons d'activer les deux AWS régions pendant les opérations régulières. Pour ce faire, affectez la valeur true aux deux répartitions SignInConfig. Si vous devez transférer l'ensemble de votre trafic téléphonique et de vos agents vers une seule AWS région, nous vous recommandons de modifier le code en SignInConfig fonction false de la région à partir de laquelle vous transférez le trafic.

Par exemple, avec l'appel suivant, les agents ont 50 % de chances d'utiliser le serveur de connexion us-west-2 et 50 % d'utiliser le serveur de connexion us-east-1 pour un appel de connexion donné provenant du fournisseur d'identité.

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 } ] } }'

Inversement, la répartition de connexion suivante achemine 100 % du trafic sur le point de terminaison de connexion pour utiliser le serveur de connexion 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 } ] } }'

Cette répartition détermine uniquement la région du serveur de connexion qui est utilisée pour faciliter la connexion de l'agent aux deux instances de leur groupe d'instances. Elle n'affecte pas la répartition des agents contrôlés par la partie AgentConfig de l'API UpdateTrafficDistribution.

Important

Si le point de terminaison de connexion ne répond pas lors de la connexion de l'agent et que votre répartition SignInConfig s'étend sur plusieurs régions, vous pouvez résoudre les erreurs en remplaçant la répartition par une seule région AWS . Ou, si votre répartition SignInConfig est pondérée sur une région et qu'elle ne répond pas, vous pouvez essayer de transférer la répartition SignInConfig vers la région désactivée. Quelle que soit la configuration SignInConfig, les agents bénéficieront toujours d'une session active dans les régions source et de réplica, car ils tenteront de se connecter à leur instance Amazon Connect dans les deux régions.

Comment transférer l'ensemble du trafic téléphonique et des agents d'une AWS région à l'autre

Pour transférer tous les nouveaux contacts vocaux entrants, la répartition des connexions des agents et la répartition des agents de us-west-2 vers us-east-1, utilisez l'extrait de code suivant.

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 } ] } } '

Lorsque vous appelez UpdateTrafficDistribution depuis la région  AWS source, vous pouvez utiliser l'ID du groupe de répartition du trafic ou l'Amazon Resource Name (ARN). Lorsque vous appelez UpdateTrafficDistribution dans la région du réplica, vous devez utiliser l'ARN du groupe de répartition du trafic.