Résoudre les problèmes de configuration de bot
S’APPLIQUE À : SDK v4
Un bot peut générer différents types d’erreurs. Il peut ne pas répondre, déclencher des erreurs ou fonctionner avec un canal mais pas avec un autre. La première étape de la résolution des problèmes d’un bot consiste à tester celui-ci dans Web Chat. Vous pourrez ainsi déterminer si le problème est spécifique à votre bot (le bot ne fonctionne dans aucun canal) ou à un canal particulier (le bot fonctionne dans certains canaux mais pas dans d’autres).
Tester dans la discussion web
- Ouvrez votre ressource bot dans le portail Azure.
- Ouvrez le volet Tester dans Web Chat.
- Envoyez un message à votre bot.
Si le bot ne répond pas avec la sortie attendue, accédez à Le bot ne fonctionne pas dans Chat Web. Dans le cas contraire, accédez à Le bot fonctionne dans Web Chat, mais pas dans les autres canaux.
Le bot ne fonctionne pas dans Chat Web
Plusieurs raisons peuvent justifier le dysfonctionnement d’un bot. La plus probable est que l’application de bot est en panne et ne peut pas recevoir de messages, ou que le bot reçoit les messages mais ne répond pas. Voici quelques-unes des causes possibles :
- Le bot est en panne et est inaccessible.
- Le bot a planté.
- Le point de terminaison du bot est incorrect.
- Le bot reçoit correctement vos messages, mais ne peut pas répondre.
Pour voir si le bot est en cours d’exécution :
- Ouvrez le volet Vue d’ensemble.
- Copiez le point de terminaison de messagerie et collez-le dans votre navigateur.
Si le point de terminaison retourne l’erreur HTTP 404 ou 405, cela signifie que le bot est accessible et qu’il est capable de répondre aux messages. Pour en savoir plus sur les problèmes d’expiration, consultez Timeout errors ou Erreurs HTTP 5xx.
Si le point de terminaison retourne une erreur « Impossible d’atteindre ce site » ou « Impossible d’atteindre cette page », cela signifie que votre bot est en panne et que vous devez le redéployer.
Le bot fonctionne dans Discussion Web, mais pas dans les autres canaux
Si le bot fonctionne comme prévu dans Web Chat mais ne fonctionne pas dans certains autres canaux, les raisons possibles sont :
Problèmes de configuration de canal
Il est possible que les paramètres de configuration du canal, tels que le nom d’utilisateur et le mot de passe du bot, aient été mal définis ou changés en externe. Par exemple, un bot a été configuré avec le canal Facebook pour une page en particulier, mais celle-ci a été supprimée depuis. La solution la plus simple est de supprimer le canal et de recommencer sa configuration.
Pour obtenir la liste des canaux pris en charge et des instructions sur la configuration de chacun d’eux, reportez-vous à la liste des canaux dans Connecter un bot vers des canaux.
Comportement spécifique au canal
L’implémentation de certaines fonctionnalités peut différer selon le canal. Par exemple, les canaux ne prennent pas tous en charge les cartes adaptatives. La plupart des canaux prennent en charge les actions (boutons), mais les restituent selon leur propre mode d’affichage. Si vous constatez des différences de fonctionnement de certains types de messages dans les différents canaux, consultez l’article contenant des informations de référence sur les canaux.
Voici quelques liens utiles sur chacun des canaux :
- Ajouter des bots à des applications Microsoft Teams
- Facebook : introduction à la plateforme Messenger
- Skype pour les développeurs
- Slack : activation des interactions avec les bots
Panne de canal
Parfois, certains canaux peuvent connaître une interruption de service. En règle générale, ces pannes ne durent pas longtemps. Toutefois, si vous soupçonnez une panne, consultez le réseau social ou le site web du canal.
Une autre façon de déterminer si un canal subit une panne consiste à créer un bot de test (par exemple, un bot Écho simple) et à ajouter un canal. Si le bot de test fonctionne avec certains canaux mais pas avec d’autres, le problème n’est pas dans votre bot de production.
Informations supplémentaires
Consultez la procédure Déboguer un bot ainsi que les autres articles de débogage de cette section.