Microsoft Teams

Reliez Hestyna à Microsoft Teams pour proposer la conciergerie dans vos discussions et canaux.

Prérequis

• Compte Global Admin ou Teams Admin avec accès à Azure AD.
• Capacité à créer une App Registration et à octroyer les permissions Microsoft Graph.
• Autorisation de téléverser une application personnalisée dans l’admin center Teams.

Étapes côté Azure AD

1. Ouvrez le Portail Azure → Azure Active Directory → App registrations → New registration.
2. Donnez un nom (ex. Hestyna Teams Bot) et créez l’application.
3. Certificates & secrets → New client secret. Copiez la valeur (non récupérable ensuite).
4. API Permissions → Add a permission → Microsoft Graph → Application permissions :
   • Chat.ReadWrite.All
   • TeamsActivity.Send
   • User.Read.All
5. Cliquez sur Grant admin consent.

Paquet Teams

• Téléchargez le package fourni par Hestyna (onglet Bots → Teams → Télécharger le package).
• Modifiez le fichier manifest.json si vous souhaitez changer le nom ou l’icône.
• Zipez à nouveau manifest.json, color.png, outline.png.

Configuration dans Hestyna

1. Rendez-vous sur Catalogue → Intégrations → Microsoft Teams.
2. Saisissez :
   • ID client,
   • ID locataire,
   • Secret client,
   • (optionnel) Endpoint Graph personnalisé si vous utilisez un proxy.
3. Testez la connexion.
4. Enregistrez.

Déploiement dans Teams

1. Dans le centre d’administration Teams, ouvrez Applications → Gérer les applications.
2. Importez le package personnalisé.
3. Affectez-le à une stratégie d’installation (groupe pilote) ou partagez le lien direct.

Tests

• Ajoutez le bot dans un canal pilote et envoyez « Bonjour » → vous devez recevoir une réponse.
• Lancez un formulaire : tapez /hestyna et choisissez un service.
• Vérifiez l’activité dans Bots → Teams côté Hestyna.

Maintenance

• Secrets Azure : définissez une alerte 30 jours avant expiration.
• Permissions supplémentaires (SharePoint, Lists) : ajoutez Sites.Read.All si vous indexez SharePoint.
• Logs : surveillez hestyna_bot_events_failure_total pour anticiper les incidents.

Dépannage

Symptôme	Action
Erreur 401 lors du test	Vérifiez le secret client et le consentement admin.
Bot silencieux dans les canaux	Ajoutez l’app à la bonne équipe et vérifiez les autorisations du canal.
Messages non livrés	Consultez le centre de diagnostic Teams → Logs d’activités.

Ressource liée : Installer les bots