Résoudre les problèmes de configuration de bot

S’APPLIQUE À : Kit de développement logiciel (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

  1. Ouvrez votre ressource bot dans le portail Azure.
  2. Ouvrez le volet Tester dans Web Chat.
  3. Envoyez un message à votre bot.

Tester dans Web Chat

Si le bot ne répond pas avec la sortie attendue, accédez à Le bot ne fonctionne pas dans Web Chat. Dans le cas contraire, accédez à Le bot fonctionne dans Web Chat, mais pas dans les autres canaux.

Le bot ne fonctionne pas dans Web Chat

Les raisons pour lesquelles un bot ne fonctionne pas peuvent être nombreuses. 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 :

  1. Ouvrez le volet Vue d’ensemble.
  2. 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 Web Chat, 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 la configuration du canal.

Pour obtenir la liste des canaux pris en charge et des instructions sur la configuration de chacune d’elles, consultez la liste Canaux dans Connecter un bot aux 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 supplémentaires qui peuvent aider sur chacun des canaux :

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, cela indique que le problème n’est pas dans votre bot de production.

Ressources supplémentaires

Consultez la procédure Déboguer un bot ainsi que les autres articles de débogage de cette section.