Slack

Configurez le bot Hestyna dans Slack pour offrir la conciergerie directement aux collaborateurs.

Prérequis

• Être Workspace Owner ou avoir l’autorisation "Développer des applications" dans Slack.
• Créer une application sur https://api.slack.com/apps.
• Scopes Bot requis :
  • chat:write
  • app_mentions:read
  • channels:history
  • groups:history (si vous visez des canaux privés)
  • commands
• Optionnel : files:read si vous souhaitez ingérer des pièces jointes.

Étapes côté Slack

1. Créez l’application « Hestyna Bot ».
2. Dans OAuth & Permissions, ajoutez les scopes ci-dessus.
3. Activez Slash Commands et créez /hestyna pointant vers https://app.hestyna.com/api/integrations/slack/commands/.
4. Ajoutez les événements Event Subscriptions : app_mention, message.im, member_joined_channel.
5. Installez l’application et copiez le Bot User OAuth Token (xoxb-…).
6. Copiez également le Signing Secret (onglet Basic Information).

Configuration dans Hestyna

1. Ouvrez Catalogue → Intégrations → Slack.
2. Renseignez :
   • Bot token,
   • Signing secret,
   • (optionnel) ID de canal par défaut pour les alertes.
3. Cliquez sur Tester la connexion.
4. Validez avec Créer.

Tests rapides

• Invitez @Hestyna dans votre canal pilote.
• Tapez /hestyna help → vous devez recevoir le menu d’accueil.
• Envoyez un message privé au bot → l’activité doit apparaître dans Bots → Slack.

Ingestion de messages Slack

Pour indexer l’historique :

1. Créez une intégration Slack dédiée à l’ingestion avec le même token.
2. Lors de la création de l’index, indiquez l’ID du canal (C0...).
3. Lancez une synchronisation manuelle.

Maintenance

• Rotation : régénérez le bot token tous les 3 mois (Slack > OAuth & Permissions > Regenerate).
• Permissions : si vous ajoutez de nouveaux scopes, reinstallez l’application.
• Alertes : activez l’alerte « Échec bot Slack » dans Observabilité.

Dépannage

Problème	Solution
Slash command silencieuse	Vérifiez l’URL et le certificat. Consultez les logs Slack → Interactions & Events.
Bot ne répond pas	Assurez-vous que le bot est invité dans le canal et que app_mention est activé.
Erreur invalid_auth	Token expiré ou scindé lors du copier/coller. Regénérez-le.

Référence : Installer les bots