Guide de l’app Slack

OOMOL vous permet de connecter un espace de travail Slack une seule fois, puis de rendre des outils Slack autorisés disponibles aux agents IA pris en charge et aux Skills réutilisables via des appels d’outils approuvés. Ce guide explique comment installer et connecter l’app Slack, quelles permissions Slack OOMOL utilise, ce que vous pouvez faire avec elle, comment résoudre les problèmes courants et comment supprimer l’app.

OOMOL exige que les utilisateurs se connectent avant de relier des comptes externes. Pour installer l’app Slack, connectez-vous à OOMOL, ouvrez la page de connexion Slack, puis choisissez Connect pour lancer le flux d’autorisation OAuth Slack.

Connecter Slack dans OOMOL

Prérequis

• Un compte OOMOL.
• Un compte Slack dans l’espace de travail que vous voulez connecter.
• La permission d’installer ou d’autoriser des apps Slack dans cet espace de travail.
• Accès à OOMOL Console sur https://console.oomol.com/.
• Si votre espace de travail Slack restreint l’installation d’apps, un propriétaire ou administrateur Slack peut devoir approuver l’app OOMOL avant que vous puissiez l’autoriser.

Ajouter l’app

1. Connectez-vous à OOMOL Console.
2. Ouvrez Slack dans App Connections, ou ouvrez App Connections et recherchez Slack.
3. Sélectionnez Slack, puis choisissez Connect.
4. OOMOL vous redirige vers Slack. Connectez-vous à Slack si cela vous est demandé.
5. Sélectionnez l’espace de travail Slack que vous voulez connecter si Slack vous demande d’en choisir un.
6. Vérifiez l’écran d’autorisation Slack, y compris les permissions demandées.
7. Sélectionnez Allow pour autoriser OOMOL.
8. Après le retour de Slack vers OOMOL, confirmez que Slack apparaît comme connecté dans vos connexions OOMOL.

Si une étape échoue, consultez Dépannage.

Après l’autorisation, OOMOL stocke la connexion nécessaire pour appeler les outils Slack en votre nom. Vous pouvez ensuite utiliser les outils Slack depuis les agents pris en charge par OOMOL et les Skills réutilisables via des appels d’outils approuvés.

Ce qu’OOMOL fait dans Slack

L’app Slack OOMOL rend des actions Slack disponibles après la connexion d’un espace de travail. Selon l’action exécutée, OOMOL peut lire les canaux et fils accessibles à l’app connectée, publier des messages en tant qu’app OOMOL, répondre dans des fils, programmer des messages, téléverser des fichiers, ouvrir des messages directs et ajouter ou supprimer des réactions emoji.

OOMOL ne commence pas à utiliser Slack de lui-même après l’installation. Un outil Slack s’exécute lorsqu’un utilisateur autorisé, un Skill réutilisable, une action d’agent prise en charge ou un appel d’outil OOMOL approuvé fournit la destination et le contenu requis.

Après l’installation

Après le retour de Slack vers OOMOL, vérifiez que la connexion Slack est marquée comme connectée dans OOMOL Console. Vous pouvez ensuite :

• Configurer oo-cli si vous voulez utiliser les outils Slack connectés dans un environnement d’agent IA pris en charge.
• Utiliser un canal de test pour lister les canaux Slack visibles, lire des messages récents, publier un message de démonstration, répondre dans un fil, téléverser un fichier de démonstration ou ajouter une réaction de test.
• Inviter l’app OOMOL dans tout canal privé où vous voulez qu’elle lise ou publie, si la politique de votre espace de travail exige que l’app soit membre de ce canal.

Utilisation

Les outils Slack sont disponibles uniquement après la connexion d’un espace de travail Slack. La liste exacte des outils affichés dans OOMOL peut changer lorsque le connecteur est mis à jour, mais le connecteur Slack actuel inclut des outils pour lire les conversations, lire les fils, envoyer des messages, répondre aux fils, programmer des messages, gérer les messages publiés par le bot, travailler avec des fichiers, lire les utilisateurs, ouvrir des messages directs et gérer les réactions emoji.

Utiliser les outils Slack avec oo-cli

Pour rendre les outils Slack connectés disponibles dans un environnement d’agent IA pris en charge, installez et configurez oo-cli après vous être connecté à OOMOL.

