Aller au contenu principal

Configuration de HocNota comme Bot Azure

Pour améliorer l'intégration de HocNota dans votre flux de travail, il est possible de l'intégrer dans Microsoft Teams. Il est alors possible d'envoyer un travail et de suivre son évolution sans passer par l'interface web.

Pré-requis HocNota

Avant de configurer le bot, il est nécessaire de configurer la connexion Azure.

Activez le Bot puis récupérez le "Messaging Endpoint" (https://xxxxx.com/api/messages).

Enregistrement du bot dans le portail Azure

Accédez au portail Azure de votre organisation (https://portal.azure.com/)

Dans la barre de recherche, cherchez "All resources" pour ouvrir le gestionnaire des ressources

01-resources.png

Cliquez sur "+ Create"

02-create.png

Dans la liste des ressources disponibles, recherchez "Azure bot", puis cliquez sur "Create".

03-search azure bot.png

Saisissez les informations d'enregistrement

  • Bot handle : Nom du bot
  • Subscription : Sélectionnez la souscription à utiliser pour le bot
  • Resource group : HocNota (ou le nom utilisé pendant la connexion HocNota)
  • Data residency : Localisation des données

Une fois remplis, validez avec Review + Create, puis Create pour finaliser la création du Bot.

03.1-search azure bot.png

Cliquez sur "Go to resource"

05-go to resource.png

Sélectionnez "Configuration" dans la partie gauche

07-configuration.png

Saisissez le Messaging Endpoint récupéré depuis l'interface HocNota, puis appliquez le changement.

Récupérez le Microsoft App ID

Cliquez ensuite sur "Manage Password" pour créer un Secret pour le Bot

08-Message-endpoint + app ID + manage password.png

Comme pour la connexion Azure, définissez un Secret pour le Bot

Sélectionnez "+ New client secret"

06-new-secret.png

09-client secret.png

Récupérez la valeur du Client secret

09.1-client secret.png

Retournez dans la configuration du Bot avec le lien en haut de la page

09.2-retour-config.png

puis retournez dans la gestion avec le bouton "Go to resource", comme au début du tutoriel.

Configurez un canal de communication pour le Bot avec la section "Channels" à gauche.

10-channels.png

Recherchez "Microsoft Teams" dans la liste et cliquez dessus.

11-Microsoft teams.png

Sélectionnez la valeur qui convient le mieux à votre organisation puis appliquez.

12-Apply.png

Configuration du Bot Azure dans HocNota

Dans l'interface Admin HocNota (System -> Azure AD) section Bot Microsoft Teams

Saisissez l'App ID et la valeur de la clé récupérés lors de la configuration du bot.

12.1-Config HocNota.png

Vous pouvez alors télécharger le bot avec le bouton "Télécharger le package Teams".

Configuration du portail Admin Teams

Ouvrez l'interface admin de Teams (https://admin.teams.microsoft.com)

Accédez à la gestion des Apps

Ouvrez "Teams apps" -> "Manage apps"

14-admin teams - manage apps.png

En haut à droite, sélectionnez "Actions" puis "+ Upload new app"

15-admin teams - upload new app.png

Envoyez le package téléchargé lors de l'étape précédente.

Une fois l'envoi terminé, vous pouvez fermer la fenêtre.

Accédez à la configuration de la sécurité avec la rubrique "Setup policies"

16-admin teams - setup policies.png

Sélectionnez la policy Global

17-admin teams - Global.png

Autorisez l'Upload custom apps

18-admin teams - Upload custom apps.png

Le bot est maintenant accessible dans Teams

Configuration de Teams

Maintenant que tout a été configuré au niveau serveur, il est possible pour chaque utilisateur de l'organisation de trouver le bot HocNota directement dans Teams de cette façon.

Cliquez sur le bouton "+" pour ouvrir la gestion des applications

19- teams - Apps.png

Puis dans la rubrique "Added by your org" ou "Built for your org"

20- teams - Added by your org.png

Vous trouverez l'appli HocNota (le logo peut évoluer d'une version à l'autre), sélectionnez-la et cliquez sur "Add".

21- teams - open.png

Le bot HocNota est maintenant disponible dans la barre sur le côté.

23- Chat.png

Voir aussi la page de référence : Connexion Teams (Bot Azure).