Comment résoudre les erreurs de téléphone logiciel Amazon Connect CCP ?

Brève description

Il existe trois types d'erreurs de point de terminaison Amazon Connect CCP. Toutes ces erreurs apparaissent dans les journaux Amazon Connect CCP sous la forme d'erreurs de téléphone logiciel comme dans les exemples suivants :

Erreurs de signalisation des points de terminaison

Ces erreurs incluent les exemples suivants :

• « ERREUR du téléphone logiciel {votre identifiant de contact} SESSION Échec de la connexion au serveur de signalisation Timeout »
• « ERREUR du téléphone logiciel Une erreur du téléphone logiciel s'est produite : l'URL de signalisation_connection_failure {URL du point de terminaison de signalisation} est introuvable. »

Erreurs relatives aux terminaux multimédia

Ces erreurs incluent les exemples suivants :

• « Le délai de collecte de la session ICE du téléphone logiciel WARN {votre identifiant de contact} a expiré »
• « ERREUR du téléphone logiciel {votre identifiant de contact} SESSION Aucun candidat ICE »
• « INFO du téléphone logiciel {votre identifiant de contact} SESSION ConnectSignalingAndIceCollectionState => FailedState »
• « ERREUR du téléphone logiciel Une erreur du téléphone logiciel s'est produite : ice \ _collection \ _timeout Le délai de collecte ice a expiré. »

Erreurs liées au point de terminaison

Ces erreurs incluent les exemples suivants :

• « La demande d'API ccp ERROR 'AcceptContact' a échoué : \ [object Object] »
• « ccp TRACE AWS Client : < L'opération 'AcceptContact' a échoué : {"message":"Network Failure","code":"NetworkingError","time":"....""

**Remarque :**Pour convertir vos journaux CCP bruts dans un format plus facile à lire, utilisez le CCP Log Parser. Pour plus d'informations, consultez CCP Log Parser sur GitHub.

Résolution

Vérifiez la communication entre Amazon Connect et les terminaux.

Des erreurs de téléphone logiciel se produisent lorsque votre Amazon Connect CCP ne parvient pas à communiquer avec un ou plusieurs des points de terminaison requis suivants :
**Remarque :**Remplacez INSTANCE_NAME par le nom de votre instance. Remplacez REGION par l'emplacement de votre instance Amazon Connect. Pour plus d'informations, consultez la section Configurer votre réseau.

Points de terminaison de signalisation
Pour communiquer avec les points de terminaison de signalisation, ajoutez les URL suivantes à votre liste d'autorisation via le port 443 (TCP) :

• Pour CCP v1: rtc*.connect-telecom.region.amazonaws.com
• Pour CCP v2 :*.transport.connect.region.amazonaws.com

Pour plus d'informations, consultez la section Mise à niveau vers la dernière version du CCP.
Points de terminaison multimédia
Pour communiquer avec les terminaux multimédia, ajoutez l'URL suivante à votre liste d'autorisations via le port 3478 (UDP) :

• TurnNlb-*.elb.REGION.amazonaws.com

Points de terminaison de l'API
Pour communiquer avec les points de terminaison de l'API, ajoutez les URL suivantes à votre liste d'autorisation via le port 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

Considérations supplémentaires

1. Vérifiez que rien ne bloque le trafic vers le domaine de point de terminaison indiqué dans le message d'erreur. Pour plus d'informations, consultez Remplacer les exigences relatives aux plages d'adresses IP d'Amazon EC2 et de CloudFront par une liste de domaines autorisés.
2. Vérifiez que le port requis pour le domaine de point de terminaison répertorié dans le message d'erreur est ouvert sur votre pare-feu réseau. Pour plus d'informations, consultez Remplacer les exigences relatives aux plages d'adresses IP d'Amazon EC2 et de CloudFront par une liste de domaines autorisés.
3. Si vous autorisez les plages d'adresses IP, vérifiez que toutes les adresses IP utilisées par Amazon Connect figurent sur les listes d'autorisation requises. Pour plus d'informations, voir Autoriser les plages d'adresses IP.
4. Vérifiez que votre connexion réseau est suffisamment stable pour permettre au CCP Amazon Connect de maintenir la connexion avec les points de terminaison requis.

Informations connexes

Résolution des problèmes liés au panneau de commande des contacts (CCP)

Configurez votre réseau