Intégrer avec Microsoft Teams

IBM Cloud

Ajoutez un chatbot à Microsoft Teams pour créer et personnaliser un centre productif où le contenu, les outils et les personnes se rassemblent pour discuter, se rencontrer et collaborer.

Après avoir créé une action, vous pouvez utiliser cette intégration pour connecter votre assistant à Microsoft Teams.

Avant de commencer

Pour intégrer votre assistant à Microsoft Teams, vous devez avoir les rôles Global Administrator ou Teams Administrator. Pour plus d'informations, voir App permission policies.

Inscrivez-vous pour obtenir une adresse électronique d'administrateur de développeur Microsoft 365, si vous n'en avez pas:

  1. Accédez à Microsoft Dev Center.

  2. Cliquez sur Rejoindre maintenant pour devenir membre du programme Microsoft 365 Developer.

  3. Dans le tableau de bord, cliquez sur Configurer un abonnement E5 et sélectionnez un bac à sable Instant ou Configurable.

  4. Copiez l'adresse électronique indiquée sous Administrateur. Vos données d'identification d'administrateur sont requises à plusieurs points de configuration.

Ajout de l'intégration Microsoft Teams

  1. Accédez à la page Intégrations en cliquant sur l'icône des intégrations (Icône Intégrations) dans le menu de gauche.

  2. Cliquez sur Ajouter dans la tuile Microsoft Teams tuile.

  3. Cliquez sur Confirm. La page Mise en route fournit un récapitulatif du processus de configuration.

  4. Cliquez sur Suivant pour commencer l'enregistrement de l'application.

Enregistrement de l'application

  1. Accédez au portailMicrosoft Azureet connectez-vous avec vos données d'identification d'administrateur.

  2. Sur la page Enregistrements d'application, cliquez sur Nouvel enregistrement.

  3. Sur la page Enregistrer une application, entrez un nom, sélectionnez l'option à service partagé qui s'applique à votre application, puis cliquez sur Enregistrer.

  4. Copiez l'identifiant de l'application à partir de la page de présentation de votre application et collez-le dans le champ d' enregistrement de l'application de votre intégration watsonx Assistant Microsoft Teams.

  5. Sur la même page Microsoft Azure Overview, cliquez sur le lien hypertexte Add a certificate or secret en regard de Données d'identification du client.

  6. Sur la page Certificats et secrets pour la création de jeton, cliquez sur Nouveau secret client. Entrez une description, puis sélectionnez 180 jours recommandés. Cliquez sur Ajouter.

  7. Copiez la chaîne sous Valeur et collez-la dans la valeur secrète du client sur la page d' enregistrement de l'application de votre intégration watsonx Assistant Microsoft Teams. Remarque: Vous devez générer une nouvelle valeur avant que la valeur en cours n'expire le jour 180.

  8. Cliquez sur Suivant pour créer votre bot.

Création de votre bot

  1. Accédez au portail de développeur Microsoft Bot Frameworket connectez-vous avec vos données d'identification d'administrateur.

  2. Sur la page Tell us about your bot, complétez votre profil de bot.

  3. Copiez le point de terminaison généré à partir de la page Créer votre bot de votre intégration watsonx Assistant Microsoft Teams et collez-le dans le champ Point de terminaison de messagerie de la section Configuration.

  4. Sélectionnez Multi-Tenant comme type d'application.

  5. Copiez et collez votre ID d'application, puis cliquez sur Register.

  6. Sur la page Connexion aux chaînes, cliquez sur Configurer la chaîne Microsoft Teams dans la section Ajouter une chaîne vedette.

  7. Sur la page Configurer Microsoft Teams, spécifiez les options des onglets Messagerie, Appel et Publier qui correspondent aux besoins de votre bot, puis cliquez sur Enregistrer.

  8. Dans votre intégration watsonx Assistant Microsoft Teams, cliquez sur Suivant pour créer votre application Teams.

Créez votre application Equipes

  1. Allez sur le portail des développeurs Microsoft Teams et connectez-vous avec vos identifiants d'administrateur.

  2. Dans l'onglet Apps, cliquez sur Nouvelle application.

  3. Entrez un nom et cliquez sur Ajouter.

  4. Sur la page Informations de base, entrez les noms d'application, l'ID d'application, les descriptions, les informations de développeur et les URL d'application, puis copiez et collez votre ID d'application dans ID d'application (client). Cliquez sur Sauvegarder.

  5. Dans la section Configurer, sélectionnez App features, puis Bot.

  6. Sur la page Identifier votre bot, sélectionnez votre bot.

  7. Dans la section Sélectionner la portée dans laquelle les utilisateurs peuvent utiliser cette commande, sélectionnez Personnel, Equipe et Discussion de groupe.

  8. Cliquez sur Sauvegarder, mais laissez la fenêtre ouverte.

  9. Dans votre intégration watsonx Assistant Microsoft Teams, cliquez sur Terminer.

  10. Cliquez sur Publier pour publier votre bot.

Lorsqu'une extension personnalisée est exécutée au cours d'une conversation sur Microsoft Teams, le client ne reçoit les étapes de pré-exécution qu'une fois l'appel à l'extension terminé. Pour plus d'informations, voir appeler un poste personnalisé.

Publication de votre application Equipes

  1. Dans la fenêtre du portail des développeurs Microsoft Teams où vous avez créé et enregistré votre application Teams, cliquez sur Publier pour publier votre robot.

  2. Cliquez sur Télécharger le package d'application.

  3. Rendez-vous sur le site Microsoft Teams et connectez-vous avec vos identifiants d'administrateur.

  4. Cliquez sur Applications dans le menu de la barre latérale, puis cliquez sur Gérer vos applications et sur Télécharger une application.

  5. Sélectionnez Télécharger une application personnalisée et indiquez le fichier compressé du paquet d'applications que vous avez téléchargé.

  6. Cliquez sur Ajouter pour terminer.

  7. Testez vos actions et vos réponses dans la section Discussion de votre application Equipes.

Types de réponse

Ces types de réponses sont pris en charge et s'affichent comme prévu lorsque votre assistant est déployé pour les messages directs Microsoft Teams, les canaux ou les chats de groupe.

  • date
  • image
  • Option
  • suggestion
  • texte

Limitations

Dans Microsoft Teams, les boutons d' option, qu'ils soient rendus à partir d'une action ou d'un nœud de dialogue, restent actifs une fois que vous les avez sélectionnés. Ces boutons peuvent être cliqués plusieurs fois au cours d'une conversation, et chaque clic supplémentaire soumet à nouveau la même charge utile à watsonx Assistant. Ce comportement peut entraîner un double traitement et des réponses de suivi inattendues ou incorrectes.

Cette limitation est spécifique au canal Microsoft Teams. Dans d'autres canaux, tels que le chat en ligne et la page Try it Out sur watsonx Assistant, les boutons d' option sont désactivés après le premier clic et ne peuvent pas être sélectionnés à nouveau.