Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Configurazione di Amazon Connect Global Resiliency
**Nota**
**Nuovo utente?** Dai un’occhiata all’[Amazon Connect Global Resiliency Workshop](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Questo corso online ti guida attraverso il processo di onboarding e test del numero di telefono e del failover dell'agente utilizzando la nuova funzionalità tramite APIs l'interfaccia a riga di comando di AWS.
Global Resiliency è disponibile solo per le istanze Amazon Connect create nelle seguenti AWS regioni: Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Asia Pacifico (Osaka), Asia Pacifico (Tokyo), Europa (Francoforte) ed Europa (Londra).
È possibile creare una replica nella Regione Stati Uniti orientali (Virginia settentrionale) solo se l’origine è Stati Uniti occidentali (Oregon) o viceversa.
È possibile creare una replica nella Regione Europa (Francoforte) solo se l’origine è l’Europa (Londra) o viceversa.
È possibile creare una replica nella Regione Asia Pacifico (Osaka) solo se l’origine è Asia Pacifico (Tokyo).
Per accedere a questa funzionalità, contatta il Solutions Architect o il Technical Account Manager Amazon Connect.
**Importante**
Amazon Connect Global Resiliency (ACGR) è l'unica soluzione AWS supportata per la resilienza multiregionale in Amazon Connect. AWS non supporta alternative di terze parti o personalizzate per raggiungere la resilienza globale. L'implementazione di soluzioni non supportate può comportare la negazione o la riduzione dei limiti di servizio sull'istanza secondaria e potrebbe influire sulla copertura degli SLA se i tempi di inattività sono attribuiti alla distribuzione non supportata.
Amazon Connect Global Resiliency consente di fornire servizio clienti in qualsiasi parte del mondo con il massimo livello di affidabilità, prestazioni ed efficienza. Dotato di funzionalità di telefonia distribuita, il tuo contact center è in grado di soddisfare i requisiti normativi internazionali.
Amazon Connect Global Resiliency fornisce un set di soluzioni APIs che puoi utilizzare per:
+ Effettua il provisioning di un'istanza Amazon Connect collegata in un'altra Regione AWS.
+ Eseguire il provisioning e la gestione di numeri di telefono globali e accessibili in entrambe le regioni.
+ Distribuire il traffico e gli agenti di telefonia tra le istanze e le regioni di Amazon Connect con incrementi del 10% o trasferirli tutti contemporaneamente. In questo modo puoi trasferire lentamente gli agenti e i contatti vocali in entrata tra le regioni o spostarli tutti nello stesso momento.
Ad esempio, puoi distribuire il 100% degli agenti e dei contatti vocali in entrata negli Stati Uniti orientali (Virginia settentrionale) e lo 0% negli Stati Uniti occidentali (Oregon), oppure il 50% in ciascuna regione.
+ Accedere alla capacità riservata in tutte le regioni.
**Topics**
+ [Requisiti di Global Resiliency](connect-global-resiliency-requirements.md)
+ [Nozioni di base](get-started-connect-global-resiliency.md)
+ [Gestione dei gruppi di distribuzione del traffico](manage-traffic-distribution-groups.md)
+ [Gestione dei numeri di telefono tra regioni](manage-phone-numbers-across-regions.md)
+ [Gestione della chat tra Regioni](manage-chat-across-regions.md)
+ [Metriche, report e ricerca nelle regioni ACGR](metrics-reports-and-search-across-acgr-regions.md)
# Requisiti di Amazon Connect Global Resiliency
Se hai deciso che Amazon Connect Global Resiliency è l’implementazione appropriata per te, assicurati di rispettare i seguenti prerequisiti prima dell’onboarding:
+ [Trasferisci](about-porting.md) tutti i numeri di telefono che desideri abilitare in modo che siano multi-Regione su Amazon Connect.
+ AWS Per effettuare l'onboarding su Amazon Connect Global Resiliency è necessario Enterprise Support o AWS Unified Operations. Per ulteriori informazioni sui piani di AWS supporto, consulta [Piani di AWS supporto](https://aws.amazon.com/premiumsupport/plans/).
+ È necessario disporre di un’istanza Amazon Connect [abilitata per SAML 2.0](connect-identity-management.md) di produzione esistente in una Regione in cui è disponibile Amazon Connect Global Resiliency. Per confermare, consulta [Disponibilità di Global Resiliency per Regione](regions.md#gr_region).
+ È consigliabile effettuare l’onboarding e il test dei servizi Amazon Connect Global Resiliency in un ambiente di test prima di effettuare l’onboarding del traffico di produzione.
+ Richiedi che TUTTE le quote di servizio nell'istanza di replica corrispondano alle quote di servizio nell'istanza di origine: [crea un caso di aumento della quota di servizio](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) in AWS Management Console > Support.
+ Assicurati che le funzioni Lambda in tutte le AWS regioni abbiano lo stesso nome.
+ Aggiorna i flussi per sostituire qualsiasi regione codificata con un parametro `$.AwsRegion` o `$['AwsRegion']`.
**Nota**
Nel blocco [Funzione AWS Lambda ](invoke-lambda-function-block.md), `$.AwsRegion` non è consentito nel flowArn.
Per utilizzare `$.AwsRegion`, è necessario utilizzare un blocco [Set contact attributes (Imposta attributi contatti)](set-contact-attributes.md) per impostare il flusso, ad esempio:
`flowIdKey` : `arn:aws:connect:$.AwsRegion:123456789012:instance/12345678-1234-1234-1234-123456789012/contact-flow/12345678-1234-1234-1234-123456789012`
Successivamente utilizza quella chiave di attributo nel blocco [Funzione AWS Lambda ](invoke-lambda-function-block.md) come `${flowIdKey}`.
`$.AwsRegion` è supportato solo per l’ARN Lambda e l’ARN Lex.
+ Per i bot Amazon Lex, puoi eseguire una delle seguenti operazioni:
+ Usa Amazon Lex Global Resiliency per replicare i bot tra le AWS regioni e conservare l'ID bot.
+ Cambia i flussi in branch in base alla AWS regione in cui è in esecuzione il flusso. In fase di runtime, questi parametri vengono sostituiti con la Regione in cui viene eseguito il flusso, come mostrato nell’esempio seguente.
![\[La pagina delle proprietà del blocco Verifica attributi contatti.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/acgr-requirements.png)
# Nozioni di base su Amazon Connect Global Resiliency
**Importante**
Amazon Connect alle istanze create prima del 31 marzo 2021 è stato assegnato un dominio con il seguente formato:
```
https://your-instance-alias.awsapps.com/connect/
```
Se il tuo dominio utilizza il formato precedente, non sarà possibile configurare correttamente la funzionalità Amazon Connect Global Resiliency. Per abilitare questa funzionalità, devi [aggiornare il tuo dominio](update-your-connect-domain.md) al formato più recente:
```
https://your-instance-alias.my.connect.aws/
```
**Nota**
**Nuovo utente?** Dai un’occhiata all’[Amazon Connect Global Resiliency Workshop](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Questo corso online ti guida attraverso il processo di onboarding e test del numero di telefono e del failover dell'agente utilizzando la nuova funzionalità tramite APIs l'interfaccia a riga di comando di AWS.
Global Resiliency è disponibile solo per le istanze Amazon Connect create nelle seguenti AWS regioni: Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Asia Pacifico (Osaka), Asia Pacifico (Tokyo), Europa (Francoforte) ed Europa (Londra).
È possibile creare una replica nella Regione Stati Uniti orientali (Virginia settentrionale) solo se l’origine è Stati Uniti occidentali (Oregon) o viceversa.
È possibile creare una replica nella Regione Europa (Francoforte) solo se l’origine è l’Europa (Londra) o viceversa.
È possibile creare una replica nella Regione Asia Pacifico (Osaka) solo se l’origine è Asia Pacifico (Tokyo).
Per accedere a questa funzionalità, contatta il Solutions Architect o il Technical Account Manager Amazon Connect.
Inizia a usare Amazon Connect Global Resiliency creando una replica della tua istanza Amazon Connect esistente in un'altra Regione AWS e creando un gruppo di distribuzione del traffico.
Un *gruppo di distribuzione del traffico* è una risorsa Amazon Connect che consente di collegare istanze Amazon Connect che si trovano in diverse Regioni AWS. È possibile collegare numeri di telefono al gruppo di distribuzione del traffico. È possibile distribuire il traffico verso questi numeri tra le istanze del gruppo di distribuzione del traffico.
## Come configurare Amazon Connect Global Resiliency
1. [Creazione di una replica della tua istanza Amazon Connect esistente](create-replica-connect-instance.md). Utilizza l'API di [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html).
1. [Crea un gruppo di distribuzione del traffico](setup-traffic-distribution-groups.md).
1. Utilizza l'API di [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html).
1. Utilizza l'[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API per determinare se il gruppo di distribuzione del traffico è stato creato correttamente (`Status`deve esserlo`ACTIVE`).
1. [Richiedi i numeri di telefono al tuo gruppo di distribuzione del traffico](claim-phone-numbers-traffic-distribution-groups.md). Dopo che il gruppo di distribuzione del traffico è stato creato con successo (`Status`è`ACTIVE`), puoi richiedergli i numeri di telefono utilizzando l'[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API.
**Nota**
La distribuzione del traffico predefinita per questi numeri di telefono è impostata su 100%-0%. Ciò significa che il 100% del traffico di telefonia in entrata sarà diretto all'istanza Amazon Connect di origine utilizzata per creare una replica.
Inoltre, dopo aver richiesto i numeri di telefono a un'istanza, puoi assegnarli a più istanze contemporaneamente tra Regioni AWS. A tale scopo, utilizza l'[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API per assegnare i numeri a un gruppo di distribuzione del traffico.
1. [Aggiorna la distribuzione del traffico](update-telephony-traffic-distribution.md). Utilizza l'[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API per distribuire il traffico tra le istanze collegate con incrementi del 10%.
# Creazione di una replica dell'istanza Amazon Connect esistente
**Nota**
**Nuovo utente?** Dai un’occhiata all’[Amazon Connect Global Resiliency Workshop](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Questo corso online ti guida attraverso il processo di onboarding e test del numero di telefono e del failover dell'agente utilizzando la nuova funzionalità tramite APIs l'interfaccia a riga di comando di AWS.
Global Resiliency è disponibile solo per le istanze Amazon Connect create nelle seguenti AWS regioni: Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Asia Pacifico (Osaka), Asia Pacifico (Tokyo), Europa (Francoforte) ed Europa (Londra).
È possibile creare una replica nella Regione Stati Uniti orientali (Virginia settentrionale) solo se l’origine è Stati Uniti occidentali (Oregon) o viceversa.
È possibile creare una replica nella Regione Europa (Francoforte) solo se l’origine è l’Europa (Londra) o viceversa.
È possibile creare una replica nella Regione Asia Pacifico (Osaka) solo se l’origine è Asia Pacifico (Tokyo).
Per accedere a questa funzionalità, contatta il Solutions Architect o il Technical Account Manager Amazon Connect.
Chiami l'[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API per creare una replica della tua istanza Amazon Connect in un'altra Regione AWS e per copiare le informazioni di configurazione per le risorse Amazon Connect. Regioni AWS
**Topics**
+ [Informazioni importanti](#important-info-automated-config)
+ [Caratteristiche dell'istanza di replica](#replica-characteristics)
+ [Risorse di cui viene eseguito il mirroring nell'istanza di replica](#mirrored-resources)
+ [Come procedere dopo la creazione dell'istanza di replica](#configure-replica-instance)
+ [Quando contattare il Supporto AWS](#replica-cs)
+ [Perché una ReplicateInstance chiamata fallisce](#why-replicateinstance-fails)
+ [Trova la regione di origine della tua istanza](#how-to-find-source-region-of-instances)
## Informazioni importanti
+ Prima dell'esecuzione [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html):
+ Assicurati di disporre delle autorizzazioni IAM minime richieste per creare un'istanza. Per informazioni, consulta [Autorizzazioni richieste per l'utilizzo di policy IAM personalizzate per gestire l'accesso alla console Amazon Connect](security-iam-amazon-connect-permissions.md).
+ Aggiorna i flussi per sostituire qualsiasi regione codificata con un parametro `$.AwsRegion` o `$['AwsRegion']`. In fase di runtime, questi parametri vengono sostituiti con la regione in cui viene eseguito il flusso.
+ Assicurati che tutte le funzioni Lambda nelle Regioni AWS abbiano lo stesso nome.
+ Per i bot Amazon Lex, puoi eseguire una delle seguenti operazioni:
+ Usa Amazon Lex Global Resiliency per replicare i bot tra le Regioni AWS e mantenere l’ID del bot.
+ Trasforma i flussi in branch in base alla AWS regione in cui è in esecuzione il flusso. In fase di runtime, questi parametri vengono sostituiti con la Regione in cui viene eseguito il flusso, come mostrato nell’esempio seguente.
![\[La pagina delle proprietà del blocco Verifica attributi contatti.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/acgr-requirements.png)
+ Per consentire l' Chiavi gestite da AWS accesso all'istanza di replica, utilizzando la AWS console, crea un'istanza Amazon Connect temporanea nella regione in cui intendi creare l'istanza di replica. Questo creerà l'impostazione predefinita Chiavi gestite da AWS per Amazon Connect.
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)copia la configurazione di Amazon Connect Regioni AWS come parte del processo di replica iniziale. Una volta completata questa prima fase, tutte le modifiche apportate successivamente alle [risorse di cui è stato effettuato il mirroring](#mirrored-resources) vengono sincronizzate continuamente in un secondo momento. Ciò avviene in modo bidirezionale, dall’origine alla replica e dalla replica all’origine.
+ Tutti i numeri di telefono sull'istanza di origine che non sono già collegati a gruppi di numeri vengono aggiunti automaticamente al gruppo di distribuzione del traffico predefinito. Questo passaggio rende i numeri di telefono disponibili sia nelle regioni dell'origine che in quelle della replica e consente il mirroring delle associazioni dei numeri di telefono e dei flussi tra Regioni AWS.
+ Per le istanze in Asia Pacifico (Tokyo), solo i numeri di telefono esplicitamente abilitati per Amazon Connect Global Resiliency (ACGR) supporteranno un comportamento di replica completo verso l’Asia Pacifico (Osaka). Quando effettui un trasferimento attraverso l’Asia Pacifico (Osaka), le chiamate in entrata possono avere tempi di consegna fino a 20 secondi.
+ L'accesso di emergenza all'istanza di replica è disponibile solo dopo che è stata eseguita la replica del profilo di instradamento predefinito e della coda tra le regioni.
+ Man mano che la configurazione viene propagata Regioni AWS, puoi visualizzare lo stato di avanzamento nei AWS CloudTrail log. Oppure, nel sito web di Amazon Connect amministrazione puoi accedere a **Gestione utenti**, **Visualizza la cronologia delle modifiche** per visualizzare una traccia di controllo delle modifiche apportate agli utenti. Gli audit trail sono disponibili anche per altre configurazioni.
+ È possibile che nel CloudTrail registro vengano visualizzati i seguenti errori che non influiscono sul mirroring delle configurazioni.
+ Errori Http 409 (conflitto): questi errori si verificano a causa di conflitti di mirroring durante l’elaborazione di più aggiornamenti di configurazione effettuati alla stessa risorsa del contact center in rapida successione. Sebbene questi errori possano comparire nei log, non influiscono sull’effettivo mirroring delle risorse del contact center.
+ Si verificherà un conflitto di nomi di risorse se le risorse nell'istanza di origine e nell'istanza di replica hanno lo stesso nome ma una risorsa diversa. IDs Ciò potrebbe accadere, ad esempio, se la risorsa nell'istanza di replica è stata creata manualmente al di fuori del processo di replica.
In caso di conflitti tra i nomi delle risorse, [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)non sincronizza la risorsa tra le regioni. ma genera un errore `ResourceConflictException`. Dopo aver risolto il conflitto di nomi (ad esempio, eliminando la risorsa nell'istanza di replica), è possibile eseguire nuovamente `ReplicateInstance` per sincronizzare la risorsa.
+ Dopo l'esecuzione`ReplicateInstance`, è necessario utilizzare l'[AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API per associare gli agenti al gruppo di distribuzione del traffico predefinito o a un gruppo di distribuzione del traffico personalizzato.
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)L'esecuzione non sincronizza le funzioni Lambda o i bot Amazon Lex o altre integrazioni/di terze parti che potresti avere.
## Caratteristiche dell'istanza di replica
+ L'istanza Amazon Connect di replica viene creata nello stesso account AWS dell'istanza Amazon Connect esistente.
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)crea un gruppo di distribuzione del traffico predefinito se non ne esiste già uno. Questo gruppo include tre tipi di distribuzione del traffico:
+ Accesso
+ Agente
+ Telefonia
Utilizza l'[CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API per creare più gruppi di distribuzione del traffico, tuttavia, questi gruppi di distribuzione del traffico aggiuntivi non sono gruppi di distribuzione del traffico predefiniti e quindi supportano solo le distribuzioni di agenti e telefonia.
+ Il gruppo di distribuzione del traffico predefinito è l'unico gruppo di questo tipo in cui è possibile modificare la distribuzione `SignInConfig`. Vedi il `IsDefault` parametro nel tipo di [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html)dati.
+ Puoi utilizzare `SignInConfig` per scegliere i server di accesso di back-end per facilitare l'accesso dell'agente alla sua istanza Amazon Connect. Ad esempio, se chiami `UpdateTrafficDistribution` con un parametro `SignInConfig` modificato e non uno `TrafficDistributionGroup` predefinito, viene restituito `InvalidRequestException`.
+ L'istanza di replica ha lo stesso ID dell'istanza Amazon Connect da cui viene replicata.
## Risorse di cui viene eseguito il mirroring nell'istanza di replica
[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)rispecchia le seguenti Amazon Connect risorse. Regioni AWS
**Importante**
Le Service Quotas per queste risorse vengono abbinate automaticamente tra Regioni AWS *prima* che venga eseguito il mirroring delle risorse. Per aumentare un'altra quota nell'istanza di replica, invia una richiesta.
+ Competenze degli agenti
+ Flussi
+ Moduli di flusso
+ Utenti
+ Routing profiles (Profili di instradamento
+ Queues
+ Profili di sicurezza
+ Ore di operatività
+ Connessioni rapide
+ Attributi predefiniti
+ Prompt (non inclusi quelli archiviati in S3)
+ Gerarchie di utenti (gruppi e livelli)
+ Stato agente
+ Attributi predefiniti
+ Report salvati.
+ Visualizzazioni
+ Tabelle di dati
+ WorkSpace
+ Versioni del modulo Flow
+ Alias del modulo di flusso
+ Parametri personalizzati
+ Casi di test
+ Notifications
**Note importanti su risorse specifiche**
**Report salvati**: mentre i report salvati vengono replicati, le pianificazioni associate ai report salvati *non* vengono replicate.
**Visualizzazioni**: vengono replicate solo le visualizzazioni in uno stato *pubblicato*. Le viste in stato bozza *non* vengono replicate.
**Tabelle dati**: i valori della tabella dati che contengono riferimenti ARN letterali adatteranno automaticamente il codice regionale alla regione locale quando vengono replicati. ARNs costruito utilizzando espressioni potrebbe non modificare automaticamente il codice regionale.
[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)replica anche le seguenti associazioni su Regioni AWS:
+ Numero di telefono e flusso
+ Coda e profilo di instradamento
+ Utente e profilo di sicurezza, profilo di instradamento e gerarchia utenti
+ Routing profiles (Profili di instradamento
+ Coda e connessioni rapide
+ Coda e ore di operatività
+ Coda e flusso
**Nota**
Dopo la replica iniziale, le modifiche alla configurazione vengono replicate in modo bidirezionale tra le istanze replicate quasi in tempo reale. Se questa operazione non riesce, Amazon Connect Global Resiliency tenta di sincronizzare gli aggiornamenti entro 30 minuti.
## Come procedere dopo la creazione dell'istanza di replica
Dopo aver creato l'istanza Amazon Connect di replica, devi configurarla:
1. Garantisci la ridondanza per le integrazioni di front-end e back-end (ad esempio, SSO, Lambda, Lex) tra le regioni.
1. Effettua aggiornamenti manuali corrispondenti tra le istanze collegate.
1. Utilizza l'[AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API per associare gli agenti al gruppo di distribuzione del traffico predefinito.
Prima di poter associare gli agenti a un gruppo di distribuzione del traffico, essi devono essere presenti sia sull'istanza di origine che su quella di replica. Non è possibile associare gli utenti a un gruppo di distribuzione del traffico quando sono stati aggiunti di recente all'istanza di origine e non sono ancora presenti nella replica.
## Quando contattare l' AWS assistenza
Contatta l' AWS assistenza per ricevere assistenza nelle seguenti attività:
+ Per comprendere lo stato del mirroring oltre a quanto disponibile nei CloudTrail log e nell'audit trail nel sito web di Amazon Connect amministrazione.
## Perché una chiamata fallisce ReplicateInstance
Una chiamata [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API fallisce con un `InvalidRequestException` nei seguenti casi:
1. La regione in cui stai creando la replica è la stessa dell'istanza esistente.
1. L'istanza è già stata replicata come parte di un'altra chiamata [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API.
1. L'istanza non ha un alias.
1. Lo stato dell'istanza non è `ACTIVE`.
1. L'istanza non ha SAML abilitato.
1. È un presente un conflitto tra i nomi delle risorse.
## Come trovare la regione di origine delle istanze Amazon Connect
Se dimentichi qual è la regione di origine delle tue istanze Amazon Connect, procedi nel seguente modo per trovarla:
1. Chiama l'[ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html)API con il tuo`InstanceId`.
1. Per qualsiasi gruppo di distribuzione del traffico nell'elenco di risposta, l'`InstanceARN` restituito include la regione di origine. Ad esempio, nel seguente ARN, *source-region* sarebbe la regione della tua istanza Amazon Connect.
`arn:aws:connect:source-region:account-id:traffic-distribution-group/ traffic-distribution-group-id`
# Crea gruppi di distribuzione del traffico per la tua istanza Amazon Connect
Puoi creare un gruppo di distribuzione del traffico per la tua istanza Amazon Connect esistente utilizzando l'[CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API.
Un *gruppo di distribuzione del traffico* è una risorsa Amazon Connect che consente di collegare istanze Amazon Connect che si trovano in diverse Regioni AWS. È possibile collegare numeri di telefono al gruppo di distribuzione del traffico. È possibile distribuire il traffico verso questi numeri tra le istanze del gruppo di distribuzione del traffico.
## Informazioni importanti
+ Un gruppo di distribuzione del traffico deve essere creato nella Regione AWS di origine. Una *regione di origine* è la regione in cui configuri l'istanza Amazon Connect esistente.
+ Quando si associano numeri di telefono a un gruppo di distribuzione del traffico:
+ È possibile associare solo i numeri di telefono richiesti nella regione di origine.
+ Il numero di telefono deve trovarsi nella stessa regione in cui è stato creato il gruppo di distribuzione del traffico.
+ È possibile richiedere numeri a un gruppo di distribuzione del traffico oppure ottenere o aggiornare la distribuzione del traffico per un gruppo di distribuzione del traffico solo quando il suo `Status` è`ACTIVE`. Utilizza l'[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API per determinare se è stata creata correttamente (`Status`deve esserlo`ACTIVE`).
+ Quando crei un'istanza Amazon Connect di replica, per essa viene creato un gruppo di distribuzione del traffico predefinito. Il gruppo di distribuzione del traffico predefinito è l'unico gruppo di questo tipo in cui è possibile modificare la distribuzione `SignInConfig`. Vedi il `IsDefault` parametro nel tipo di [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html)dati. Puoi utilizzare `SignInConfig` per scegliere i server di accesso di back-end per facilitare l'accesso dell'agente alla sua istanza Amazon Connect. Ad esempio, se chiami `UpdateTrafficDistribution` con un parametro `SignInConfig` modificato e non uno `TrafficDistributionGroup` predefinito, viene restituito `InvalidRequestException`.
## Stati dei gruppi di distribuzione del traffico
Di seguito è riportata una descrizione degli stati dei gruppi di distribuzione del traffico:
+ `CREATION_IN_PROGRESS`: la creazione del gruppo di distribuzione del traffico è in corso.
+ `ACTIVE`: il gruppo di distribuzione del traffico è stato creato.
+ `CREATION_FAILED`: la creazione del gruppo di distribuzione del traffico ha avuto esito negativo.
+ `PENDING_DELETION`: l'eliminazione del gruppo di distribuzione del traffico è in corso.
+ `DELETION_FAILED`: l'eliminazione del gruppo di distribuzione del traffico ha avuto esito negativo.
+ `UPDATE_IN_PROGRESS`: l'aggiornamento del gruppo di distribuzione del traffico è in corso.
## Perché una CreateTrafficDistributionGroup chiamata fallisce
Una chiamata [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API fallisce con un `InvalidRequestException` nei seguenti casi:
+ L'[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API non è stata chiamata prima di creare un gruppo di distribuzione del traffico per le istanze collegate.
+ L'[CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API non è stata chiamata nella stessa regione in cui è stata chiamata l'[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API. La regione in cui viene chiamata questa API deve corrispondere alla regione dell'istanza utilizzata per creare una replica.
# Richiesta di numeri di telefono ai gruppi di distribuzione del traffico con Amazon Connect
**Nota**
**Nuovo utente?** Dai un’occhiata all’[Amazon Connect Global Resiliency Workshop](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Questo corso online ti guida attraverso il processo di onboarding e test del numero di telefono e del failover dell'agente utilizzando la nuova funzionalità tramite APIs l'interfaccia a riga di comando di AWS.
Global Resiliency è disponibile solo per le istanze Amazon Connect create nelle seguenti AWS regioni: Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Asia Pacifico (Osaka), Asia Pacifico (Tokyo), Europa (Francoforte) ed Europa (Londra).
È possibile creare una replica nella Regione Stati Uniti orientali (Virginia settentrionale) solo se l’origine è Stati Uniti occidentali (Oregon) o viceversa.
È possibile creare una replica nella Regione Europa (Francoforte) solo se l’origine è l’Europa (Londra) o viceversa.
È possibile creare una replica nella Regione Asia Pacifico (Osaka) solo se l’origine è Asia Pacifico (Tokyo).
Per accedere a questa funzionalità, contatta il Solutions Architect o il Technical Account Manager Amazon Connect.
Dopo aver creato correttamente il gruppo di distribuzione del traffico (`Status`is`ACTIVE`), puoi utilizzarlo per [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)cercare i numeri di telefono disponibili e richiederli. [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)
Prima di richiedere un numero di telefono al tuo gruppo di distribuzione del traffico, ti consigliamo di utilizzare l'[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API per verificare lo stato del gruppo di distribuzione del traffico`ACTIVE`. L'assegnazione di un numero di telefono a un gruppo di distribuzione del traffico che non è `ACTIVE` genera `ResourceNotFoundException`.
Puoi richiedere un numero di telefono a un gruppo di distribuzione del traffico fornendo l'ARN del gruppo di distribuzione del traffico nel **TargetArn**parametro quando chiami l'[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API. Puoi anche utilizzare l'[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API per assegnare un numero di telefono precedentemente dichiarato a un'istanza a un gruppo di distribuzione del traffico.
**Nota**
Per aggiornare il campo **Descrizione** devi utilizzare la console Amazon Connect.
## Flusso di lavoro di esempio
Di seguito è riportato un esempio di flusso di lavoro per richiedere numeri di telefono e utilizzarli tra più Regioni AWS:
1. Crea una replica dell'istanza:
1. Chiamata dell'API [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html).
1. Crea un gruppo di distribuzione del traffico che colleghi tra loro queste istanze:
1. Chiamata dell'API [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html).
1. Trova i numeri di telefono disponibili che possono essere richiesti al tuo gruppo di distribuzione del traffico:
1. Chiama l'[SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API nella regione in cui è stato creato il gruppo di distribuzione del traffico. Fornisci l'ARN del gruppo di distribuzione del traffico per il parametro `TargetArn`.
1. Nella regione in cui è stato creato il gruppo di distribuzione del traffico, chiama l'[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API:
1. Fornisci l'ARN del gruppo di distribuzione del traffico per il parametro `TargetArn`.
1. Fornisci il valore del numero di telefono E164 restituito dalla chiamata [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API nel passaggio 3.
Vengono restituiti un `PhoneNumberId` e un `PhoneNumberArn`. È possibile utilizzare questi valori per le operazioni di follow-up.
1. Verifica che lo stato del numero di telefono sia `CLAIMED`:
1. Chiamata dell'API [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html).
(DescribePhoneNumber può essere chiamato anche nell'altra regione associata al gruppo di distribuzione del traffico. Restituirà gli stessi dettagli del numero di telefono.)
È possibile utilizzare il numero di telefono per le operazioni di follow-up solo dopo che il suo stato è `CLAIMED`.
Per una descrizione dei possibili stati, consulta [Definizione degli stati dei numeri di telefono](#claim-phone-number-status).
1. Ripeti i passaggi da 3 a 5 per tutti i numeri di telefono che devi richiedere al tuo gruppo di distribuzione del traffico.
1. Esegui la procedura riportata sotto per associare i flussi ai numeri di telefono. Eseguila in entrambe le regioni in cui opera il gruppo di distribuzione del traffico.
Questi passaggi garantiscono che il traffico di telefonia venga instradato correttamente ai flussi e che supporti la configurazione di distribuzione del traffico.
1. Nella tua istanza Amazon Connect esistente, procedi come segue nella regione in cui è stato creato il gruppo di distribuzione del traffico:
1. Chiama [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)l'API. Fornisci l'`InstanceId` corrispondente all'istanza che è stata replicata.
1. ARNs Viene restituito un elenco di flussi. Usa questi flussi ARNs per associare un flusso a un numero di telefono; chiama l'[AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API.
1. Nell'istanza Amazon Connect replicata nell'altra AWS regione, procedi nel seguente modo:
1. Chiama l'[ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API. Fornisci l'`InstanceId` corrispondente all'istanza che è stata replicata.
1. ARNs Viene restituito un elenco di flussi. Usa questi flussi ARNs per associare un flusso a un numero di telefono; chiama l'[AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API.
## Perché una ClaimPhoneNumber chiamata fallisce
La chiamata [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API fallirà con a `ResourceNotFoundException` nei seguenti casi:
+ Il gruppo di distribuzione del traffico specificato non esiste, lo stato del gruppo di distribuzione del traffico non è `ACTIVE` oppure sei il proprietario del gruppo di distribuzione del traffico.
+ Non è possibile richiedere il numero di telefono perché non è disponibile. In alcuni casi, un numero di telefono trovato in [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)potrebbe essere stato richiesto da un altro cliente.
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)fallirà con un `InvalidParameterException` errore nel caso seguente:
+ L'endpoint che stai chiamando non si trova nella stessa regione in cui è stato creato il gruppo di distribuzione del traffico.
## Definizione degli stati dei numeri di telefono
Di seguito è riportata una descrizione degli stati dei numeri di telefono:
+ `CLAIMED`indica che l'operazione precedente [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)o [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)l'operazione è riuscita.
+ `IN_PROGRESS`significa a [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html), [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)l'operazione è ancora in corso e non è stata ancora completata. È possibile chiamare [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)in un secondo momento per verificare se l'operazione precedente è stata completata.
+ `FAILED`indica che l'[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)operazione precedente [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)o non è riuscita. È presente un messaggio che indica il motivo dell'errore.
Un motivo comune di errore è il fatto che potrebbe essere stato raggiunto il limite massimo di numeri registrati per il valore `TargetArn` che stai richiedendo o a cui desideri aggiornare un numero di telefono.
Se la chiamata API `ClaimPhoneNumber` restituisce lo stato `FAILED`, hai un giorno di tempo per riprovare a richiedere il numero di telefono prima che venga reinserito nell'inventario per poter essere richiesto da altri clienti.
# Assegnazione di numeri di telefono richiesti ai gruppi di distribuzione del traffico in Amazon Connect
+ Hai creato un nuovo gruppo di distribuzione del traffico e il suo stato è `ACTIVE`. Ti consigliamo di utilizzare l'[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API per verificare lo stato.
+ Hai già richiesto numeri di telefono a istanze o altri gruppi di distribuzione del traffico.
Ora puoi assegnare i numeri di telefono dichiarati al tuo nuovo gruppo di distribuzione del traffico utilizzando l'[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API. Fornisci l'ARN del gruppo di distribuzione del traffico nel parametro `TargetArn`.
**Nota**
Per aggiornare il campo **Descrizione** devi utilizzare la console Amazon Connect.
## Flusso di lavoro di esempio
Di seguito è riportato un esempio di flusso di lavoro per assegnare i numeri di telefono richiesti al tuo gruppo di distribuzione del traffico:
1. Chiama l'[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API per assegnare il numero di telefono a un nuovo. `TargetArn`
Questo `TargetArn` può essere un'altra istanza di Amazon Connect o di un gruppo di distribuzione del traffico creato nella stessa regione in cui il numero di telefono era stato inizialmente richiesto.
1. Esegui la procedura riportata sotto per associare i flussi ai numeri di telefono.
Questi passaggi garantiscono che il traffico di telefonia venga instradato correttamente ai flussi e che supporti la configurazione di distribuzione del traffico.
1. Nella tua istanza Amazon Connect esistente, procedi come segue nella regione in cui è stato creato il gruppo di distribuzione del traffico:
1. Chiamata dell'API [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html). Fornisci l'`InstanceId` corrispondente all'istanza che è stata replicata.
1. ARNs Viene restituito un elenco di flussi. Usa questi flussi ARNs per associare un flusso a un numero di telefono; chiama l'[AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API.
L'associazione tra numero di telefono e flusso verrà rispecchiata tra le istanze di Amazon Connect in AWS tutte le regioni.
## Perché una chiamata non riesce AssociatePhoneNumberContactFlow
Se il numero viene dichiarato a un gruppo di distribuzione del traffico e si sta chiamando [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)utilizzando un'istanza nel luogo in Regione AWS cui è stato creato il gruppo di distribuzione del traffico, è possibile utilizzare un numero di telefono completo ARN o un valore UUID per il `PhoneNumberId` parametro di richiesta URI.
Tuttavia, se il numero viene dichiarato a un gruppo di distribuzione del traffico e si chiama questa API utilizzando un'istanza nella replica Regione AWS associata al gruppo di distribuzione del traffico, è necessario fornire un numero di telefono completo ARN. Se in questo scenario viene fornito un UUID, verrà restituito `ResourceNotFoundException`.
## Perché una chiamata fallisce UpdatePhoneNumber
La chiamata [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API avrà esito negativo con a `ResourceNotFoundException` nel caso seguente:
+ Il gruppo di distribuzione del traffico specificato non esiste, lo stato del gruppo di distribuzione del traffico non è `ACTIVE` oppure sei il proprietario del gruppo di distribuzione del traffico.
[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)avrà esito negativo con un `InvalidParameterException` errore nel caso seguente:
+ L'endpoint che stai chiamando non si trova nella stessa regione in cui è stato creato il gruppo di distribuzione del traffico.
## Definizione degli stati dei numeri di telefono
Di seguito è riportata una descrizione degli stati dei numeri di telefono:
+ `CLAIMED`indica che l'operazione precedente [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)o [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)l'operazione è riuscita.
+ `IN_PROGRESS`significa a [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html), [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)l'operazione è ancora in corso e non è stata ancora completata. È possibile chiamare [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)in un secondo momento per verificare se l'operazione precedente è stata completata.
+ `FAILED`indica che l'[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)operazione precedente [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)o non è riuscita. È presente un messaggio che indica il motivo dell'errore. Un motivo comune di errore è il fatto che potrebbe essere stato raggiunto il limite massimo di numeri registrati per il valore `TargetArn` che stai richiedendo o a cui desideri aggiornare un numero di telefono.
# Aggiorna la distribuzione del traffico telefonico tra le istanze di Amazon Connect e Regioni AWS
Utilizzi l'[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API per distribuire il traffico di telefonia e [spostare gli agenti](update-agents-across-regions.md) tra le regioni.
**Nota**
Quando sposti il traffico di telefonia, trasferisci anche gli accessi degli and/or agenti per garantire che possano gestire le chiamate nell'altra regione. Se non sposti gli agenti, le chiamate vocali verranno trasferite nella Regione modificata, ma non ci saranno agenti disponibili a ricevere le chiamate.
Dopo aver richiesto i numeri di telefono al gruppo di distribuzione del traffico, puoi utilizzare l'[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API per distribuire i contatti vocali in entrata tra le istanze collegate in un determinato gruppo di distribuzione del traffico con incrementi del 10%.
Se i seguenti requisiti non vengono soddisfatti, la chiamata [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API avrà esito negativo e verrà visualizzato un messaggio: `InvalidRequestException`
+ È necessario fornire la distribuzione per la configurazione del traffico di telefonia.
+ È necessario specificare la distribuzione del traffico per entrambe le istanze collegate e il totale della distribuzione deve essere pari al 100%.
+ È necessario specificare la distribuzione del traffico con incrementi del 10%.
+ L'istanza ARNs specificata nella configurazione di telefonia deve corrispondere a quella ARNs delle istanze collegate.
Quando si chiama `UpdateTrafficDistribution` dalla regione AWS di origine, è possibile utilizzare l'ID del gruppo di distribuzione del traffico o il nome della risorsa Amazon (ARN). Quando si chiama `UpdateTrafficDistribution` nella regione della replica, è necessario utilizzare l'ARN del gruppo di distribuzione del traffico.
# Configurazione dell'esperienza dell'agente con Amazon Connect Global Resiliency
Amazon Connect Global Resiliency ti consente di offrire un’esperienza globale agli agenti con funzionalità di accesso globale, API di distribuzione agente e miglioramenti di Agent Workspace. Con questo set di funzionalità puoi:
+ Consentire ai tuoi agenti di effettuare l'accesso una sola volta all'inizio della giornata e di gestire i contatti della regione attualmente attiva senza dover sapere quale sia attiva in un dato momento.
+ Aggiungi agenti al tuo gruppo di distribuzione del traffico e distribuisci agenti tra le regioni AWS.
+ Reindirizza i nuovi contatti vocali in ingresso allo spazio di lavoro dell’agente per la Regione attualmente attiva con un semplice aggiornamento della pagina.
**Topics**
+ [Integra l'IdP con un endpoint di accesso SAML di Amazon Connect Global Resiliency](integrate-idp.md)
+ [Associa gli agenti alle istanze in più regioni AWS](associate-agents-across-regions.md)
+ [Aggiornamento della distribuzione degli agenti tra regioni](update-agents-across-regions.md)
+ [Configurazione del workspace dell'agente](setup-agentworkspace-switchover.md)
+ [Suggerimenti per evitare problemi quando si spostano gli agenti in un'altra regione](possible-issues-shifting-regions.md)
# Integrazione del gestore dell'identità digitale con un endpoint di accesso SAML di Amazon Connect Global Resiliency
Per consentire ai tuoi agenti di accedere una sola volta e di accedere a entrambe le AWS regioni per elaborare i contatti dalla regione attualmente attiva, devi configurare le impostazioni IAM per utilizzare l'endpoint SAML di accesso globale.
## Prima di iniziare
Per utilizzare Amazon Connect Global Resiliency devi abilitare SAML per la tua istanza Amazon Connect. Per ulteriori informazioni su come iniziare a utilizzare la federazione IAM, consulta [Abilitazione di utenti federati SAML 2.0 per accedere alla Console di gestione AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-saml.html).
## Informazioni importanti
+ Il failover dell'agente è supportato solo quando si utilizza l'endpoint di accesso globale.
+ Per eseguire la procedura riportata in questo argomento è necessario l'ID dell'istanza. Per istruzioni su come trovarlo, consulta [Trovare l’ID o l’ARN dell’istanza Amazon Connect](find-instance-arn.md).
+ È inoltre necessario conoscere la regione di origine delle istanze Amazon Connect. Per istruzioni su come trovarlo, consulta [Come trovare la regione di origine delle istanze Amazon Connect](create-replica-connect-instance.md#how-to-find-source-region-of-instances).
+ Se stai incorporando l’applicazione Connect in un iframe, devi assicurarti che il tuo dominio sia presente nell’elenco delle origini approvate sia nell’istanza di origine che nell’istanza di replica affinché l’accesso globale funzioni.
Per configurare le origini approvate a livello di istanza, segui la procedura riportata in [Utilizzare un elenco elementi consentiti per le applicazioni integrate in Amazon Connect](app-integration.md).
+ Gli agenti devono essere già stati creati *sia* nelle istanze Amazon Connect di origine che di replica e avere lo stesso nome utente di quello della sessione del ruolo del gestore dell'identità digitale (IdP). In caso contrario, riceverai un'eccezione `UserNotOnboardedException` e rischierai di perdere le funzionalità di ridondanza degli agenti tra le istanze.
+ È necessario associare gli agenti a un gruppo di distribuzione del traffico prima che provino a eseguire l'accesso. In caso contrario, il tentativo di accesso avrà esito negativo e restituirà un errore `ResourceNotFoundException`. Per informazioni su come configurare i gruppi di distribuzione del traffico e associare gli agenti ad essi, consulta [Associa agenti a istanze Amazon Connect in più AWS regioni](associate-agents-across-regions.md).
+ Quando i tuoi agenti eseguono la federazione in Amazon Connect utilizzando il nuovo URL di accesso SAML, Amazon Connect Global Resiliency tenta sempre di effettuare il log degli agenti nelle regioni/istanze di origine e di replica, indipendentemente dalla configurazione di `SignInConfig` nel gruppo di distribuzione del traffico. È possibile verificarlo controllando i log. CloudTrail
+ La `SignInConfig` distribuzione nel gruppo di distribuzione del traffico predefinito determina solo quale Regione AWS viene utilizzato per facilitare l'accesso. Indipendentemente da come è configurata la distribuzione `SignInConfig`, Amazon Connect tenta sempre di far accedere gli agenti a entrambe le regioni dell'istanza Amazon Connect.
+ Dopo aver replicato un'istanza Amazon Connect, viene generato un solo endpoint di accesso SAML per le istanze. Questo endpoint contiene sempre la fonte Regione AWS nell'URL.
+ Non è necessario configurare uno stato dell'inoltro quando si utilizza l'URL di accesso SAML personalizzato con Amazon Connect Global Resiliency.
## Come integrare il gestore dell'identità
1. Quando crei una replica della tua istanza Amazon Connect utilizzando l'[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API, viene generato un URL di accesso SAML personalizzato per le tue istanze Amazon Connect. L'URL viene generato nel formato seguente:
`https://instance-id.source-region.sign-in.connect.aws/saml`
1. *instance-id*è l'ID dell'istanza per entrambe le istanze del tuo gruppo di istanze. L'ID dell'istanza è identico nelle regioni di origine e di replica.
1. *source-region*corrisponde alla AWS regione di origine in cui è stata chiamata l'[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)API.
1. Aggiungi la seguente policy di attendibilità al tuo ruolo nella Federazione IAM. Utilizza l'URL per l'endpoint di accesso SAML globale come mostrato nell'esempio seguente.
------
#### [ 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` è la risorsa del gestore di identità creata in IAM.
1. Concedi al tuo ruolo nella Federazione IAM l'accesso a `connect:GetFederationToken` per il tuo `InstanceId`. Esempio:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "GetFederationTokenAccess",
"Effect": "Allow",
"Action": "connect:GetFederationToken",
"Resource": "*",
"Condition": {
"StringEquals": {
"connect:InstanceId": "your-instance-id"
}
}
}
]
}
```
------
1. Aggiungi una mappatura degli attributi all'applicazione del gestore di identità utilizzando le seguenti stringhe di attributi e valori.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/integrate-idp.html)
1. Configura l'URL Assertion Consumer Service (ACS) del gestore di identità in modo che punti al tuo URL di accesso SAML personalizzato. Utilizza il seguente esempio per l'URL 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. Imposta i seguenti campi nei parametri dell'URL:
+ `instanceId`: l'identificativo dell'istanza Amazon Connect. Per istruzioni su come trovare l'ID dell'istanza, consulta [Trovare l’ID o l’ARN dell’istanza Amazon Connect](find-instance-arn.md).
+ `accountId`: l'ID AWS dell'account in cui si trovano le istanze di Amazon Connect.
+ `role`: è impostato sul nome o sul nome della risorsa Amazon (ARN) del ruolo SAML utilizzato per la federazione Amazon Connect.
+ `idp`: è impostato sul nome o sul nome della risorsa Amazon (ARN) del gestore di identità SAML in IAM.
+ `destination`: è impostato sul percorso opzionale che gli agenti utilizzeranno per accedere all'istanza dopo aver eseguito l'accesso (ad esempio: `/agent-app-v2`).
# Associa agenti a istanze Amazon Connect in più AWS regioni
Per consentire ai tuoi agenti di accedere a entrambe le regioni Regioni AWS ed elaborare i contatti di entrambe le regioni, devi prima assegnarli a un gruppo di distribuzione del traffico.
1. Se non hai ancora creato un gruppo di distribuzione del traffico, fallo ora. Per istruzioni, consulta [Crea gruppi di distribuzione del traffico per la tua istanza Amazon Connect](setup-traffic-distribution-groups.md).
1. Puoi assegnare agenti a un gruppo di distribuzione del traffico che è stato creato correttamente (`Status` è `ACTIVE`). Associa sempre gli utenti a un gruppo di distribuzione del traffico nella regione di origine.
L'assegnazione di un agente a un gruppo di distribuzione del traffico che non si trova nello stato `ACTIVE` restituisce un errore `ResourceNotFoundException`. Utilizza l'[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API per determinare se è stata creata correttamente (`Status`deve `ACTIVE` esserlo).
1. È possibile assegnare un agente a un gruppo di distribuzione del traffico chiamando l'[AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API.
## Esempi
Il comando di `associate-traffic-distribution-group-user` esempio seguente mostra come gli agenti possono essere associati e utilizzati in più AWS regioni.
```
aws connect associate-traffic-distribution-group-user
--traffic-distribution-group-id UUID
--user-id UUID
--instance-id
```
L'[AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)esempio seguente associa un agente a un gruppo di distribuzione del traffico.
```
PUT /traffic-distribution-group/trafficDistributionGroupId/user HTTP/1.1
Content-type: application/json
{
"UserId": "string"
}
```
Il seguente comando `disassociate-traffic-distribution-group-user` di esempio rimuove l'associazione di un agente a un gruppo di distribuzione del traffico.
```
aws connect disassociate-traffic-distribution-group-user
--instance-id your instance ID
--traffic-distribution-group-id UUID
--user-id UUID
```
L'[DisassociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_DisassociateTrafficDistributionGroupUser.html)esempio seguente dissocia un agente da un gruppo di distribuzione del traffico.
```
DELETE /traffic-distribution-group/trafficDistributionGroupId/user/UserId HTTP/1.1
```
## Perché una chiamata non riesce AssociateTrafficDistributionGroupUser
Una chiamata [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API ha esito negativo con un `ResourceNotFoundException` nei seguenti casi:
1. La distribuzione del traffico specificata non esiste.
1. Lo stato del gruppo di distribuzione del traffico non è `ACTIVE`.
1. `user-id UUID` non è un utente dell'istanza Amazon Connect di origine.
# Aggiorna la distribuzione degli agenti nell'area di lavoro degli agenti Amazon Connect tra le regioni AWS
È possibile utilizzare l'API `UpdateTrafficDistribution` non solo per [distribuire il traffico di telefonia tra regioni](update-telephony-traffic-distribution.md), ma anche per distribuire gli agenti tra regioni AWS , in modo completo o graduale, nell'ambito dei normali test di prontezza operativa. Ad esempio, è possibile mantenere il 40% degli agenti in una AWS regione per completare i contatti attivi e spostare gli agenti rimanenti nella regione di replica.
**Nota**
Quando sposti il traffico di telefonia, trasferisci anche gli accessi degli and/or agenti per assicurarti che possano gestire le chiamate nell'altra regione. Se non sposti gli agenti, le chiamate vocali verranno trasferite nella Regione modificata, ma non ci saranno agenti disponibili a ricevere le chiamate.
Dopo aver aggiunto gli agenti al gruppo di distribuzione del traffico, utilizza l'[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API per distribuire gli agenti tra le istanze collegate in un determinato gruppo di distribuzione del traffico con incrementi del 10%. Gli agenti saranno in grado di completare i contatti vocali attivi prima di cambiare regione.
**Nota**
Se un agente riceve un errore quando tenta di terminare un contatto prima di cambiare Regione, deve aggiornare la pagina dello spazio di lavoro dell’agente. Per ulteriori informazioni, consulta [Configura Amazon Connect Agent Workspace per supportare gli agenti che si spostano da una regione all'altra AWS](setup-agentworkspace-switchover.md).
**Topics**
+ [Requisiti](#update-agent-traffic-distribution-requirements)
+ [Abilita entrambe le Regioni durante le normali operazioni](#change-signin-weights)
+ [Come spostare tutto il traffico e gli agenti di telefonia tra le regioni AWS](#shift-all-traffic)
+ [Banner regionale dell'interfaccia utente dello switch](#regional-switch-ui-banner)
## Requisiti
Se i seguenti requisiti non vengono soddisfatti, la chiamata [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API avrà esito negativo e verrà visualizzato un messaggio: `InvalidRequestException`
1. Il gruppo di distribuzione del traffico specificato deve esistere.
1. Lo stato del gruppo di distribuzione del traffico deve essere `ACTIVE`.
1. È possibile modificare la distribuzione `SignInConfig` solo per il gruppo di distribuzione del traffico predefinito. Il gruppo di distribuzione del traffico predefinito viene creato insieme all'istanza Amazon Connect di replica. Vedi il `IsDefault` parametro nel tipo di [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html)dati.
Quando si chiama `UpdateTrafficDistribution` dalla regione AWS di origine, è possibile utilizzare l'ID del gruppo di distribuzione del traffico o il nome della risorsa Amazon (ARN). Quando si chiama `UpdateTrafficDistribution` nella regione della replica, è necessario utilizzare l'ARN del gruppo di distribuzione del traffico.
## Abilita entrambi Regioni AWS durante le normali operazioni
L'API `UpdateTrafficDistribution` include una distribuzione chiamata `SignInConfig`. Consente di scegliere quali server di accesso di back-end utilizzare per facilitare l'accesso dell'agente al relativo gruppo di istanze. Indipendentemente dal valore `SignInConfig` impostato nel gruppo di distribuzione del traffico, gli agenti effettueranno l'accesso a entrambe le istanze del gruppo di distribuzione del traffico.
Per un'esperienza ottimale, consigliamo di abilitare entrambe le AWS regioni durante le normali operazioni. A tal fine, seleziona `true` per entrambe le distribuzioni `SignInConfig`. Se devi trasferire l'intero traffico di telefonia e gli agenti in un'unica AWS regione, ti consigliamo di passare `SignInConfig` alla `false` regione da cui stai spostando il traffico.
Ad esempio, la chiamata seguente fa sì che gli agenti abbiano il 50% di probabilità di utilizzare il server di accesso us-west-2 e il 50% di utilizzare quello us-east-1 per una determinata chiamata di accesso da parte del gestore di 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
}
]
}
}'
```
Al contrario, la seguente distribuzione di accesso instrada il 100% del traffico sull'endpoint di accesso per l'utilizzo del server di accesso 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
}
]
}
}'
```
Questa distribuzione controlla solo la regione del server di accesso utilizzata per facilitare l'accesso dell'agente a entrambe le istanze del gruppo di istanze. Non influisce sulla distribuzione degli agenti, controllata dalla parte `AgentConfig` dell'API `UpdateTrafficDistribution`.
**Importante**
Se l'endpoint di accesso non risponde durante l'accesso dell'agente e la distribuzione `SignInConfig` è suddivisa tra regioni, puoi risolvere gli errori modificando la distribuzione in un'unica regione AWS . In alternativa, se il valore `SignInConfig` è ponderato per una regione e questa non risponde, puoi provare a spostare `SignInConfig` nella regione disabilitata. Indipendentemente dalla configurazione del valore `SignInConfig`, gli agenti trarranno comunque beneficio dall'avere una sessione attiva sia nella regione di origine che in quella di replica, perché tenteranno di accedere alla propria istanza Amazon Connect in entrambe le regioni.
## Come spostare tutto il traffico e gli agenti di telefonia tra le regioni AWS
Per spostare tutti i nuovi contatti vocali in entrata, la distribuzione degli accessi degli agenti e la distribuzione degli agenti da us-west-2 a us-east-1, utilizza il seguente frammento di codice.
```
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
}
]
}
}
'
```
Quando si chiama `UpdateTrafficDistribution` dalla regione AWS di origine, è possibile utilizzare l'ID del gruppo di distribuzione del traffico o il nome della risorsa Amazon (ARN). Quando si chiama `UpdateTrafficDistribution` nella regione della replica, è necessario utilizzare l'ARN del gruppo di distribuzione del traffico.
## Banner Regional Switch UI
Agent Workspace e CCP forniranno un banner dell'interfaccia utente che evidenzia il cambio di regione.
Se un agente è collegato **a un contatto** quando la sua regione cambia a causa di modifiche al Traffic Distribution Group (TDG), vedrà un banner simile al seguente. Una volta completato il contatto vocale e chiuso lo stato ACW, l'agente si aggiornerà automaticamente alla nuova regione, senza che sia necessaria alcuna azione. Se l'agente ha problemi a chiudere il contatto, può selezionare **Continua nel Backup** e verrà visualizzato un popup che richiede la conferma del passaggio alla regione alternativa.
Ti consigliamo di modificare il libretto di istruzioni e la guida alla formazione degli agenti in modo da rispecchiare questa situazione
![\[L'interfaccia utente di Agent Workspace mostra un banner che evidenzia il failover regionale durante le regolazioni del TDG.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/acgr-failover-banner.png)
![\[Il popup di conferma che appare quando un agente seleziona Continua nel backup.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/acgr-failover-confirmation.png)
# Configura Amazon Connect Agent Workspace per supportare gli agenti che si spostano da una regione all'altra AWS
Esegui i seguenti passaggi per consentire ad Amazon Connect Agent Workspace di incorporare il Pannello di controllo dei contatti dalla regione di replica alla AWS regione di origine e passare da uno all'altro quando cambia la regione attiva dell'agente.
Se non hai ancora creato una replica dell'istanza Amazon Connect di origine o non hai ancora configurato un gruppo di distribuzione del traffico, consulta [Nozioni di base su Amazon Connect Global Resiliency](get-started-connect-global-resiliency.md).
1. Vai alla console AWS Amazon Connect per recuperare l'**URL di accesso** per la tua istanza di origine. Prendi nota dell'URL.
1. Nella regione di replica, la console AWS Amazon Connect per recuperare l'**URL di accesso per l'istanza** di replica. Prendi nota dell'URL.
1. Nella stessa finestra dell'istanza Amazon Connect di replica, seleziona **Origini approvate** nel riquadro a sinistra.
1. Aggiungi il dominio per l'**URL di accesso** dell'istanza di origine, come indicato nel passaggio 1.
**Nota**
Non includere un **/** finale nell'URL di accesso.
1. Ripeti i passaggi precedenti sull'istanza di origine: vai a **Origini approvate** e aggiungi l'URL di accesso per l'istanza di replica.
**Nota**
Gli agenti devono impostare il proprio stato su **Disponibile** dopo il trasferimento da una regione all'altra.
# Suggerimenti per evitare problemi quando si spostano gli agenti nell’istanza tra Regioni di Amazon Connect
+ Ogni volta che aggiorni la distribuzione del traffico per gli agenti, assicurati di aggiornare anche la distribuzione del traffico per i contatti vocali in entrata. In caso contrario, potresti ritrovarti in una situazione in cui una regione con molti agenti e un'altra con un eccessivo traffico di telefonia.
+ Prima di associare gli utenti a un gruppo di distribuzione del traffico, accertati che lo stesso nome utente esista nelle istanze Amazon Connect di origine e di replica. Se non lo fai, quando associ un utente a un gruppo di distribuzione del traffico ma il suo nome utente non esiste nella regione di replica, riceverai un errore `InvalidRequestException`.
+ È necessario chiamare l'[AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html)API per associare gli agenti a un gruppo di distribuzione del traffico nella regione di origine. Se tenti di eseguire questa operazione mentre ti trovi nella regione di replica, riceverai un errore `ResourceNotFoundException`.
# Gestisci i gruppi di distribuzione del traffico con Amazon Connect APIs
Gli argomenti di questa sezione descrivono come gestire i gruppi di distribuzione del traffico utilizzando Amazon Connect APIs.
**Topics**
+ [Elencazione dei gruppi di distribuzione del traffico](list-traffic-distribution-groups.md)
+ [Eliminazione dei gruppi di distribuzione del traffico](delete-traffic-distribution-groups.md)
# Elencazione dei gruppi di distribuzione del traffico
Utilizza l'[ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html)API per elencare tutti i gruppi di distribuzione del traffico.
L'elenco dei gruppi di distribuzione del traffico è utile per stabilire se una particolare istanza di Amazon Connect fa parte di un gruppo di distribuzione del traffico.
# Eliminazione dei gruppi di distribuzione del traffico in Amazon Connect
Utilizza l'[DeleteTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html)API per eliminare un gruppo di distribuzione del traffico che non è più necessario.
**Nota**
Non è possibile eliminare un gruppo di distribuzione del traffico a cui sono associati numeri di telefono richiesti. È innanzitutto necessario rilasciare i numeri di telefono del gruppo di distribuzione del traffico utilizzando l'[ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html)API. Dopodiché sarà possibile eliminare il gruppo di distribuzione del traffico.
Non è possibile rilasciare numeri da un gruppo di distribuzione del traffico utilizzando la console di Amazon Connect.
La chiamata [DeleteTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html)API fallirà con un `ResourceInUseException` se i numeri di telefono sono ancora rivendicati al gruppo di distribuzione del traffico.
# Gestisci i numeri di telefono in tutte le regioni con Amazon Connect APIs
Gli argomenti di questa sezione descrivono come gestire i numeri di telefono Regioni AWS utilizzando Amazon Connect APIs.
**Topics**
+ [Richiedi i numeri di telefono a più istanze Regioni AWS](claim-phone-number-multiple-regions.md)
+ [Sposta un numero di telefono richiesto su più istanze Regioni AWS](move-phone-number-multiple-regions.md)
+ [Rilascio di numeri dai gruppi di distribuzione del traffico](release-numbers-traffic-distribution-group.md)
# Richiedi i numeri di telefono alle istanze Amazon Connect su più istanze Regioni AWS
**Nota**
**Nuovo utente?** Dai un’occhiata all’[Amazon Connect Global Resiliency Workshop](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Questo corso online ti guida attraverso il processo di onboarding e test del numero di telefono e del failover dell'agente utilizzando la nuova funzionalità tramite APIs l'interfaccia a riga di comando di AWS.
Global Resiliency è disponibile solo per le istanze Amazon Connect create nelle seguenti AWS regioni: Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Asia Pacifico (Osaka), Asia Pacifico (Tokyo), Europa (Francoforte) ed Europa (Londra).
È possibile creare una replica nella Regione Stati Uniti orientali (Virginia settentrionale) solo se l’origine è Stati Uniti occidentali (Oregon) o viceversa.
È possibile creare una replica nella Regione Europa (Francoforte) solo se l’origine è l’Europa (Londra) o viceversa.
È possibile creare una replica nella Regione Asia Pacifico (Osaka) solo se l’origine è Asia Pacifico (Tokyo).
Per accedere a questa funzionalità, contatta il Solutions Architect o il Technical Account Manager Amazon Connect.
Per effettuare o ricevere chiamate verso un numero di telefono tra più istanze in più istanze Regioni AWS, devi richiedere un numero di telefono a un gruppo di distribuzione del traffico.
**Per richiedere un numero di telefono a un gruppo di distribuzione del traffico:**
1. Crea un gruppo di distribuzione del traffico utilizzando l'[CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)API.
1. Descrivi il tuo gruppo di distribuzione del traffico utilizzando l'[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API per determinare se è stato creato correttamente (`Status`deve esserlo`ACTIVE`).
1. Dopo che il gruppo di distribuzione del traffico è stato creato con successo (`Status`is`ACTIVE`), puoi richiedergli i numeri di telefono utilizzando l'[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API.
# Sposta un numero di telefono dichiarato su più istanze Amazon Connect su più istanze di Amazon Connect Regioni AWS
**Nota**
**Nuovo utente?** Dai un’occhiata all’[Amazon Connect Global Resiliency Workshop](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Questo corso online ti guida attraverso il processo di onboarding e test del numero di telefono e del failover dell'agente utilizzando la nuova funzionalità tramite APIs l'interfaccia a riga di comando di AWS.
Global Resiliency è disponibile solo per le istanze Amazon Connect create nelle seguenti AWS regioni: Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Asia Pacifico (Osaka), Asia Pacifico (Tokyo), Europa (Francoforte) ed Europa (Londra).
È possibile creare una replica nella Regione Stati Uniti orientali (Virginia settentrionale) solo se l’origine è Stati Uniti occidentali (Oregon) o viceversa.
È possibile creare una replica nella Regione Europa (Francoforte) solo se l’origine è l’Europa (Londra) o viceversa.
È possibile creare una replica nella Regione Asia Pacifico (Osaka) solo se l’origine è Asia Pacifico (Tokyo).
Per accedere a questa funzionalità, contatta il Solutions Architect o il Technical Account Manager Amazon Connect.
Puoi trasferire un numero di telefono precedentemente richiesto a un'istanza e assegnarlo a più istanze tra Regioni AWS. Puoi farlo assegnando il numero di telefono a un gruppo di distribuzione del traffico.
**Per assegnare un numero di telefono a un gruppo di distribuzione del traffico:**
1. Crea un gruppo di distribuzione del traffico utilizzando l'API. [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)
1. Descrivi il tuo gruppo di distribuzione del traffico utilizzando l'[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API per determinare se è stato creato correttamente (`Status`deve esserlo`ACTIVE`).
1. Dopo che il gruppo di distribuzione del traffico è stato creato correttamente (`Status` è `ACTIVE`), puoi assegnare i numeri di telefono precedentemente dichiarati ad altre istanze o altri gruppi di distribuzione del traffico. Utilizza l'API di [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html).
# Rilascio di numeri di telefono in Amazon Connect dai gruppi di distribuzione del traffico
Per rilasciare i numeri di telefono di un gruppo di distribuzione del traffico, utilizza l'[ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html)API. Il numero viene rilasciato all'inventario in modo che altri clienti possano richiederlo.
Non è possibile rilasciare numeri da un gruppo di distribuzione del traffico utilizzando la console di Amazon Connect.
# Gestione della chat nella tua istanza Amazon Connect tra Regioni
Puoi gestire la chat tra AWS le regioni creando due interfacce di chat personalizzate o due widget di out-of-the-box comunicazione: uno nella regione di origine e l'altro nella regione di replica. Puoi passare manualmente da una all'altra a seconda dell'interfaccia di chat o del widget di out-of-the-box comunicazione della regione che desideri utilizzare.
+ Interfacce di chat personalizzate: configura l’interfaccia di chat nella Regione di replica per utilizzare l’endpoint API della Regione di replica. Per esempi di interfacce personalizzate, consulta la [libreria open source Amazon Connect](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master) su GitHub. Per ulteriori informazioni, consulta [Personalizzare la chat con l’esempio open source di Amazon Connect](download-chat-example.md).
+ Out-the-box widget di comunicazione: crea un widget di comunicazione nell'istanza Amazon Connect replica. Per istruzioni, consulta [Configurazione di un widget di comunicazione nell’istanza di replica](#communicationswidget-multiple-regions).
Di seguito sono riportati i parametri di configurazione della chat richiesti nel tuo sito web o nella tua app per avviare una chat lato client:
+ **ID dell’istanza** e **ID del flusso** di Amazon Connect: questi parametri sono gli stessi nelle Regioni di origine e di replica.
+ ** AWS Regione di destinazione** e in genere un **endpoint API** per avviare la chat (ovvero per acquisire il token partecipante): questi parametri sono diversi nelle regioni di origine e di replica.
Ad esempio, il diagramma seguente mostra come la configurazione della chat deve essere aggiornata in modo che punti al Gateway API nella Regione di replica quando il traffico della chat deve essere spostato tra Regioni.
![\[Un diagramma che mostra la Regione di origine e la Regione di replica.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/chatconfig.png)
## Configurazione di un widget di comunicazione nell’istanza di replica
1. Sulla tua istanza Amazon Connect di origine, crea un widget di comunicazione per la chat, se non ne esiste già uno. Per istruzioni, consulta [Aggiungere un’interfaccia utente di chat a un sito web ospitato da Amazon Connect](add-chat-to-website.md).
1. Sulla tua istanza di replica, crea un altro widget di comunicazione per la chat. Configura il widget con lo stesso flusso utilizzato nel widget sull’istanza di origine. Il flusso è già nell’istanza di replica perché Amazon Connect Global Resiliency copia tutti i flussi dall’origine alla replica e li mantiene continuamente sincronizzati.
1. Copia il nuovo script del widget di comunicazione che hai creato nell’istanza di replica. Incorpora lo script nel sito web o nell’app da attivare quando il traffico della chat viene inoltrato all’istanza di replica.
1. Per spostare il traffico tra le Regioni, sostituisci il widget di comunicazione dell’istanza di origine con il widget di comunicazione dell’istanza di replica nella tua pagina web.
Nell’immagine seguente è riportato un widget di esempio.
![\[Un esempio di script di widget di comunicazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/source-comwidget.png)
1. Se apporti modifiche al widget di comunicazione nell’istanza di origine in un secondo momento, devi apportare le stesse modifiche anche al widget di comunicazione nell’istanza di replica.
## Opzione per aggiungere maggiore fluidità
Per semplificare lo spostamento del traffico di chat tra Regioni e per richiedere meno modifiche manuali, ecco un altro modo per personalizzare la tua esperienza di chat:
1. Aggiungi un parametro a un database controllato centralmente (ad esempio, una tabella globale di DynamoDB). Lo scopo di questo parametro è definire quale Regione è attualmente attiva.
1. Aggiorna il sito web o l’applicazione per verificare lo stato del parametro Regione nel database centrale.
1. A seconda della Regione attiva, il sito web o l’applicazione utilizzeranno l’endpoint API o il widget di comunicazione di quella Regione.
1. Questo parametro deve essere aggiornato contemporaneamente alla chiamata dell'[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API per spostare il traffico vocale e gli agenti tra le regioni, ove applicabile.
# Metriche, report e ricerca nelle regioni ACGR
Gli argomenti di questa sezione descrivono metriche, report e ricerche consolidati Regioni AWS per i clienti di Amazon Connect Global Resiliency (ACGR).
**Topics**
+ [Ricerca di contatti e dettagli di contatto](contact-search-and-contact-details.md)
+ [Metriche consolidate in tutte le regioni](consolidated-metrics-across-regions.md)
# Ricerca di contatti e dettagli di contatto
**Importante**
[Per abilitare la ricerca consolidata dei contatti per la tua istanza ACGR, contatta l'assistenza AWS .](https://console.aws.amazon.com/support/home)
**Importante**
Quando accedi a questa funzionalità, il tuo alias Amazon Connect verrà aggiornato in un nuovo sottodominio con il formato. `region.sourcealias.my.connect.aws` Ad esempio, se la tua istanza ACGR è distribuita negli Stati Uniti orientali (Virginia settentrionale) e negli Stati Uniti occidentali (Oregon) con alias di origine configurato come `source.my.connect.aws` e alias di replica, dopo aver effettuato l'`replica.my.connect.aws`onboarding delle istanze Amazon Connect a questa funzione, utilizzerai and. `us-east-1.source.my.connect.aws` `us-west-2.source.my.connect.aws` Assicurati di aggiornare le regole del firewall e le integrazioni di terze parti per utilizzare questi nuovi sottodomini.
Quando accedi alla pagina di ricerca dei contatti, per impostazione predefinita vengono visualizzati i contatti delle istanze Amazon Connect Global Resiliency (ACGR) accoppiate, offrendoti una visione completa delle interazioni con i clienti all'interno dell'organizzazione. Ciò fornisce un'esperienza di ricerca senza interruzioni indipendentemente dalla regione da cui provengono i contatti o dalla regione a cui sei attualmente connesso.
+ **Regione attiva**: la posizione Regione AWS in cui un contatto viene elaborato o è stato completato.
## Esperienza di ricerca dei contatti
### Filtro regionale attivo
Vedrai un nuovo filtro «Regione attiva» nel menu a discesa dei filtri. Ciò ti consente di restringere la ricerca a una regione specifica quando necessario.
Per utilizzare il filtro Regione attiva:
1. Nella **pagina di ricerca dei contatti**, scegli **Aggiungi filtro**.
1. Seleziona **Regione attiva** dal menu a discesa.
1. Scegli una o più regioni.
![\[Il menu a discesa del filtro per la regione attiva mostra le regioni disponibili da selezionare.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/active-region-filter.png)
### Filtri di risorse specifici per regione
Quando utilizzi i seguenti filtri, le opzioni del menu a discesa visualizzano solo le risorse create nell'area in cui hai effettuato l'accesso:
+ Attributi di contatto personalizzati
+ Categorie di contatto
+ Filtri di valutazione
+ Indirizzo e-mail
+ Attributi personalizzati del segmento di contatto
**Importante**
Se digiti manualmente i valori del filtro anziché selezionarli dai menu a discesa e i nomi delle risorse sono identici in tutte le istanze ACGR, i risultati includeranno i contatti di entrambe le regioni.
Attributi di contatto personalizzati
Indirizzo e-mail
**I filtri di valutazione** restituiscono solo i contatti della tua regione attuale, poiché eseguono la ricerca utilizzando un modulo IDs di valutazione unico specifico della regione.
### Ricerche salvate
Le ricerche salvate mostrano i contatti di entrambe le istanze ACGR. Tutti i filtri regionali salvati in precedenza continuano a funzionare come previsto.
## Informazioni di contatto, esperienza
### Visualizzazione delle informazioni di contatto
Quando si apre una pagina dei dettagli di contatto, vengono visualizzate informazioni complete indipendentemente dalla regione da cui proviene il contatto, tra cui:
+ Panoramica, dettagli di connessione e informazioni sulla coda
+ Tag e attributi dei contatti
+ Dati relativi alle lenti a contatto (analisi conversazionali, trascrizioni vocali, trascrizioni di chat)
+ Registrazioni dello schermo e dell'audio
+ Trascrizioni delle chat e interazioni IVR
+ Allegati e trascrizioni delle e-mail
La regione attiva del contatto viene visualizzata nella pagina dei dettagli di contatto sotto Metadati di resilienza **globale**.
![\[La pagina dei dettagli di contatto che mostra la sezione dei metadati di resilienza globale con le informazioni sulla regione attiva.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/global-resiliency-metadata.png)
**Nota**
Se la regione attiva del contatto è compromessa, alcune informazioni potrebbero non essere disponibili, tra cui le registrazioni dello schermo e dell'audio, le trascrizioni delle chat, le interazioni IVR, gli allegati e le trascrizioni delle e-mail e i dati delle lenti a contatto.
### Accesso ai dati delle lenti a contatto
Hai pieno accesso ai dati sulle lenti a contatto in tutte le regioni, tra cui:
+ Contatti in corso: analisi conversazionali, trascrizioni vocali (redatte e non redatte) e trascrizioni delle chat.
+ Contatti completati: tutte le analisi delle conversazioni, le trascrizioni vocali (redatte e non redatte) e le trascrizioni delle chat.
+ Registrazioni: le registrazioni dello schermo e dell'audio sono accessibili indipendentemente dalla regione attiva del contatto.
+ Trascrizioni: le trascrizioni di chat, IVR ed e-mail sono disponibili in tutte le regioni.
### Azioni di contatto
È possibile eseguire azioni di contatto come Trasferimento, Riprogrammazione o Termina contatto indipendentemente dalla regione attiva del contatto. Queste azioni vengono indirizzate alla regione attiva del contatto.
### Valutazioni dei contatti
Le valutazioni dei contatti sono disponibili solo per i contatti attivi nella regione in cui hai effettuato l'accesso. Non è possibile visualizzare o eseguire valutazioni per contatti replicati da altre regioni.
### SearchContacts API
Se utilizzi l' SearchContacts API a livello di codice, la risposta include informazioni aggiuntive:
+ GlobalResiliencyMetadata oggetto: contiene i `TrafficDistributionGroupId` campi `ActiveRegion``OriginRegion`, e per tutti i contatti, che mostrano la regione specifica in cui il contatto è attivo.
Per ulteriori informazioni sull' SearchContacts API, consulta l'[Amazon Connect API Reference](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchContacts.html).
# Metriche consolidate tra le regioni
**Importante**
[Per abilitare le metriche consolidate relative agli agenti e ai contatti per la tua istanza ACGR, contatta l'assistenza.AWS](https://console.aws.amazon.com/support/home)
Quando visualizzi i parametri in Amazon Connect, vedi una visione consolidata dei parametri relativi agli agenti e ai contatti in tutte le regioni abbinate, indipendentemente dalla regione a cui sei attualmente connesso.
Ad esempio, se hai 5 agenti collegati a us-east-1 e disponibili per, e 10 agenti collegati a us-west-2 e disponibili BasicQueue per, la pagina delle metriche in tempo reale mostra un totale BasicQueue di 15 agenti online. Questa visualizzazione consolidata consente di monitorare le operazioni del contact center all'interno di un'unica interfaccia.
## Metriche disponibili
La visualizzazione consolidata è disponibile per:
+ Metriche in tempo reale: visualizza l'attività corrente degli agenti e le metriche di contatto nelle tue istanze ACGR.
+ Metriche storiche: accedi ai dati storici sulle prestazioni tra le istanze ACGR.
+ Metriche APIs: le risposte delle API restituiscono metriche consolidate tra le istanze ACGR.
**Nota**
Le metriche relative agli agenti e ai contatti sono consolidate in tutte le regioni. Altre metriche, come l'analisi, rimangono specifiche per regione.
Per ulteriori informazioni sui report di Amazon Connect, consulta[Metriche, dashboard e report in Amazon Connect](amazon-connect-metrics.md).