Slack
Anyy se connecte à Slack par Socket Mode. Un compte fonctionnel nécessite un jeton de bot pour les opérations Web API/messages et un jeton d’application pour la connexion WebSocket.
1. Préparer l’application Slack
Dans la configuration de l’application Slack :
- Créez une application pour l’espace de travail voulu.
- Activez Socket Mode.
- Créez un jeton d’application avec la portée Socket Mode.
- Ajoutez les portées du bot nécessaires à la lecture des conversations choisies, à la publication de messages et à la récupération des fichiers pris en charge.
- Activez les abonnements aux événements de message nécessaires aux messages privés et aux conversations de groupe avec mention.
- Installez ou réinstallez l’application dans l’espace de travail après tout changement de portées.
Dashboard indique les prérequis externes pour Socket Mode, les abonnements, les portées du jeton d’application et celles du jeton de bot. Réglez-les avant d’activer le compte.
2. Connecter l’application à Anyy
Ouvrez Dashboard → Channel → Add → Slack pour l’entrée Socket Mode par défaut. Saisissez :
- le jeton de bot (
xoxb-…) ; - le jeton d’application (
xapp-…) ; - un identifiant de compte Anyy.
Définissez les règles des messages privés/groupes dans l’assistant CLI ; le formulaire d’identifiants Dashboard ne les expose pas.
Configuration CLI :
anyy setup channel
Les deux jetons sont obligatoires à l’activation du compte et sont enregistrés comme références de secrets du profil.
3. Choisir les règles
Slack utilise pairing pour les messages privés et mention pour les groupes par défaut. La règle des messages privés accepte open, allowlist, pairing ou disabled ; celle des groupes accepte mention, open, allowlist ou disabled.
Choisissez Slack dans l’assistant CLI pour changer les règles. Les listes d’autorisation existantes utilisent les ID Slack d’utilisateurs/canaux, mais les actions actuelles ne permettent pas d’en modifier les entrées. Préférez l’association pour un nouveau compte ; consultez les limites communes d’accès.
4. Recharger et tester
anyy channel reload
anyy channel doctor slack
Envoyez un message privé à l’application ou mentionnez-la dans un canal autorisé. Avec Pairing, approuvez la demande en attente :
anyy channel pairing list --channel slack
anyy channel pairing approve --request REQUEST_ID
Fils et fichiers
Anyy conserve les horodatages des fils Slack dans la route du canal et répond dans le fil d’origine. Les fichiers entrants pris en charge sont téléchargés avec l’identifiant du bot et préparés comme pièces jointes dans le périmètre concerné après vérification de leur taille.
Socket Mode ne nécessite aucune URL de webhook public entrant, mais le Gateway doit toujours disposer d’un accès réseau sortant vers Slack.
Les portées du jeton Slack sont fixées par l’autorisation de l’application installée. Changer uniquement la configuration peut ne pas mettre à jour le jeton de bot actuel avant la réinstallation de l’application.
Dépannage
| Symptôme | Points à vérifier |
|---|---|
| La socket ne se connecte pas | Socket Mode, jeton xapp-, portée et accès réseau sortant |
| Authentification réussie, aucun message reçu | Abonnements aux événements, portées du bot, installation de l’application et présence dans le canal |
| Échec de publication | Jeton xoxb- et portées d’écriture dans la conversation cible |
| Message privé retenu | Approuvez l’association, puis envoyez un nouveau message |
| Fichier illisible | Portées de fichiers, accès au téléchargement privé et limite de médias de l’adaptateur |
Pour gérer les autorisations d’accès communes, consultez Plateformes de messagerie.