1. Connectez-vous à OOMOL Console.
2. Ouvrez la page d’installation de oo-cli.
3. Suivez les instructions de cette page. Elle fournit un prompt copiable en un clic pour installer et configurer oo-cli dans un environnement d’agent IA pris en charge.
4. Une fois oo-cli configuré et Slack connecté dans OOMOL, demandez à l’agent d’utiliser les outils Slack connectés avec des canaux, messages et fichiers de démonstration.

Le prompt exact dépend de l’environnement. Vous pouvez par exemple demander à l’agent de lister les canaux Slack visibles, lire les messages récents dans un canal de test, publier un message de démonstration, répondre dans un fil ou ajouter une réaction à un message de test.

Permissions utilisées

OOMOL utilise les permissions Slack pour permettre à un utilisateur Slack autorisé de connecter un espace de travail comme App dans OOMOL, puis de rendre les outils Slack approuvés disponibles aux agents et aux Skills réutilisables.

Les scopes exacts affichés pendant l’OAuth Slack sont la source de vérité pour votre installation. Selon les outils activés pour votre espace de travail, OOMOL peut demander des permissions dans ces catégories :

Si un administrateur Slack n’accorde pas une permission requise, la connexion Slack peut échouer, ou les outils qui dépendent de cette permission peuvent être indisponibles jusqu’à ce qu’elle soit accordée.

Outils Slack pris en charge

Lire les conversations et les fils

Cas d’utilisation : permettre à un agent d’examiner des messages Slack récents ou un fil précis avant de résumer des mises à jour, extraire des actions, préparer une réponse ou router le travail vers un autre outil connecté.

Prérequis :

• Slack est connecté dans OOMOL.
• L’app Slack connectée peut accéder à la conversation ou au fil cible.
• L’agent, Skill ou appel d’outil dispose du bon identifiant de canal, conversation, message ou fil.

Ce que font les outils :

• Lire les métadonnées de conversation, messages récents et réponses de fils visibles par l’app Slack connectée.
• Retourner les données Slack rendues disponibles par l’autorisation de l’espace de travail connecté.
• Ne pas publier, mettre à jour, supprimer ni réagir aux messages pendant les actions en lecture seule.

Envoyer et gérer des messages

Cas d’utilisation : permettre à un agent de publier une mise à jour, répondre à un fil, programmer un rappel, envoyer un message éphémère à un utilisateur ou mettre à jour un message publié par le bot après la fin d’une tâche.

Prérequis :

• Slack est connecté dans OOMOL.
• Le canal, la conversation, l’utilisateur, le message ou le fil cible est connu.
• L’utilisateur, Skill ou agent a fourni le contenu du message et approuvé la destination.

Ce que font les outils :

• Publier des messages texte ou Block Kit lorsque le contenu est fourni.
• Répondre dans des fils existants lorsqu’un message parent est fourni.
• Programmer des messages pour une heure future lorsque Slack accepte la destination et l’horodatage.
• Mettre à jour ou supprimer des messages uniquement lorsque l’app connectée est autorisée à gérer le message cible.

Travailler avec des fichiers et réactions

Cas d’utilisation : permettre à un agent de partager un fichier dans Slack, inspecter les métadonnées d’un fichier ou ajouter une réaction qui marque un message comme accusé de réception, en file, terminé ou nécessitant un suivi.

Prérequis :

• Slack est connecté dans OOMOL.
• La conversation, le fichier, le message ou le nom de réaction cible est connu.
• Pour le téléversement de fichier, le fichier doit être disponible via une URL que le runtime du connecteur peut récupérer.

Ce que font les outils :

• Téléverser des fichiers dans Slack lorsqu’une URL de fichier et une destination sont fournies.
• Lire les métadonnées de fichiers et réactions visibles par l’app connectée.
• Ajouter ou supprimer des réactions lorsque Slack l’autorise pour l’app connectée.
• Supprimer des fichiers uniquement lorsque l’app connectée est autorisée à supprimer le fichier cible.

Tester l’app

Vous pouvez tester l’app Slack avec un espace de travail Slack dans lequel vous êtes autorisé à installer des apps. Utilisez un canal de test et des messages de démonstration pour tester en sécurité les actions de lecture, publication, mise à jour, fichier et réaction.

Prompts de test

