Résoudre les problèmes de votre application Microsoft Teams de messagerie

Onglets de dépannage

Accès aux DevTools

Vous pouvez ouvrir DevTools dans le client Teams pour une expérience similaire à celle d’appuyer sur F12 (sur Windows) ou Command-Option-I (sur MacOS) dans un navigateur.

Écran d’onglet vide

Si vous ne voyez pas votre contenu dans l’affichage Onglet, il peut s’agit des suivants :

  • votre contenu ne peut pas être affiché dans un <iframe> .
  • le domaine de contenu ne figure pas dans la liste validDomains du manifeste.

Le bouton Enregistrer n’est pas activé dans la boîte de dialogue paramètres

Assurez-vous d’appeler une fois que l’utilisateur a reçu une entrée ou sélectionné toutes les données requises sur votre page de paramètres pour microsoftTeams.settings.setValidityState(true) activer le bouton Enregistrer.

Après avoir sélectionné le bouton Enregistrer, les paramètres de l’onglet ne peuvent pas être enregistrés.

Lorsque vous ajoutez un onglet, si vous cliquez sur les boutons d’enregistrer mais qu’un message d’erreur indiquant que les paramètres ne peuvent pas être enregistrés s’affiche, le problème peut être l’une des deux catégories de problèmes suivants :

  • Le message de réussite de l’enregistrer n’a jamais été reçu. Si un handler d’enregistrement a été enregistré à microsoftTeams.settings.registerOnSaveHandler(handler) l’aide de , le rappel doit appeler saveEvent.notifySuccess() . Si le rappel ne l’appelle pas dans les 30 secondes ou s’il appelle à la place, cette saveEvent.notifyFailure(reason) erreur s’affiche.

  • Si aucun handler d’enregistrement n’a été enregistré, l’appel est effectué automatiquement dès que l’utilisateur sélectionne saveEvent.notifySuccess() le bouton Enregistrer.

  • Les paramètres fournis n’étaient pas valides. L’autre raison pour laquelle les paramètres peuvent ne pas être enregistrés est si l’appel pour fournir un objet paramètres non valide microsoftTeams.setSettings(settings) ou l’appel n’a pas été effectué du tout. Consultez la section suivante, Problèmes courants avec l’objet paramètres.

Problèmes courants avec l’objet settings

  • settings.entityId est manquant. Ce champ est obligatoire.
  • settings.contentUrl est manquant. Ce champ est obligatoire.
  • settings.contentUrl ou settings.removeUrl facultatives, ou settings.websiteUrl sont fournies mais non valides. Les URL doivent utiliser HTTPS et doivent également être le même domaine que la page de paramètres ou spécifiés dans la liste du validDomains manifeste.

Ne peut pas authentifier l’utilisateur ou afficher votre fournisseur d’authentification dans votre onglet

Sauf si vous faites une authentification silencieuse, vous devez suivre le processus d’authentification fourni par le SDK client JavaScript Microsoft Teams.

Notes

Nous exigeons que tout le flux d’authentification démarre et se termine sur votre domaine, qui doit être répertorié dans validDomains l’objet dans votre manifeste.

Pour plus d’informations sur l’authentification, voir Authentifier un utilisateur.

Onglets statiques non s’affichant

Il existe un problème connu où la mise à jour d’une application de bot existante avec un onglet statique nouveau ou mis à jour n’affichera pas ce changement d’onglet lors de l’accès à l’application à partir d’une conversation personnelle. Pour voir la modification, vous devez tester sur un nouvel utilisateur ou une nouvelle instance de test, ou accéder au bot à partir du flyout Applications.

Résolution des problèmes de bots

Can’t add my bot

Les applications doivent être activées par l’administrateur Office 365 client pour qu’elles soient chargées par les utilisateurs finaux. Notez que dans certains cas, le client Office 365 peut être associé à plusieurs S SKUs, et pour que les bots fonctionnent dans n’importe quelle, ils doivent être activés dans toutes les S SKUs. Pour plus d’informations, voir Préparer Office 365 client.

Can’t add bot as a member of a team

Les bots doivent d’abord être chargés dans une équipe avant d’être accessibles dans n’importe quel canal de cette équipe. Pour plus d’informations sur ce processus, consultez le téléchargement de votre application dans une équipe.

Mon bot ne reçoit pas mon message dans un canal

Les bots dans les canaux reçoivent des messages uniquement lorsqu’ils sont explicitement @mentioned, même si vous répondez à un message de bot précédent. La seule exception lorsque vous ne voyez pas le nom du bot dans un message est si le bot reçoit une action à la suite d’un CardAction qu’il a imBack envoyé à l’origine.

Mon bot ne comprend pas mes commandes dans un canal

Étant donné que les bots dans les canaux reçoivent des messages uniquement lorsqu’ils sont @mentioned, tous les messages que votre bot reçoit dans un canal incluent ce @mention dans le champ de texte. Il est préférable d’enlever le nom du bot lui-même de tous les messages texte entrants avant de passer à votre logique d’examen. Examinez les mentions pour obtenir des conseils sur la façon de gérer ce cas.

Problèmes de mise en packaging et de chargement

Erreur lors de la lecture manifest.jssur

La plupart des erreurs de manifeste fournissent un conseil sur le champ spécifique manquant ou non valide. Toutefois, si le fichier JSON ne peut pas être lu en tant que JSON, ce message d’erreur générique est utilisé.

Raisons courantes des erreurs de lecture de manifeste :

  • JSON non valide. Utilisez un IDE tel que Visual Studio Code ou Visual Studio qui valide automatiquement la syntaxe JSON.
  • Problèmes de codage. Utilisez UTF-8 pour le fichiermanifest.jssur. D’autres encodages, en particulier avec la boM, peuvent ne pas être lisibles.
  • Un package .zip malformé. Le manifest.jssur le fichier doit se trouver au niveau supérieur du .zip fichier. Notez que la compression de fichiers Mac par défaut peut placer le manifest.js dans un sous-dossier, qui ne sera pas chargé correctement dans Microsoft Teams.

Il existe une autre extension avec le même ID

Si vous tentez de re-télécharger un package mis à jour avec le même ID, choisissez l’icône Remplacer à la fin de la ligne de tableau de l’onglet plutôt que le bouton Télécharger.

Si vous ne retentez pas un package mis à jour, assurez-vous que l’ID est unique.