Intégration Microsoft Teams


Synthèse de l'intégration

L'intégration Microsoft Teams permet d'ajouter un agent virtuel Service Bots dans Microsoft Teams, avec lequel les utilisateurs peuvent discuter comme avec n’importe quel autre membre de la société.

Elle s'effectue au travers de plusieurs produits.

  • Azure Bot Service : Service de Microsoft Azure qui est spécialement conçu pour le développement de bots au travers d'applications Bot, et leur connexion à des canaux afin de les rendre disponibles dans différentes solutions, dont la plateforme MS Teams.
  • Microsoft Teams : Plateforme collaborative permettant, entre autres, des discussions entre utilisateurs / équipes d'une même société. Ces discussions peuvent également s'effectuer avec un bot, et plus particulièrement avec un agent virtuel Service Bots.
  • Service Bots : Permet d'associer un agent virtuel Service Bots à une application Bots Azure, puis de connecter cette application au canal MS Teams. L'agent virtuel devient alors disponible dans l'application MS Teams, avec lequel les utilisateurs peuvent dialoguer.

Remarques

  • L'avatar de l'agent virtuel Service Bots dans MS Teams est hexagonal, ce qui le rend facilement reconnaissable.

         Teams avatar.png

  • Un utilisateur peut rechercher l'agent virtuel par son nom (via la zone de recherche située en haut de la fenêtre MS Teams) s’il appartient à une équipe où l'application Bot Azure est installée ; sinon, il peut rechercher l'agent dans le catalogue des applications de MS Teams, puis lancer l'application Bot.
  • L'agent virtuel peut être mentionné dans une discussion d'équipe via l'instruction @shortname, en fonction du périmètre de l'application Bot.

Processus d'intégration pas-à-pas

Un agent virtuel Service Bots peut être intégré avec Microsoft Teams en 4 étapes simples :


Étape 1 : Dans Azure Bot Service, création d'une application Bot

Prérequis : L'agent virtuel Service Bots doit être créé.
         Open url.png voir Procédure

1. Créez une nouvelle application Bot.

  • Connectez-vous au portail Microsoft Azure.
  • Ouvrez le menu latéral gauche, puis cliquez sur Tous les services > IA + Machine Learning.
  • Cliquez sur Bot Services dans le panneau de droite.
  • Cliquez sur Ajouter.
  • Sélectionnez l'option Bot Channels Registration.
  • Cliquez sur Créer.

Le panneau de création de la nouvelle application Bot est ouvert.
         Azure - Create bot app - Bot informations.png


2. Renseignez les informations concernant la nouvelle application Bot.

Descripteur du bot : Identifiant unique (nom technique) de la nouvelle application Bot. Note : Ce champ n'est pas modifiable.
         exemple  ezvsample

Best Practice icon.png  Cet identifiant vous sera demandé lors de l'association de l'application Bot avec l'agent virtuel Service Bots (étape 2). Copiez-le et conservez-le temporairement dans votre éditeur de texte.

Abonnement : Nom de votre abonnement au service Azure à utiliser.

Groupe de ressources : Groupe de ressources associées à la solution Azure.

  • Vous devez en créer un nouveau, via le lien Créer.

Emplacement : Région cible.

Niveau tarifaire : Niveau de tarification de votre abonnement au service Azure.

  • F0 : Utilisation gratuite.
  • S1 : Utilisation avec une garantie SLA.

Point de terminaison de la messagerie : URL du point de terminaison de Service Bots, construite comme indiqué ci-dessous. Remplacez les valeurs entre les caractères { } par vos données.

  • {Domain} : Domaine de l'agent virtuel créé dans Service Bots.
  • {BotHandle} : Nom de l'agent virtuel créé Service Bots.
https:~/~/{Domain}/selfhelp/api/servicebots/msteams-agents/{BotHandle}

Application insights : Indique si le service de gestion des statistiques Azure analytics doit être activé (case cochée - vous devez spécifier également un emplacement régional), ou non (case non cochée).


