Slack
Connectez un Workspace Slack à ElevenLabs Agents pour échanger avec un agent dans les canaux et fils de discussion
Présentation
L’intégration Slack permet à un agent ElevenLabs d’envoyer et de recevoir des messages dans Slack. Une fois connecté, l’agent répond dans un fil lorsqu’il est mentionné dans un canal et conserve un contexte de conversation distinct pour chaque fil.
Fonctionnalités
Configuration
L’intégration propose deux méthodes de connexion :
- OAuth : installez l’application Slack partagée d’ElevenLabs dans votre Workspace. Un Workspace Slack correspond à une seule connexion ElevenLabs. C’est la configuration la plus rapide et elle ne nécessite pas de gérer une application Slack.
- Utiliser votre propre application : connectez-vous avec une application Slack que vous créez et détenez. Utilisez cette option si le bot doit apparaître sous votre marque ou si les règles de votre Workspace exigent que les applications soient installées par un administrateur.
Option A : OAuth
L’utilisateur qui installe l’application doit être autorisé à ajouter des applications au Workspace Slack cible.
Ouvrir la page des intégrations
Dans le Dashboard ElevenLabs, accédez à Agents > Intégrations, puis sélectionnez Slack.
Option B : utiliser votre propre application Slack
Utilisez cette option si vous souhaitez que le bot apparaisse sous le nom et l’icône de votre propre application, ou si votre Workspace exige que les applications soient examinées et installées par votre administrateur.
Créer une application Slack
Accédez à Slack API: Your Apps, puis cliquez sur Create New App > From scratch. Nommez l’application et choisissez le Workspace Slack dans lequel l’installer.
Ajouter les autorisations du bot
Ouvrez OAuth & Permissions et ajoutez les Bot Token Scopes suivants :
app_mentions:read, channels:history, channels:join, channels:manage, chat:write, files:read, groups:history, groups:write, im:history, reactions:write.
Cliquez ensuite sur Install to Workspace et approuvez. Copiez le Bot User OAuth Token (il commence par xoxb-).
Copier le secret de signature
Ouvrez Basic Information > App Credentials et copiez le Signing Secret.
Créer la connexion dans ElevenLabs
Dans le Dashboard ElevenLabs, accédez à Intégrations, cliquez sur le bouton Ajouter une intégration, puis choisissez Slack. Choisissez les identifiants Utiliser votre propre application. Collez le jeton du bot et le secret de signature, puis enregistrez. ElevenLabs vérifie le jeton auprès de Slack et enregistre l’ID de votre Workspace.
Une fois la connexion créée, la page de connexion affiche deux URL de webhook dérivées de l’identité de votre application Slack. La même application Slack, reconnectée depuis le même Workspace ElevenLabs, produit toujours les mêmes URL. Vous pouvez donc supprimer et recréer la connexion sans devoir mettre à jour à nouveau la configuration de votre application Slack. Gardez cette page ouverte pour les étapes suivantes.
Configurer les abonnements aux événements
Dans votre application Slack, ouvrez Event Subscriptions, activez les événements et collez l’URL des événements de la page de connexion ElevenLabs dans Request URL. Slack vérifiera l’URL à l’aide du secret de signature que vous avez fourni.
Abonnez-vous aux événements de bot selon le comportement souhaité de l’agent dans les canaux :
- Mentions uniquement : abonnez-vous à
app_mention. L’agent répond uniquement lorsqu’un utilisateur mentionne le bot avec@. - Tous les messages : abonnez-vous à
message.channelsetmessage.groups. L’agent répond à chaque message dans les canaux où se trouve le bot, sans nécessiter de mention.
Si vous utilisez le déclencheur SlackDirectMessage, abonnez-vous également à message.im.
Ne vous abonnez pas à la fois à app_mention et aux événements de canal message.*, sauf si vous prévoyez de gérer les livraisons en double. Lorsqu’un utilisateur mentionne le bot avec @, Slack peut envoyer à la fois un événement app_mention et un événement message pour le même message, ce qui entraîne deux réponses de l’agent.
Un Workspace Slack ne peut être connecté qu’une seule fois via l’application OAuth partagée d’ElevenLabs. Une réinstallation
depuis un autre Workspace ElevenLabs renvoie une erreur duplicate Slack workspace. Supprimez d’abord la
connexion existante. Les connexions utilisant votre propre application sont indépendantes et n’entrent pas en conflit.
Autorisations OAuth
L’application Slack d’ElevenLabs demande les autorisations suivantes :
Outils de l’agent
Lorsque vous ajoutez des outils Slack à un agent, les outils intégrés suivants sont disponibles :
Supprimer la connexion
La suppression de la connexion depuis la page Intégrations désinstalle l’application Slack d’ElevenLabs du Workspace Slack. Après la suppression, le bot n’est plus présent dans aucun canal.
Pour les connexions utilisant votre propre application, ElevenLabs ne peut pas désinstaller une application qui ne lui appartient pas. La suppression de la connexion efface uniquement le mappage local. Pour supprimer entièrement le bot de votre Workspace Slack, désinstallez l’application depuis les paramètres d’administration Slack.
Configurer le déclencheur
L’intégration expose un seul déclencheur, SlackMessage. Il se déclenche lorsque le bot reçoit un nouveau message utilisateur dans un canal configuré.
Ajouter un déclencheur SlackMessage
Sur la page de configuration de votre agent, ajoutez un nouveau déclencheur et sélectionnez SlackMessage.
Slack n’autorise pas les applications à rejoindre automatiquement les canaux privés. Pour un canal privé, exécutez /invite @Eleven dans ce canal après avoir enregistré le déclencheur afin que le bot puisse voir les messages.
Un seul déclencheur est autorisé pour chaque paire (Slack workspace, channel). Modifiez le déclencheur existant
au lieu d’en créer un doublon.
Configurer le déclencheur de messages directs
Le déclencheur SlackDirectMessage permet à tout utilisateur Slack de discuter avec l’agent en envoyant un message direct au bot. Contrairement au déclencheur de canal, aucune mention avec @ n’est nécessaire : chaque message envoyé par un utilisateur dans un DM avec le bot est traité.
Pour les applications BYO, assurez-vous d’être abonné à l’événement de bot message.im et d’avoir ajouté l’autorisation de bot
im:history. Réinstallez l’application si cela vous est demandé après les avoir ajoutés.
Un seul déclencheur DM est autorisé par connexion Slack. Pour modifier l’agent, modifiez le déclencheur existant.
Parler au bot dans Slack
Une fois le déclencheur actif et le bot présent dans le canal, démarrez une conversation dans un fil de canal. La manière de poursuivre le fil dépend des abonnements aux événements de votre application Slack (OAuth utilise le comportement de mentions uniquement).
Mentions uniquement (app_mention)
Tous les messages (message.channels, message.groups)
Pendant que le bot génère une réponse, il ajoute une réaction :eyes: au message déclencheur de l’utilisateur et la supprime une fois la réponse publiée.
Le paramètre Répondre aux messages de du déclencheur de message de canal définit qui peut déclencher l’agent :
- Humains uniquement (par défaut) : les messages d’autres bots et des workflows Slack sont ignorés. Ce réglage sûr par défaut préserve le comportement des déclencheurs existants.
- Humains et bots : les messages d’autres bots et les messages publiés par des workflows, y compris les anciens événements
bot_message, déclenchent également l’agent.
Le bot ignore toujours ses propres messages, en utilisant l’identité de l’utilisateur bot et de l’application dans le webhook signé de Slack, quel que soit le réglage. Il ne se répond donc jamais à lui-même, même s’il est lui-même mentionné. Il continue également d’ignorer les messages modifiés (message_changed) et supprimés (message_deleted). Il gère les événements message et app_mention et fonctionne dans les canaux publics comme privés.
Les anciens événements de bot qui contiennent uniquement un bot_id identifient l’expéditeur, mais pas l’application destinataire. Ils
sont traités comme des messages provenant d’un autre bot. La détection des boucles automatiques pour cette application Slack utilise l’identité de l’utilisateur bot
ou de l’application incluse dans les charges utiles des événements Slack modernes.
Si votre application Slack est abonnée à la fois à app_mention et à message.channels / message.groups, une
seule mention avec @ peut déclencher deux réponses de l’agent. Abonnez-vous à un mode ou à l’autre.
Modèle de conversation
L’ID de conversation est déterministe pour chaque (agent_id, channel_id, thread_ts) :
- Un nouveau fil Slack correspond à une nouvelle conversation ElevenLabs.
- La poursuite du même fil poursuit la même conversation, y compris l’historique de la transcription et les variables dynamiques.
Lors de la création de l’historique de discussion, le bot lit directement le fil Slack. Les messages des membres Slack et d’autres bots sont traités comme des tours utilisateur, tandis que les propres messages du bot sont traités comme des tours d’agent. Les mentions de l’utilisateur bot (<@BOT_USER_ID>) sont remplacées par @<agent_name> avant leur traitement par l’agent.
Variables dynamiques
Lorsqu’un agent s’exécute depuis Slack, les variables dynamiques suivantes sont disponibles dans les prompts et les outils :
Consultez les variables dynamiques pour savoir comment les référencer dans les prompts et les appels d’outils.
Dépannage
Les pièces jointes ne fonctionnent pas
Lorsqu’un utilisateur joint une image ou un PDF dans Slack, mais que l’agent ne le traite pas, ou se comporte comme si aucun fichier n’avait été envoyé, effectuez les vérifications ci-dessous.
Vérifier que l’application Slack dispose de files:read
Le bot a besoin de l’autorisation de bot files:read pour télécharger les pièces jointes depuis Slack.
- Utiliser votre propre application : ouvrez votre application dans Slack API: Your Apps, accédez à OAuth & Permissions et vérifiez que
files:readfigure dans les Bot Token Scopes. Si vous venez de l’ajouter, réinstallez l’application dans votre Workspace afin que le jeton obtienne la nouvelle autorisation.
Vérifier que le modèle de l’agent prend en charge les fichiers
Les pièces jointes sont transférées uniquement lorsque le LLM de l’agent prend en charge les entrées multimodales, c’est-à-dire les images et/ou les documents PDF, selon le type de fichier. Dans la configuration de l’agent, ouvrez l’onglet Agent et vérifiez le modèle sélectionné. Si le modèle ne prend pas en charge le type de pièce jointe, choisissez-en un qui le prend en charge.
Activer Autoriser les pièces jointes dans les paramètres de l’agent
Sur la page de configuration de l’agent, ouvrez Paramètres > Avancé. Sous Entrée multimodale, activez Autoriser les pièces jointes. Enregistrez l’agent. Sans ce réglage, les pièces jointes Slack sont ignorées même lorsque l’application Slack et le modèle prennent en charge les fichiers.