Slack
Verbind een Slack-workspace met ElevenLabs Agents om met een agent te chatten in kanalen en threads
Overzicht
Met de Slack-integratie kan een ElevenLabs-agent berichten verzenden en ontvangen in Slack. Zodra de verbinding is gemaakt, reageert de agent in een thread wanneer deze in een kanaal wordt genoemd en behoudt deze voor elke thread een afzonderlijke gesprekscontext.
Mogelijkheden
Instellen
De integratie biedt twee manieren om verbinding te maken:
- OAuth — installeer de gedeelde ElevenLabs Slack-app in je workspace. Eén Slack-workspace is gekoppeld aan één ElevenLabs-verbinding. De snelste installatie, zonder Slack-appbeheer.
- Je eigen app gebruiken — maak verbinding met een Slack-app die je zelf maakt en beheert. Gebruik dit als je wilt dat de bot onder je merk verschijnt of als je workspacebeleid vereist dat apps door een beheerder worden geïnstalleerd.
Optie A — OAuth
De gebruiker die de app installeert, moet toestemming hebben om apps aan de doel-Slack-workspace toe te voegen.
Open de integratiepagina
Ga in het ElevenLabs-dashboard naar Agents > Integrations en selecteer Slack.
Optie B — Je eigen Slack-app gebruiken
Gebruik dit als je wilt dat de bot verschijnt onder je eigen appnaam en pictogram, of als je workspace vereist dat apps door je beheerder worden beoordeeld en geïnstalleerd.
Maak een Slack-app
Ga naar Slack API: Your Apps en klik op Create New App > From scratch. Geef de app een naam en kies de Slack-workspace waarin je deze wilt installeren.
Voeg bot-scopes toe
Open OAuth & Permissions en voeg de volgende Bot Token Scopes toe:
app_mentions:read, channels:history, channels:join, channels:manage, chat:write, files:read, groups:history, groups:write, im:history, reactions:write.
Klik vervolgens op Install to Workspace en keur dit goed. Kopieer de Bot User OAuth Token (begint met xoxb-).
Maak de verbinding in ElevenLabs
Ga in het ElevenLabs-dashboard naar Integrations, klik op de knop Add integration en kies Slack. Kies de credential Bring your own app. Plak de bottoken en het signing secret en sla op. ElevenLabs verifieert de token bij Slack en slaat je workspace-id op.
Nadat de verbinding is gemaakt, toont de verbindingspagina twee webhook-URL’s die zijn afgeleid van de identiteit van je Slack-app. Dezelfde Slack-app, opnieuw verbonden vanuit dezelfde ElevenLabs-workspace, levert altijd dezelfde URL’s op — je kunt de verbinding dus verwijderen en opnieuw maken zonder de configuratie van je Slack-app opnieuw bij te werken. Houd die pagina open voor de volgende stappen.
Configureer Event Subscriptions
Open in je Slack-app Event Subscriptions, schakel events in en plak de Events URL van de ElevenLabs-verbindingspagina in Request URL. Slack verifieert de URL met het signing secret dat je hebt opgegeven.
Abonneer je op bot-events op basis van hoe je wilt dat de agent zich in kanalen gedraagt:
- Alleen vermeldingen — abonneer je op
app_mention. De agent reageert alleen wanneer een gebruiker de bot met@vermeldt. - Alle berichten — abonneer je op
message.channelsenmessage.groups. De agent reageert op elk bericht in kanalen waarin de bot aanwezig is, zonder dat een vermelding nodig is.
Als je de trigger SlackDirectMessage gebruikt, abonneer je dan ook op message.im.
Abonneer je niet zowel op app_mention als op de kanaal-events message.*, tenzij je dubbele leveringen wilt verwerken. Wanneer een gebruiker de bot met @ vermeldt, kan Slack zowel een app_mention-event als een message-event voor hetzelfde bericht versturen, waardoor de agent twee keer reageert.
Een Slack-workspace kan slechts één keer worden verbonden via de gedeelde ElevenLabs OAuth-app. Bij opnieuw installeren
vanuit een andere ElevenLabs-workspace krijg je de fout duplicate Slack workspace — verwijder eerst de
bestaande verbinding. Verbindingen met je eigen app zijn onafhankelijk en conflicteren niet.
OAuth-scopes
De ElevenLabs Slack-app vraagt de volgende scopes aan:
Agenttools
Wanneer je Slack-tools aan een agent toevoegt, zijn de volgende ingebouwde tools beschikbaar:
De verbinding verwijderen
Als je de verbinding verwijdert vanaf de pagina Integrations, wordt de ElevenLabs Slack-app uit de Slack-workspace verwijderd. Na verwijdering is de bot niet meer aanwezig in kanalen.
Voor verbindingen met je eigen app kan ElevenLabs een app die het niet beheert niet verwijderen — het verwijderen van de verbinding verwijdert alleen de lokale koppeling. Verwijder de app in je Slack-beheerdersinstellingen om de bot volledig uit je Slack-workspace te verwijderen.
Configureer de trigger
De integratie biedt één trigger: SlackMessage. Deze wordt geactiveerd wanneer de bot een nieuw gebruikersbericht in een geconfigureerd kanaal ziet.
Voeg een SlackMessage-trigger toe
Voeg op de configuratiepagina van je agent een nieuwe trigger toe en selecteer SlackMessage.
Slack staat apps niet toe automatisch deel te nemen aan privékanelen. Voer voor een privékanaal na het opslaan van de trigger
/invite @Eleven uit in dat kanaal, zodat de bot berichten kan zien.
Er is slechts één trigger toegestaan per paar (Slack-workspace, kanaal). Bewerk de bestaande trigger
in plaats van een duplicaat te maken.
Configureer de DM-trigger
Met de trigger SlackDirectMessage kan elke Slack-gebruiker met de agent chatten door de bot een direct bericht te sturen. Anders dan bij de kanaaltrigger is geen @-vermelding nodig — elk bericht dat een gebruiker in een DM met de bot verstuurt, wordt verwerkt.
Zorg er voor BYO-apps voor dat je je hebt geabonneerd op het bot-event message.im en de
bot-scope im:history hebt toegevoegd. Installeer de app opnieuw als daarom wordt gevraagd nadat je deze hebt toegevoegd.
Er is slechts één DM-trigger toegestaan per Slack-verbinding. Bewerk de bestaande trigger om de agent te wijzigen.
Met de bot praten in Slack
Zodra de trigger actief is en de bot in het kanaal aanwezig is, start je een gesprek in een kanaalthread. Hoe je de thread voortzet, hangt af van de event subscriptions van je Slack-app (OAuth gebruikt gedrag voor alleen vermeldingen).
Alleen vermeldingen (app_mention)
Alle berichten (message.channels, message.groups)
Terwijl de bot een reactie genereert, voegt deze een :eyes:-reactie toe aan het triggerende bericht van de gebruiker en verwijdert deze zodra het antwoord is geplaatst.
De instelling Respond to messages from op de Channel Message-trigger bepaalt wie de agent kan triggeren:
- Only humans (standaard): berichten van andere bots en van Slack-workflows worden genegeerd. Dit is de veilige standaard en behoudt het gedrag van bestaande triggers.
- Humans and bots: berichten van andere bots en berichten die door workflows zijn geplaatst (inclusief verouderde
bot_message-events) triggeren de agent ook.
De bot negeert altijd zijn eigen berichten — met behulp van de botgebruiker- en app-identiteit in de ondertekende webhook van Slack — ongeacht de instelling, en reageert dus nooit op zichzelf, ook niet wanneer deze zichzelf vermeldt. De bot blijft ook bewerkte berichten (message_changed) en verwijderde berichten (message_deleted) negeren. Deze verwerkt message- en app_mention-events en werkt in zowel openbare als privékanelen.
Verouderde bot-events die alleen een bot_id bevatten, identificeren de afzender maar niet de ontvangende app. Ze
worden behandeld als berichten van een andere bot; detectie van zelflussen voor deze Slack-app gebruikt de botgebruiker-
of app-identiteit die is opgenomen in moderne Slack-eventpayloads.
Als je Slack-app zich abonneert op zowel app_mention als message.channels / message.groups, kan één
@-vermelding twee agentreacties activeren. Abonneer je op de ene of de andere modus.
Gespreksmodel
De gespreks-ID is deterministisch per (agent_id, channel_id, thread_ts):
- Een nieuwe Slack-thread wordt gekoppeld aan een nieuw ElevenLabs-gesprek.
- Het voortzetten van dezelfde thread zet hetzelfde gesprek voort, inclusief transcripthistorie en dynamische variabelen.
Bij het samenstellen van de chatgeschiedenis leest de bot de Slack-thread rechtstreeks. Berichten van Slack-leden en andere bots worden behandeld als gebruikersbeurten, terwijl de eigen berichten van de bot worden behandeld als agentbeurten. Vermeldingen van de botgebruiker (<@BOT_USER_ID>) worden herschreven naar @<agent_name> voordat de agent ze verwerkt.
Dynamische variabelen
Wanneer een agent vanuit Slack wordt uitgevoerd, zijn de volgende dynamische variabelen beschikbaar in prompts en tools:
Zie dynamische variabelen voor informatie over hoe je deze in prompts en toolaanroepen gebruikt.
Problemen oplossen
Bestandsbijlagen werken niet
Wanneer een gebruiker een afbeelding of PDF toevoegt in Slack, maar de agent deze niet verwerkt (of zich gedraagt alsof er geen bestand is verstuurd), doorloop dan de onderstaande controles.
Controleer of de Slack-app files:read heeft
De bot heeft de bot-scope files:read nodig om bijlagen van Slack te downloaden.
- Je eigen app gebruiken — open je app via Slack API: Your Apps, ga naar OAuth & Permissions en controleer of
files:readvermeld staat onder Bot Token Scopes. Als je deze onlangs hebt toegevoegd, installeer de app dan opnieuw in je workspace zodat de token de nieuwe scope krijgt.
Controleer of het agentmodel bestandsinvoer ondersteunt
Bestandsbijlagen worden alleen doorgestuurd wanneer de LLM van de agent multimodale invoer ondersteunt — invoer van afbeeldingen en/of documenten (PDF), afhankelijk van het bestandstype. Open in de agentconfiguratie het tabblad Agent en controleer het geselecteerde model. Als het model het bijlagetype niet ondersteunt, schakel dan over naar een model dat dit wel doet.
Schakel Allow file attachments in bij de agentinstellingen
Open op de configuratiepagina van de agent Settings > Advanced. Schakel onder Multimodal input Allow file attachments in. Sla de agent op. Zonder deze instelling worden Slack-bijlagen genegeerd, zelfs wanneer de Slack-app en het model bestanden ondersteunen.