Comment résoudre les échecs d'intégration d'Amazon Lex dans mon instance Amazon Connect ?

Brève description

Les raisons les plus courantes de l'échec de l'intégration des bots Amazon Lex dans les flux de travail de contacts sont les suivantes :

• le quota de ressources est dépassé ;
• vous ne pouvez pas associer le bot Amazon Lex V2 à l'aide de l'interface de la ligne de commande AWS (AWS CLI) ;
• vous essayez d'accéder à AWS Lex dans Amazon Connect ;
• l'intention d'Amazon Lex n'est pas identifiée dans les flux de contacts, ou les données client ne sont pas reconnues ;
• la session Amazon Lex expire ;
• le flux de contacts exécute le flux d'erreurs.

Solution

Pour résoudre les problèmes d'intégration d'Amazon Lex à Amazon Connect, vérifiez d'abord si le bot Amazon Lex fonctionne de manière indépendante. Par exemple, confirmez qu'il fonctionne sur la console Amazon Lex. Cela vous permet de déterminer si le problème provient du bot Amazon Lex sous-jacent ou d'Amazon Connect.

Activez ensuite les journaux de flux et les journaux de conversation Amazon Lex pour résoudre d'autres problèmes d'intégration.

Enfin, résolvez les raisons les plus courantes de l'échec de l'intégration de bots Amazon Lex dans les flux de travail de contacts.

Le quota de ressources est dépassé

Le message d'erreur suivant s'affiche : «Dépassement du quota de ressources. »

Cela est dû au fait que vous avez dépassé la limite d'au moins l'un des services Amazon Connect suivants :

• Le quota par défaut de bots Amazon Lex par instance est de 70. Pour prendre en charge plus de 70 bots Amazon Lex, migrez vers Amazon Lex V2. Pour plus d'informations, consultez le Guide de migration d'Amazon Lex V1 vers V2.
• Par défaut, les alias de bot Amazon Lex V2 sont de 100 par instance.
• Le délai d'expiration du chat lié à l'intégration du bot Amazon Lex est de 6 secondes. Il s'agit de la durée maximale pendant laquelle le bot Amazon Lex doit répondre à l'invite de chat du client. Ce chiffre ne peut pas être augmenté.

Pour plus d'informations, consultez la section Quotas de service Amazon Connect.

Vous ne pouvez pas associer le bot Amazon Lex V2 à l'aide de l'AWS CLI

L'associate-lex-bot de l'AWS CLI ne fonctionne pas avec Amazon Lex V2, mais l'associate-bot de l'AWS CLI fonctionne à la fois pour Amazon Lex V1 et Amazon Lex V2. Par conséquent, si vous utilisez Amazon Lex V2, vous devez utiliser l'associate-bot de l'AWS CLI.

Remarque : si vous recevez des erreurs lors de l'exécution de commandes depuis l'interface de la ligne de commande AWS (AWS CLI), vérifiez que vous utilisez la version la plus récente de l'AWS CLI.

Vous essayez d'accéder à AWS Lex dans Amazon Connect

L'accès intercompte n'est pas pris en charge. Amazon Connect et le bot Amazon Lex doivent se trouver sur le même compte AWS pour que l'intégration fonctionne. Toutefois, le bot Amazon Lex peut se trouver dans une région AWS différente.

Remarque : il est recommandé d'installer votre bot Amazon Lex dans la même région que l'instance de connexion. Si vous utilisez un bot Amazon Lex d'une autre région, vous pourriez ne pas obtenir de performances optimales.

l'intention d'Amazon Lex n'est pas identifiée dans les flux de contacts, ou les données client ne sont pas reconnues

Si vous utilisez Amazon Lex V2, assurez-vous de définir l'attribut de langue correct. Il est recommandé d'utiliser le bloc Définir la voixi dans votre flux de contacts . Placez-le devant le bloc Obtenir les entrées utilisateur. Par exemple, si votre bot Amazon Lex utilise les paramètres régionaux en, GB, définissez la langue dans le bloc Définir la voix sur anglais, britannique. Ensuite, dans le bloc Définir la voix, activez Définir l'attribut de langue.

Important : pour les bots Amazon Lex V2, votre attribut de langue dans Amazon Connect doit correspondre au modèle de langue utilisé pour créer votre bot Amazon Lex. Cela est différent d'Amazon Lex V1. Utilisez un bloc Définir la voix pour indiquer le modèle de langue Amazon Connect, ou utilisez un bloc Définir les attributs de contact .

La session Amazon Lex expire

Lorsque vous configurez les valeurs de délai d'attente pour les contacts vocaux, assurez-vous d'utiliser les attributs de session appropriés dans le bloc Obtenir les données client qui appelle votre bot Amazon Lex. Pour plus d'informations sur le contrôle de la fonctionnalité de délai d'attente, consultez la section Conseils en matière de configuration.

Le flux de contacts exécute le flux d'erreurs

Assurez-vous de fournir pour votre bot Amazon Lex un alias qui correspond à l'alias fourni dans le champ obligatoire Obtenir les données client de votre flux de contacts.

Important : vérifiez que le bot Amazon Lex est associé au bon alias dans le flux de contacts de l'instance. Assurez-vous également de la correspondance de l'alias à la version correcte de celui que vous prévoyez d'utiliser pour votre bot Amazon Lex.

Si vous rencontrez toujours des problèmes après avoir effectué les étapes précédentes, contactez AWS Support. Pour obtenir des instructions sur l'accès à AWS Support, consultez la section Obtenir un support administratif pour Amazon Connect.

Il est recommandé d'inclure les informations suivantes dans votre ticket :

• L'ID/ARN de votre instance de centre de contacts. Pour trouver l'ARN de votre instance, consultez la section Trouver l'ID/ARN de votre instance Amazon Connect.
• Une description détaillée du problème.
• Tous les messages d'erreur que vous recevez.
• Des captures d'écran de l'erreur.
• Des journaux de flux de contacts, le cas échéant.

---