Installer les bots Hestyna

Les bots Slack et Microsoft Teams donnent accès à la conciergerie là où vos collaborateurs travaillent déjà. Cette page décrit les étapes d’installation, les permissions et les tests.

Slack bot

Préparer l’application Slack

1. Accédez à https://api.slack.com/apps et créez une nouvelle application « From scratch ».
2. Attribuez le workspace pilote puis donnez-lui un nom (ex. Hestyna Bot).
3. Dans OAuth & Permissions, ajoutez les scopes Bot suivants :
   • chat:write
   • app_mentions:read
   • channels:history (ajoutez groups:history pour les canaux privés)
   • commands
4. Activez Event Subscriptions → app_mention, message.im.
5. Installez l’application dans le workspace et copiez le Bot User OAuth Token (xoxb-…).

Configurer côté Hestyna

1. Ouvrez Catalogue → Intégrations → Slack.
2. Collez le bot token dans le champ prévu.
3. Facultatif : renseignez un canal par défaut (#help-desk).
4. Testez en cliquant sur Tester la connexion.

Vérifier le fonctionnement

• Invitez le bot dans la chaîne pilote (/invite @Hestyna).
• Tapez /hestyna help pour vérifier la réponse.
• Consultez Bots → Slack dans Hestyna pour voir la dernière activité.

Microsoft Teams bot

Créer l’application Azure AD

1. Connectez-vous au Portail Azure.
2. Créez une Azure AD App Registration pour Hestyna.
3. Ajoutez un client secret (copiez la valeur). Note : durée de vie recommandée 6 mois.
4. Dans API Permissions, ajoutez :
   • Chat.ReadWrite.All
   • TeamsActivity.Send
   • User.Read
5. Cliquez sur Grant admin consent.

Configurer côté Hestyna

1. Dans Catalogue → Intégrations → Microsoft Teams, saisissez :
   • ID client,
   • ID locataire (tenant),
   • Secret client.
2. Complétez les champs du tableau (endpoint Graph, champs titre/corps si vous indexez SharePoint).
3. Testez la connexion.

Publier l’application Teams

• Téléchargez le package de l’application depuis Hestyna (onglet Bots → Teams).
• Dans le centre d’administration Teams, importez le package (Apps personnalisées).
• Ajoutez l’app à une stratégie de configuration ou distribuez-la manuellement aux équipes pilotes.

Vérifier le fonctionnement

• Ouvrez une conversation avec le bot et écrivez « Bonjour ».
• Vérifiez que la réponse contient le menu de démarrage.
• Dans Hestyna, onglet Bots → Teams, contrôlez la dernière synchronisation.

Conseils généraux

• Rotation des secrets : planifiez un rappel pour régénérer tokens Slack et secrets Azure.
• Logs : en cas de souci, ouvrez Observabilité → Journal des événements pour voir les requêtes entrantes.
• Sécurité : limitez l’installation aux workspaces/périmètres pilotes avant d’étendre à toute l’entreprise.

Ressources associées

• Guide Slack complet
• Guide Microsoft Teams complet
• Automations WYSIWYG