Assegna i numeri di telefono dichiarati ai gruppi di distribuzione del traffico in Amazon Connect

PDFRSS

• Hai creato un nuovo gruppo di distribuzione del traffico e il suo stato è ACTIVE. Ti consigliamo di utilizzare l'DescribeTrafficDistributionGroupAPI 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'UpdatePhoneNumberAPI. 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'UpdatePhoneNumberAPI 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.

2. 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. Chiamata dell'API ListContactFlows. Fornisci l'InstanceId corrispondente all'istanza che è stata replicata.

      2. ARNs Viene restituito un elenco di flussi. Usa questi flussi ARNs per associare un flusso a un numero di telefono; chiama l'AssociatePhoneNumberContactFlowAPI.

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

      1. Chiamata dell'API ListContactFlows. Fornisci l'InstanceId corrispondente all'istanza che è stata replicata.

      2. ARNs Viene restituito un elenco di flussi. Usa questi flussi ARNs per associare un flusso a un numero di telefono; chiama l'AssociatePhoneNumberContactFlowAPI.

Perché una AssociatePhoneNumberContactFlow chiamata non riesce

Se il numero viene dichiarato a un gruppo di distribuzione del traffico e si sta chiamando AssociatePhoneNumberContactFlowutilizzando 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 non riesce UpdatePhoneNumber

La chiamata UpdatePhoneNumberAPI 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.

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

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