• Liste les canaux publics Slack visibles par l’app connectée.
• Récupère les messages récents du canal #oomol-test.
• Publie Hello from OOMOL dans le canal #oomol-test.
• Réponds au dernier message de test avec Received.
• Ajoute la réaction white_check_mark à un message de test.
• Récupère les réactions du message de test.
• Programme un message Slack dans le canal de test pour plus tard aujourd’hui.
• Téléverse un fichier de démonstration dans le canal de test.
• Liste les utilisateurs Slack visibles par l’app connectée.
• Ouvre un message direct avec un utilisateur de test.

Utilisez uniquement des données de démonstration pendant les tests. N’utilisez pas de données Slack réelles de clients, d’employés ou confidentielles dans les prompts de test.

Dépannage

Je ne peux pas ajouter l’app Slack

• Vérifiez que vous êtes connecté au bon compte OOMOL.
• Vérifiez que vous vous connectez à l’espace de travail Slack que vous voulez relier.
• Si votre espace de travail Slack exige une approbation d’app, demandez à un propriétaire ou administrateur Slack d’approuver l’app OOMOL.
• Essayez de déconnecter toute connexion Slack échouée ou partielle dans OOMOL, puis reconnectez-la.
• Si le problème continue, contactez le support OOMOL et incluez l’e-mail du compte OOMOL, le nom ou l’ID de l’espace de travail Slack si disponible, l’heure de la tentative et tout message d’erreur ou capture d’écran.

Un outil Slack ne trouve pas un canal ou une conversation

• Confirmez que l’app Slack connectée peut accéder à la conversation cible.
• Si la cible est un canal privé, confirmez que l’app connectée a été ajoutée à ce canal ou dispose des permissions d’espace de travail requises.
• Confirmez que la demande utilise le bon ID de conversation, nom de canal ou entrée de recherche.
• Si vous avez récemment modifié les permissions Slack, reconnectez Slack dans OOMOL afin de rafraîchir l’état d’autorisation.

Un outil Slack ne peut pas lire les messages

• Confirmez que l’app Slack connectée a la permission de lire l’historique de la conversation cible.
• Confirmez que l’app est présente dans le canal privé si le message se trouve dans un canal privé.
• Vérifiez que la demande utilise le bon horodatage de message, horodatage de fil ou ID de conversation.
• Si l’espace de travail a récemment modifié les scopes d’app ou l’accès aux canaux, reconnectez Slack dans OOMOL.

Un outil Slack ne peut pas publier ou mettre à jour un message

• Confirmez que l’app Slack connectée peut publier dans la conversation cible.
• Confirmez que l’appel d’outil contient une destination valide et un corps de message.
• Pour les actions de mise à jour et suppression, confirmez que le message cible a été publié par l’app Slack connectée et peut être géré par elle.
• Si Slack retourne une erreur de politique d’espace de travail ou de permission, demandez à un propriétaire ou administrateur Slack de vérifier les permissions de l’app.

Une action de fichier Slack échoue

• Pour les téléversements, confirmez que l’URL du fichier est accessible au runtime du connecteur.
• Confirmez que l’app Slack connectée peut accéder à la conversation cible.
• Pour les suppressions, confirmez que l’app connectée est autorisée à supprimer le fichier cible.

Supprimer l’app

Vous pouvez supprimer l’app Slack depuis OOMOL ou Slack. Nous recommandons de la supprimer des deux endroits si vous ne voulez plus qu’OOMOL accède à Slack.

Supprimer Slack d’OOMOL

1. Connectez-vous à OOMOL Console.
2. Ouvrez Connections.
3. Trouvez Slack dans vos apps connectées.
4. Ouvrez les détails de connexion Slack.
5. Choisissez Disconnect, Remove ou l’action de suppression équivalente affichée dans OOMOL.
6. Confirmez la suppression.

Supprimer OOMOL de Slack

1. Connectez-vous à Slack dans l’espace de travail connecté.
2. Ouvrez Manage apps ou la page de gestion des apps Slack de votre espace de travail.
3. Trouvez OOMOL.
4. Ouvrez les détails de l’app.
5. Choisissez l’action permettant de supprimer, désinstaller ou révoquer l’app.
6. Confirmez la suppression.

Si vous ne pouvez pas supprimer des apps dans Slack, demandez à un propriétaire ou administrateur Slack de supprimer l’app.

Ce qui se passe après la suppression

