Intégration avec Microsoft Teams

La première étape consiste à créer une appli dans Microsoft Teams.

Pour créer l'appli Teams :

1. Connectez-vous à Microsoft Teams en tant qu'administrateur.
2. Dans l'onglet Applis, recherchez l'entrée App Studio et ajoutez-la.
3. Dans l'onglet Éditeur de manifeste d'App Studio, sélectionnez Créer une application.
4. Spécifiez au moins les valeurs suivantes :
• Nom abrégé
• Nom complet
• Description abrégée
• Description complète
• Nom de paquet (par exemple, nom-de-votre-entreprise.appli-teams-ISD.com)
• Version (par exemple, 1.0.0)
• Description abrégée
• Description longue
• Infos de développeur (par exemple, votre nom et l'adresse du site Web de votre entreprise)
• URL de la Site Web (nécessite https://)
• URL de la déclaration de confidentialité (nécessite https://)
• URL des conditions d'utilisation (nécessite https://)
5. Cliquez sur Générer.
   L'ID d'appli est généré.
6. Sous Capacités, sélectionnez Robots, puis cliquez sur Configuration.
7. Entrez un nom, sélectionnez Mon robot est unidirectionnel et configurez Étendue sur Équipe.
8. Cliquez sur Créer un robot.
   Le robot est créé et s'affiche dans la page Robots, où l'ID utilisé dans les paramètres système Service Desk figure sous ID de robot.
   
9. Cliquez sur Générer un nouveau mot de passe.
   Un mot de passe est créé, et sera utilisé plus tard dans les paramètres système Service Desk dans le champ Mot de passe de robot.
10. Entrez l'adresse de poste client du robot au format :
    https://[URL-du-serveur]/[nom-d'instance-framework]/api/messages?v=*
    Par exemple :
    https://mon.exemple.org/servicedesk.framework.web/api/messages?v=*
11. Dans l'onglet Test et distribution, téléchargez l'appli Teams sous forme de fichier zip.
    

Après avoir créé l'appli, vous devez la télécharger vers le serveur.

Pour télécharger l'appli Teams pour votre entreprise :

1. Connectez-vous à Teams en tant qu'administrateur.
2. Dans l'onglet Applis, cliquez sur Charger une application personnalisée et téléchargez vers le serveur le fichier zip de la section précédente.
   Une vignette s'affiche pour l'appli téléchargée.
3. Cliquez sur la vignette de l'appli, puis sur Ajouter à une équipe.
4. Recherchez l'équipe voulue, puis cliquez sur Configurer un robot.
   L'appli Teams est installée pour l'équipe sélectionnée.

Vous êtes maintenant prêt à configurer Service Desk en vue d'utiliser l'appli Teams, après quoi vous pourrez ajouter des utilisateurs à l'équipe dans Teams.

Une fois que vous avez créé l'appli Teams et que vous l'avez téléchargée vers le serveur, vous pouvez configurer l'intégration entre cette appli et Service Desk. Cela implique d'ajouter certains paramètres système Service Desk depuis la configuration d'appli Teams, puis d'ajouter un membre à l'équipe appropriée, avant de revenir aux paramètres système Service Desk pour activer et configurer plus précisément l'intégration.

Pour configurer l'intégration entre Service Desk et l'appli Teams :

1. Connectez-vous à la console Service Desk en tant qu'administrateur.
2. Dans le menu Paramètres, cliquez sur Système.
   La page Paramètres système s'affiche.
3. Sous Intégration Teams, définissez les valeurs suivantes :
   ID de robot – ID généré dans Microsoft Teams lorsque vous avez créé le robot.
   Mot de passe de robot – Mot de passe généré dans Microsoft Teams lorsque vous avez créé le robot.
   Lier à une équipe – URL créée lorsque vous sélectionnez Obtenir un lien vers l’équipe dans le menu contextuel Team.
   URL d'image de notification – URL de l'image à afficher dans la notification Teams.
4. Enregistrez les paramètres.
   L'étape suivante consiste à définir la valeur en lecture seule URL de service. Le système le fait pour vous lors de l'envoi du premier message à la structure (Framework) Service Desk au moment où vous suivez les étapes ci-après.
5. Dans le centre de configuration Service Desk, recyclez le pool d'applis Framework.
6. Dans Microsoft Teams, ajoutez un utilisateur à l'équipe pour laquelle l'appli de notifications Service Desk est installée.
   Cette opération envoie un message à la structure (Framework) Service Desk et remplit ainsi le paramètre système URL de service.
7. Dans la page Paramètres système de Service Desk, sous Intégration Teams, définissez Activer les notifications Teams sur True (Vrai) et vérifiez que le paramètre URL de service comporte une valeur.