3. Renseignez l'identifiant de votre nouvelle application Bot.

Génération de l'identifiant d'application

  • Cliquez sur Créer automatiquement l’ID et le mot de passe (1) > Nouveau (2).
    À chaque action, un nouveau panneau est ouvert.
             Azure - Create bot app - ID informations.png
  • Cliquez sur Créer l’ID d’application sur le portail d’inscription d’application (3).
    Un nouvel onglet est ouvert.
  • Cliquez sur Nouvelle inscription.
    La fenêtre d'enregistrement d'une nouvelle application est ouverte.
             Azure - Create bot app - Register informations.png
  • Renseignez les informations demandées.
    • Nom : Nom de votre application Bot, qui s'affiche pour les utilisateurs de l'application.
    • Types de comptes pris en charge : Sélectionnez l'option Comptes dans un annuaire organisationnel.
  • Cliquez sur Inscrire.
    • Un identifiant est assigné à votre nouvelle application Bot.
    • La fenêtre d'enregistrement est refermée.

Renseignement de l'identifiant au niveau la nouvelle application Bot

  • Copiez l’identifiant d’application.
             Azure - Create bot app - ID copy.png

Best Practice icon.png  Cet identifiant vous sera demandé lors de l'association de l'application Bot avec l'agent virtuel Service Bots (étape 2). Copiez-le et conservez-le temporairement dans votre éditeur de texte.

  • Revenez sur le panneau de création de votre nouvelle application Bot.
  • Collez l'identifiant d'application dans le champ Microsoft App ID.
             Azure - Create bot app - ID paste.png


4. Renseignez le secret (mot de passe) de votre nouvelle application Bot.

Génération du secret

  • Cliquez sur Certificats et secrets > Nouveau secret client.
             Azure - Create bot app - Secret new.png

La fenêtre de création d'un secret client est ouverte.
         Azure - Create bot app - Secret add.png

  • Renseignez la description du nouveau secret.
  • Cliquez sur Ajouter.
    • Le secret de votre nouvelle application Bot est généré.
    • La fenêtre de création est refermée.

Renseignement du secret au niveau la nouvelle application Bot

  • Copiez le secret affiché dans le champ Valeur.
             Azure - Create bot app - Secret copy.png

Best Practice icon.png  Ce mot de passe vous sera demandé lors de l'association de l'application Bot avec l'agent virtuel Service Bots (étape 2). Copiez-le et conservez-le temporairement dans votre éditeur de texte.

  • Revenez sur le panneau de création de la nouvelle application Bot.
  • Collez le secret dans le champ Mot de passe.
             Azure - Create bot app - Secret paste.png

5. Terminez la création de votre nouvelle application Bot.

  • Cliquez sur OK puis sur Créer dans le panneau de création de la nouvelle application Bot.
    Votre nouvelle application Bot est inscrite auprès d'Azure Bot Service.
  • Revenez sur la page Bot Services.
  • Cliquez sur Actualiser.
    Votre nouvelle application Bot est affichée dans la liste des applications spécifiques aux bots.


Étape 2 : Dans Self Help, création d'un agent virtuel Service Bots dédié au canal MS Teams

1. Ouvrez le module d'administration de Self Help.

  • Allez sur la page d'accueil de Self Help.
  • Cliquez sur Portail rédacteur.
  • Cliquez sur Administration.
  • Saisissez votre login / mot de passe.
  • Cliquez sur Connexion.

         Self Help - Opening Administration module.png

Le module d'administration est affiché.

         Self Help - Opening virtual agent list.png

2. Affichez la liste des agents virtuels via le menu Administration > Service Bots > Agents.

3. Sélectionnez votre agent virtuel.

         Self Help - Selecting bot.png

