Connecter Slack

À quoi sert cette connexion ?

Slack permet à ELChat de prévenir une équipe depuis une conversation : nouveau lead, incident, demande urgente, résumé ou autre événement nécessitant une intervention humaine. ELChat peut aussi retrouver ou créer le canal cible.

Ce dont vous avez besoin

ELChat demande un Bot User OAuth Token au format xoxb-xxxxxxxxxxxxxxxxxxxxx. Ce jeton représente une application Slack installée dans votre workspace.

Étape 1 — Créer l’application Slack

1. Ouvrez la page Slack API — Your Apps.
2. Cliquez sur Create New App, puis choisissez votre workspace.
3. Nommez l’application ELChat.
4. Ouvrez OAuth & Permissions.
5. Dans Bot Token Scopes, ajoutez :
   • chat:write pour envoyer un message ;
   • channels:read pour lister les canaux publics ;
   • channels:manage pour créer un canal public.
6. Installez ou réinstallez l’application dans le workspace.
7. Copiez le Bot User OAuth Token xoxb-....

Les scopes correspondent aux méthodes réellement appelées : chat.postMessage, conversations.list et conversations.create.

Étape 2 — Donner accès aux canaux

Invitez le bot ELChat dans chaque canal où il doit publier. Le scope chat:write ne permet pas par défaut de publier dans tous les canaux publics sans y être membre. ELChat ne demande pas chat:write.public.

Étape 3 — Connecter Slack à ELChat

1. Ouvrez Dashboard > votre site > Actions IA > Connecteurs.
2. Cliquez sur Connecter sur la carte Slack.
3. Collez le jeton xoxb-....
4. Validez.

Vérifier la connexion

Demandez à ELChat de lister les canaux. Vérifiez qu’un canal de test apparaît, puis envoyez-y un message non sensible. La liste implémentée est limitée à 100 canaux et ne parcourt pas les pages suivantes.

Capacités disponibles

Capacité réelle	Type
Lister les canaux accessibles au bot	Lecture
Envoyer un message dans un canal	Écriture
Créer un canal	Écriture

ELChat ne lit pas l’historique des messages, ne répond pas dans un fil, ne gère pas les fichiers et n’envoie pas de message privé.

Reconnecter et déconnecter

Faites tourner le token depuis l’application Slack, reconnectez ELChat et testez la liste des canaux. Désinstallez aussi l’application ou révoquez son jeton dans Slack pour couper complètement l’accès.

Problèmes fréquents

• invalid_auth : le jeton est incomplet, révoqué ou ne commence pas par xoxb-.
• missing_scope : ajoutez le scope indiqué puis réinstallez l’application.
• not_in_channel : invitez le bot dans le canal.
• channel_not_found : utilisez un canal retourné par la liste, pas un nom inventé.
• Limite d’envoi : Slack autorise généralement environ un message par seconde et par canal ; attendez avant de réessayer.

Sécurité

Le token du bot doit rester secret. Limitez l’application aux scopes ci-dessus, invitez-la seulement dans les canaux nécessaires et révoquez immédiatement un jeton exposé.