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à.
# Richiedi i numeri di telefono ai gruppi di distribuzione del traffico utilizzando Connect Customer
**Nota**
**Nuovo utente?** Dai un'occhiata al [Workshop Connect Customer Global Resiliency](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 nuove API tramite l’interfaccia a riga di comando di AWS.
Global Resiliency è disponibile solo per le istanze Connect Customer 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à, contattate il vostro Connect Customer Solutions Architect o il Technical Account Manager.
Dopo aver creato correttamente il gruppo di distribuzione del traffico (`Status`is`ACTIVE`), puoi [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)utilizzarlo per cercare i numeri di telefono disponibili e [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)richiederli.
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**, è necessario utilizzare la console Connect Customer.
## 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. Nell'istanza Connect Customer esistente nella regione in cui è stato creato il gruppo di distribuzione del traffico, procedi come segue:
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. Viene restituito un elenco di ARN del flusso. Usa questi ARN di flusso 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 Connect Customer replicata nell'altra AWS regione, procedi come segue:
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. Viene restituito un elenco di ARN del flusso. Usa questi ARN di flusso 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.