4. Associez l'agent virtuel à l'application Bot Azure.

  • Cliquez sur Associer un bot MS-Teams.
  • Renseignez les informations de l'application Bot.
    • Identifiant d'application : Valeur du champ Microsoft App ID générée au cours de la création de la nouvelle application Bot dans Microsoft Azure  - Open url.png voir Étape 1.3
    • Mot de passe : Valeur du champ Mot de passe généré au cours de la création de la nouvelle application Bot dans Microsoft Azure  - Open url.png voir Étape 1.4
    • Bot Handle : Descripteur (identifiant) du bot renseigné au cours de la création de la nouvelle application Bot dans Microsoft Azure  - Open url.png voir Étape 1.2

Best Practice icon.png  Pour éviter toute erreur, copiez-collez les valeurs que vous avez conservées dans votre éditeur de texte à l'étape 1.

         Self Help - Association informations.png

  • Cliquez sur Associer.
    Votre agent virtuel est associé à MS Teams au travers de l'application Bot.
  • Cliquez sur le libellé de l'agent virtuel et vérifiez que les informations de l'application Bot sont bien renseignées au niveau du cadre Bot Teams.
    La fenêtre de détails de l'agent est affichée.
             Azure - Self Help link - Virtual agent detail.png


Étape 3 : Dans MS Teams, test de l'agent virtuel Service Bots dédié à MS Teams

1. Testez l'interaction de votre agent virtuel Service Bots dans le canal Discussion web.

  • Allez sur le portail Azure.
  • Sélectionnez votre application Bot.
  • Cliquez sur le canal Tester dans une discussion web.
    Un panneau conversationnel s'affiche à droite.
             Azure - Web app chat channel.png
  • Vérifiez que votre application Bot interagit correctement en lui envoyant un message via le panneau conversationnel.
     

2. Testez l'interaction de votre agent virtuel Service Bots dans le canal MS Teams.

  • Ajoutez le canal MS Teams dans la liste des canaux.
    • Cliquez sur Canaux > Teams icon.png.
               Integrate bot in Teams - Activation.png
       
    • Cliquez sur Enregistrer.
  • Affichez le nouveau canal MS Teams.
    • Revenez sur la vue d’ensemble Canaux.
    • Cliquez sur le canal Microsoft Teams Teams icon.png.
               Integrate bot in Teams - Discussion setup.png
  • Vérifiez que votre agent virtuel interagit correctement en démarrant une discussion en équipe avec lui.
             Integrate bot in Teams - Discussion example.png


Étape 4 : Dans MS Teams, déploiement de l'application Bot Azure

1. Lancez MS Teams.

2. Ouvrez l'outil App Studio.

  • Cliquez sur Applications dans le panneau latéral.
  • Saisissez App Studio dans la zone de recherche.
  • Cliquez sur l'application dans le volet droit, puis sur Ouvrir.
    Note : Cliquez sur Installer si vous utilisez l'outil pour la première fois.

         Deploy bot in Teams - App studio opening.png

3. Créez une nouvelle application Teams associée à l'application Bot Azure, via l'éditeur de manifestes.

  • Cliquez sur l'onglet Manifest editor.
  • Cliquez sur Create a new app.

         Deploy bot in Teams - App studio - Manifest tab.png

Les 3 phases de création de la nouvelle application Teams sont affichées.
         Deploy bot in Teams - App studio - Manifest tab steps.png

