Richiedi i numeri di telefono ai gruppi di distribuzione del traffico utilizzando Amazon Connect - Amazon Connect
Flusso di lavoro di esempioPerché una ClaimPhoneNumber chiamata fallisceDefinizione degli stati dei numeri di telefono

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 Amazon Connect

Nota

Nuovo utente? Dai un'occhiata all'Amazon Connect Global Resiliency Workshop. Questo corso online ti guida attraverso il processo di onboarding e test del numero di telefono e del failover dell'agente utilizzando new through. APIs AWS CLI

Global Resiliency è disponibile solo per le istanze Amazon Connect create nelle seguenti AWS regioni: Stati Uniti orientali (Virginia settentrionale), Stati Uniti occidentali (Oregon), Europa (Francoforte) ed Europa (Londra).

Puoi creare una replica nella regione Stati Uniti orientali (Virginia settentrionale) solo se la tua origine è Stati Uniti occidentali (Oregon) o viceversa. Analogamente, è possibile creare una replica nella regione Europa (Francoforte) solo se la fonte è l'Europa (Londra) o viceversa.

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 (StatusisACTIVE), puoi utilizzarlo per SearchAvailablePhoneNumberscercare i numeri di telefono disponibili e ClaimPhoneNumberrichiederli.

Prima di richiedere un numero di telefono al tuo gruppo di distribuzione del traffico, ti consigliamo di utilizzare il DescribeTrafficDistributionGroupAPIper verificare che lo stato del gruppo di distribuzione del traffico siaACTIVE. L'assegnazione di un numero di telefono a un gruppo di distribuzione del traffico che non è ACTIVE genera ResourceNotFoundException.

È possibile richiedere un numero di telefono a un gruppo di distribuzione del traffico fornendo il gruppo di distribuzione del traffico ARN nel TargetArnparametro quando si chiama il ClaimPhoneNumberAPI. Puoi anche utilizzare il UpdatePhoneNumberAPIper 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. Chiama il. ReplicateInstanceAPI

  2. Crea un gruppo di distribuzione del traffico che colleghi tra loro queste istanze:

    1. Chiama il CreateTrafficDistributionGroupAPI.

  3. Trova i numeri di telefono disponibili che possono essere richiesti al tuo gruppo di distribuzione del traffico:

    1. Chiamalo SearchAvailablePhoneNumbersAPInella regione in cui è stato creato il gruppo di distribuzione del traffico. Fornisci il gruppo di distribuzione del traffico ARN per il TargetArn parametro.

  4. Nella regione in cui è stato creato il gruppo di distribuzione del traffico, chiama ClaimPhoneNumberAPI:

    1. Fornisci il tuo gruppo di distribuzione del traffico ARN per il TargetArn parametro.

    2. Fornisci il valore del numero di telefono E164 restituito dalla SearchAvailablePhoneNumbersAPIchiamata nel passaggio 3.

    Vengono restituiti un PhoneNumberId e un PhoneNumberArn. È possibile utilizzare questi valori per le operazioni di follow-up.

  5. Verifica che lo stato del numero di telefono sia CLAIMED:

    1. Chiama il. DescribePhoneNumberAPI

      (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.

  6. Ripeti i passaggi da 3 a 5 per tutti i numeri di telefono che devi richiedere al tuo gruppo di distribuzione del traffico.

  7. 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 ListContactFlowsAPI. Fornisci l'InstanceId corrispondente all'istanza che è stata replicata.

      2. ARNsViene restituito un elenco di flussi. Usa questi flussi ARNs per associare un flusso a un numero di telefono; chiama il AssociatePhoneNumberContactFlowAPI.

    2. Nell'istanza Amazon Connect replicata nell'altra AWS regione, procedi nel seguente modo:

      1. Chiama ListContactFlowsAPI. Fornisci l'InstanceId corrispondente all'istanza che è stata replicata.

      2. ARNsViene restituito un elenco di flussi. Usa questi flussi ARNs per associare un flusso a un numero di telefono; chiama il AssociatePhoneNumberContactFlowAPI.

Perché una ClaimPhoneNumber chiamata fallisce

La ClaimPhoneNumberAPIchiamata avrà esito negativo 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 SearchAvailablePhoneNumberspotrebbe essere stato richiesto da un altro cliente.

ClaimPhoneNumberfallirà 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:

  • CLAIMEDindica che l'operazione precedente ClaimPhoneNumbero UpdatePhoneNumberl'operazione è riuscita.

  • IN_PROGRESSsignifica a ClaimPhoneNumber, UpdatePhoneNumberl'operazione è ancora in corso e non è stata ancora completata. È possibile chiamare DescribePhoneNumberin un secondo momento per verificare se l'operazione precedente è stata completata.

  • FAILEDindica che l'UpdatePhoneNumberoperazione precedente ClaimPhoneNumbero 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 hai ricevuto uno FAILED stato da una ClaimPhoneNumber API chiamata, hai un giorno di tempo per riprovare a richiedere il numero di telefono prima che il numero venga restituito all'inventario e che gli altri clienti possano richiederlo.