Come posso risolvere gli errori del softphone in Amazon Connect CCP?

Breve descrizione

Gli errori del softphone si verificano quando Amazon Connect CCP non è in grado di comunicare con uno dei seguenti endpoint richiesti:

• Endpoint di segnalazione
• Endpoint multimediali
• Endpoint API

Risoluzione

Per risolvere gli errori del softphone da Amazon CCP, completa le seguenti azioni:

• Verifica se il traffico verso il dominio dell'endpoint indicato nel messaggio di errore è bloccato. Se il traffico è bloccato, sostituisci i requisiti dell'intervallo IP di Amazon Elastic Compute Cloud (Amazon EC2) e Amazon CloudFront con un elenco di domini consentiti.
• Verifica se la porta richiesta per il dominio dell'endpoint indicato nel messaggio di errore è aperta sul firewall di rete.
• Se consenti gli intervalli di indirizzi IP, controlla se tutti gli indirizzi IP utilizzati da Amazon Connect sono presenti nelle liste di indirizzi IP consentiti richieste.
• Verifica se la connessione di rete consente ad Amazon Connect CCP di mantenere una connessione con gli endpoint richiesti.
• Utilizza Amazon Connect Endpoint Test Utility per verificare se l'agente con il problema ha una connessione stabile.
• Controlla la comunicazione tra Amazon Connect e gli endpoint di segnalazione, gli endpoint multimediali e gli endpoint API.

Endpoint di segnalazione

I seguenti messaggi di errore sono esempi di errori degli endpoint di segnalazione che potresti ricevere:

• "softphone ERROR {your contact ID} SESSION Failed connecting to signaling server Timeout"
• "softphone ERROR Softphone error occurred : signalling_connection_failure URL {signaling endpoint URL} cannot be reached"

Per comunicare con gli endpoint di segnalazione, aggiungi i seguenti URL all'elenco degli indirizzi consentiti tramite la porta 443 (TCP):

• Per CCP v1: rtc*.connect-telecom.REGION.amazonaws.com
• Per CCP v2: *.transport.connect.REGION.amazonaws.com

Per ulteriori informazioni, consulta Esegui l'upgrade alla versione più recente di Amazon Connect Contact Control Panel (CCP).

Endpoint multimediali

I seguenti messaggi di errore sono esempi di errori degli endpoint multimediali che potresti ricevere:

• "softphone WARN {your contact ID} SESSION ICE collection timed out"
• "softphone ERROR {your contact ID} SESSION No ICE candidate"
• "softphone INFO {your contact ID} SESSION ConnectSignalingAndIceCollectionState => FailedState"
• "softphone ERROR Softphone error occurred : ice_collection_timeout Ice collection timedout"

Per comunicare con gli endpoint multimediali, aggiungi l'URL TurnNlb-*.elb.REGION.amazonaws.com all'elenco degli indirizzi consentiti tramite la porta 3478 (UDP).

Endpoint API

I seguenti messaggi di errore sono esempi di errori degli endpoint API che potresti ricevere:

• "ccp ERROR 'acceptContact' API request failed: [object Object]"
• "ccp TRACE AWSClient: < Operation 'acceptContact' failed: {"message":"Network Failure","code":"NetworkingError","time":"....""

Nota: per trasformare i log CCP grezzi in un formato leggibile, utilizza CCP Log Parser. Per ulteriori informazioni, consulta CCP Log Parser sul sito web GitHub.

Per comunicare con gli endpoint API, aggiungi i seguenti URL all'elenco degli indirizzi consentiti tramite la porta 443 (TCP):

• *.telemetry.connect.REGION.amazonaws.com
• INSTANCE_NAME.my.connect.aws/ccp-v2
• INSTANCE_NAME.my.connect.aws/api
• *.static.connect.aws
• INSTANCE_NAME.awsapps.com/connect/ccp-v2
• INSTANCE_NAME.awsapps.com/connect/api
• *.cloudfront.net

Nota: sostituisci INSTANCE_NAME con il nome della tua istanza. Sostituisci REGION con la Regione AWS in cui si trova la tua istanza Amazon Connect. Per ulteriori informazioni, consulta Configura la tua rete per utilizzare Amazon Connect Contact Control Panel (CCP).

Informazioni correlate

Risoluzione dei problemi di Contact Control Panel (CCP)