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à.
# 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 new through AWS APIs CLI.
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.