4. Définissez les informations générales de votre nouvelle application Teams : Phase (1) Details.

  • Cliquez sur Details > App details dans le menu de gauche.

         Deploy bot in Teams - App studio - Manifest tab - step Details.png

  • Renseignez les informations concernant la nouvelle application Teams.
  • App names :
    • Short name : Nom de l'application Teams affiché dans la recherche de MS Teams (similaire au nom pour un employé).
    • Long name : Texte affiché après le nom (similaire à l'intitulé de poste pour un employé).
  • Identification :
    • App ID : Identifiant unique de l'application Teams. Cliquez sur Generate pour le créer.
    • Package name : Nom technique de l'application.
    • Version : Numéro de version de l’application.
  • Descriptions : Textes descriptifs de l'application Teams (court et long) affichés dans le catalogue des applications.
  • Developer information :
    • Name : Nom du développeur de l'application Teams.
    • Website : URL du site web associé à l’application Teams. Note : L'URL doit être en protocole SSL.
  • Partner information (optionnel) :
    • MPN ID : Identifiant du partenaire dans le réseau Microsoft Partner Network.
  • App URLs : URL des pages de la déclaration de confidentialité et des conditions d’utilisation. Note : Les URL doivent être en protocole SSL.
  • Branding : Identité visuelle de l'agent virtuel dans la nouvelle application Teams, définie via une icône en couleur, un contour transparent et une couleur d'arrière-plan. Cliquez sur Update pour télécharger les fichiers. Note : Les fichiers doivent être au format .png.

5. Définissez les capacités du bot Azure dans la nouvelle application Teams : Phase (2) Capabilities.

Intégration du portail dans un onglet de la conversation Teams (optionnel)

  • Cliquez sur Capabilities > Tabs dans le menu de gauche.
  • Cliquez sur Add a personal tab > Add.

         Deploy bot in Teams - App studio - Manifest tab - step Capabilities Tabs.png

La fenêtre de configuration de l'onglet est ouverte.
         Deploy bot in Teams - App studio - Manifest tab - step Capabilities Tabs details.png

  • Renseignez les informations concernant le nouvel onglet.
  • Name : Nom de l'onglet dans la conversation Teams.
  • Entity ID : Identifiant unique de l'onglet.
  • Content URL :
  • Website URL : URL de votre portail.
  • Cliquez sur Save.
     

Définition des capacités du bot Azure

  • Cliquez sur Capabilities > Bots dans le menu de gauche.

         Deploy bot in Teams - App studio - Manifest tab - step Capabilities Bots.png

  • Cliquez sur Set up.
    La fenêtre de configuration du bot est ouverte.
  • Cliquez sur l'onglet Existing bot.

         Deploy bot in Teams - App studio - Manifest tab - step Capabilities Bots set up.png

  • Bot ID : Indiquez l'identifiant du bot Azure (généré à l'étape 1.6).
    • Sélectionnez l'option Connect to a different bot id.
    • Collez l'identifiant de l'application Bot Azure dans le champ qui s'affiche.
  • Scope : Définissez le périmètre du bot en cochant les options souhaitées.
    • Personnal : Permet à l’utilisateur d'avoir une conversation directe avec l'agent virtuel.
    • Team : Dans les canaux d'équipe où l'application Teams est installée, permet à l’utilisateur de mentionner et de dialoguer avec l'agent virtuel via l'instruction @shortname.
    • Group Chat : Dans une conversation entre plusieurs personnes, permet de mentionner et de dialoguer avec l'agent virtuel via l'instruction @shortname.
  • Cliquez sur Save.
     

6. Définissez le domaine d'action du bot Azure dans la nouvelle application Teams : Phase (3) Finish.

  • Cliquez sur Finish > Test and distribute dans le menu de gauche.

         Deploy bot in Teams - App studio - Manifest tab - step Finish.png

  • Corrigez les éventuelles erreurs de configuration des phases (1) Details et (2) Capabilities, qui s'affichent sur le côté droit de l'écran.
     
  • Déployez la nouvelle application Teams dans une équipe.
    • Cliquez sur Install.
       
    • Cliquez sur Ajouter.
      • Une conversation avec l'agent virtuel est lancée.
      • L'application Teams est disponible dans la liste des applications.
      • Tous les membres de l'équipe peuvent discuter avec l'agent virtuel, via l'instruction @shortname.
       
  • Ajoutez la nouvelle application à la liste des applications Teams de votre entreprise.
    • Cliquez sur Submit.
    • Assurez-vous que vous avez renseigné tous les éléments nécessaires en vous aidant de la check-list.
               Deploy bot in Teams - App studio - Manifest tab - step Finish Submit.png
       
    • Cliquez sur Submit my app.
Tags:
Modifié par Utilisateur inconnu le 2020/03/19 15:30
Créé par Administrator XWiki le 2019/12/10 17:25

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help

Glossaire

Powered by XWiki ©, EasyVista 2020