View a markdown version of this page

Assegna i numeri di telefono richiesti ai gruppi di distribuzione del traffico in Connect Customer - Cliente Amazon Connect

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

Assegna i numeri di telefono richiesti ai gruppi di distribuzione del traffico in Connect Customer

  • 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 richiesti 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, è necessario utilizzare la console Connect Customer.

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

    TargetArnPuò essere per un'altra istanza di Connect Customer o per un gruppo di distribuzione del traffico creato nella stessa regione in cui il numero di telefono è stato inizialmente richiesto.

  2. 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. Nell'istanza Connect Customer esistente nella regione in cui è stato creato il gruppo di distribuzione del traffico, procedi come segue:

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

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

    L'associazione del numero di telefono al flusso verrà rispecchiata tra le istanze di Connect Customer nelle diverse regioni. AWS

Perché una chiamata non va a buon fine AssociatePhoneNumberContactFlow

Se il numero viene richiesto a un gruppo di distribuzione del traffico e si chiama AssociatePhoneNumberContactFlow utilizzando un'istanza in Regione AWS cui è stato creato il gruppo di distribuzione del traffico, è possibile utilizzare un valore ARN o UUID del numero di telefono completo per il parametro di richiesta PhoneNumberId URI.

Tuttavia, se il numero viene richiesto 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 UpdatePhoneNumber chiamata non riesce

La tua chiamata UpdatePhoneNumber 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.

UpdatePhoneNumberfallirà con un InvalidParameterException errore nel seguente caso:

  • 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'UpdatePhoneNumberoperazione precedente ClaimPhoneNumber o è riuscita.

  • IN_PROGRESSsignifica a ClaimPhoneNumber, UpdatePhoneNumber l'operazione è ancora in corso e non è ancora stata completata. Puoi chiamare DescribePhoneNumber in un secondo momento per verificare se l'operazione precedente è stata completata.

  • FAILEDindica che l'UpdatePhoneNumberoperazione ClaimPhoneNumber precedente è fallita. È 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.