Passer au contenu principal
Ajoutez un assistant IA à votre espace de travail Slack en utilisant le Socket Mode — aucune URL publique n’est requise.

Prérequis

Guide de configuration

1

Créer une application Slack

  1. Allez sur Slack API et cliquez sur Create New App
  2. Choisissez From scratch
  3. Entrez un nom d’application (ex: “AI Assistant”) et sélectionnez votre espace de travail
  4. Cliquez sur Create App
2

Activer le Socket Mode

  1. Dans la barre latérale gauche, allez dans Socket Mode
  2. Basculez Enable Socket Mode sur ON
  3. Donnez un nom au token (ex: “claw-socket”) et cliquez sur Generate
  4. Copiez l’App-Level Token (commence par xapp-) — vous en aurez besoin
3

Configurer les permissions du bot

  1. Allez dans OAuth & Permissions dans la barre latérale
  2. Sous Bot Token Scopes, ajoutez ces scopes :
    • chat:write — Envoyer des messages
    • im:history — Lire l’historique des DM
    • im:read — Voir les DM
    • im:write — Démarrer des DM
    • app_mentions:read — Détecter les @mentions
  3. Cliquez sur Install to Workspace en haut
  4. Autorisez l’application
  5. Copiez le Bot User OAuth Token (commence par xoxb-)
4

Activer les événements

  1. Allez dans Event Subscriptions dans la barre latérale
  2. Basculez Enable Events sur ON
  3. Sous Subscribe to bot events, ajoutez :
    • message.im — Messages dans les DM
    • app_mention — @mentions dans les canaux
  4. Cliquez sur Save Changes
5

Configurer dans le tableau de bord LemonData

  1. Allez sur votre Claw Dashboard
  2. Cliquez sur l’icône de paramètres de votre instance
  3. Ouvrez l’onglet IM Integrations
  4. Développez la section Slack
  5. Collez votre App Token (xapp-...) et votre Bot Token (xoxb-...)
  6. Cliquez sur Save
6

Commencer à discuter

  1. Dans Slack, envoyez un DM à votre bot ou mentionnez-le (@mention) dans un canal
  2. Le premier utilisateur est automatiquement associé en tant que propriétaire — aucun code n’est nécessaire !
  3. Commencez à discuter avec l’IA !

Contrôle d’accès

Paramètres de groupe

Configurez l’accès aux canaux dans l’onglet IM Integrations de votre tableau de bord :
ParamètreOptionsDescription
Group PolicyOpen (par défaut) / Allowlist / DisabledContrôle les canaux dans lesquels le bot répond
Require @mentionOn / OffLe bot répond uniquement lorsqu’il est mentionné (@mention)
Group IDsListe d’IDs de canauxRestreindre à des canaux spécifiques (vide = tous les canaux)
Group Allowed UsersListe d’IDs d’utilisateursSeuls ces utilisateurs peuvent déclencher le bot (mode allowlist)
Par défaut, Slack utilise la politique de groupe open — le bot répond dans tous les canaux où il est invité. Utilisez allowlist pour restreindre l’accès à des canaux spécifiques.

Dépannage

  • Vérifiez que les deux tokens sont corrects (le App Token commence par xapp-, le Bot Token par xoxb-)
  • Vérifiez que l’événement message.im est bien souscrit
  • Assurez-vous que l’application est installée dans votre espace de travail
  • Vérifiez que le scope app_mentions:read et l’événement app_mention sont configurés
  • Le bot doit d’abord être invité dans le canal (tapez /invite @nomdubot)
  • Assurez-vous d’utiliser l’App-Level Token (xapp-) pour le champ App Token, et non le Bot Token
  • Le Bot Token (xoxb-) va dans le champ Bot Token