• OOMOL ne peut plus utiliser les outils Slack pour votre espace de travail après la suppression ou la désautorisation de la connexion Slack.
• Les agents, Skills ou autres tâches qui dépendent de Slack peuvent échouer jusqu’à ce que vous reconnectiez Slack.
• Les messages, fichiers, canaux et réactions Slack créés avant la suppression restent dans Slack sauf si vous les supprimez ou modifiez dans Slack.
• Supprimer l’app ne supprime pas votre compte OOMOL.

Traitement des données

OOMOL accède aux données Slack uniquement après qu’un utilisateur Slack a autorisé l’app et qu’un utilisateur, Skill ou action d’agent approuvée a besoin de Slack. OOMOL utilise les données Slack uniquement pour fournir les outils Slack demandés via les agents pris en charge par OOMOL, les Skills réutilisables et les appels d’outils approuvés.

• Les tokens OAuth Slack sont stockés chiffrés.
• Les tokens OAuth Slack ne sont pas exposés aux agents IA, prompts, fichiers de projet ou utilisateurs finaux.
• OOMOL peut traiter les métadonnées d’espace de travail Slack, métadonnées de conversation, messages, réponses de fils, fichiers, métadonnées utilisateur et réactions lorsqu’un outil Slack est appelé.
• Les données Slack peuvent être stockées uniquement si nécessaire dans les résultats d’outils visibles par l’utilisateur, les journaux d’utilisation, l’historique d’exécution ou les enregistrements opérationnels.
• Les données stockées sont chiffrées au repos et transmises via TLS/SSL.
• OOMOL ne vend pas vos données Slack.
• OOMOL n’utilise pas vos données Slack pour la publicité.
• OOMOL n’utilise pas le contenu client privé pour entraîner des modèles IA.
• OOMOL ne synchronise pas et ne réplique pas en continu les données de l’espace de travail Slack en arrière-plan dans le cadre de ce connecteur. Les données Slack sont consultées lorsqu’un utilisateur autorisé, Skill ou action d’agent approuvée appelle un outil Slack.
• Lorsque vous supprimez ou désautorisez l’app Slack, OOMOL cesse d’utiliser l’autorisation Slack révoquée. OOMOL supprime ou invalide les tokens d’autorisation Slack stockés selon son processus normal de suppression de connexion.
• Certains journaux, enregistrements de support, enregistrements de sécurité ou enregistrements liés à la facturation peuvent être conservés comme décrit dans la politique de confidentialité.

FAQ

Ai-je besoin d’un espace de travail Slack payant ?

La plupart des outils Slack d’OOMOL nécessitent un espace de travail Slack qui autorise les permissions d’app demandées. Certaines fonctionnalités Slack, contrôles d’approbation d’app, paramètres de conservation ou politiques d’espace de travail peuvent dépendre de votre plan Slack ou des paramètres de votre organisation.

Puis-je connecter plusieurs espaces de travail Slack ?

Utilisez OOMOL Console pour vérifier les options de connexion actuellement disponibles pour votre compte ou espace de travail. Si vous avez besoin d’aide avec plusieurs espaces de travail Slack, contactez le support.

Un agent peut-il utiliser Slack automatiquement après la connexion ?

Connecter Slack rend les outils Slack disponibles dans OOMOL, mais leur utilisation dépend toujours de l’agent, du Skill, des permissions et des approbations que vous choisissez. Les services basés sur des comptes exigent toujours votre autorisation.

OOMOL lit-il tous les messages Slack après la connexion ?

Non. OOMOL ne synchronise pas tous les messages Slack en continu. Les données Slack sont consultées lorsqu’un utilisateur autorisé, Skill ou action d’agent approuvée appelle un outil Slack pour une conversation accessible par l’app connectée.

OOMOL peut-il supprimer des messages ou fichiers Slack ?

Le connecteur Slack actuel inclut des actions de suppression pour les messages publiés par le bot et les fichiers que l’app connectée est autorisée à supprimer. OOMOL ne supprime pas de contenu Slack sauf si un utilisateur ou appel d’outil approuvé utilise un outil de suppression pris en charge avec les informations de cible requises.

Contacter le support

Si vous avez besoin d’aide pour ajouter, utiliser, tester ou supprimer l’app Slack, contactez le support OOMOL :

• Email : support@oomol.com
• Page de support : https://oomol.com/fr/support/

Veuillez inclure l’e-mail de votre compte OOMOL, le nom ou l’ID de l’espace de travail Slack si pertinent, l’action que vous essayiez d’effectuer et tout message d’erreur ou capture d’écran.