> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Slack ## 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 | Mogelijkheid | Ondersteuning | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Zero retention mode (ZRM) | Niet ondersteund | | Bijlagen in triggers | Afbeeldingen (PNG, JPEG, GIF, WebP) en PDF-bestanden in inkomende berichten, wanneer **Bestandsbijlagen toestaan** is ingeschakeld in de agentinstellingen en de LLM van de agent invoer van afbeeldingen of documenten ondersteunt | | Bijlagen in tools | Niet ondersteund — tools werken alleen met tekst | ## 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**. #### Klik op Connect Kies de **OAuth**-credential en klik op **Connect**. Je wordt doorgestuurd naar Slack om te kiezen in welke workspace je de ElevenLabs-app wilt installeren en om de gevraagde scopes goed te keuren. #### Voltooi de omleiding Na goedkeuring stuurt Slack je terug naar ElevenLabs en wordt de verbinding gemaakt. De Slack-workspace-ID wordt automatisch opgeslagen en gebruikt bij het configureren van triggers. ### 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](https://api.slack.com/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-`). #### Kopieer het signing secret Open **Basic Information** > **App Credentials** en kopieer het **Signing Secret**. #### 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.channels` en `message.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. #### Configureer Interactivity Open **Interactivity & Shortcuts**, schakel interactiviteit in en plak de **Interactivity URL** van de ElevenLabs-verbindingspagina in **Request URL**. #### Installeer opnieuw als daarom wordt gevraagd Als Slack je vraagt de app opnieuw te installeren nadat je scopes of events hebt gewijzigd, doe dit dan om de wijzigingen toe te passen. > **Note** > > 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: | Scope | Doel | | ------------------- | ------------------------------------------------------------------------------------------------------- | | `app_mentions:read` | Berichten ontvangen waarin de bot met `@` wordt vermeld. | | `channels:history` | Berichten lezen in openbare kanalen waarin de bot aanwezig is. | | `channels:join` | De bot automatisch laten deelnemen aan openbare kanalen wanneer een trigger wordt gemaakt. | | `channels:manage` | Acties voor kanaalbeheer uitvoeren. | | `chat:write` | Berichten plaatsen in kanalen en threads. | | `files:read` | Bestanden downloaden die aan berichten zijn toegevoegd, zodat de agent afbeeldingen en PDF's kan lezen. | | `groups:history` | Berichten lezen in privékanelen waarin de bot aanwezig is. | | `groups:write` | Werken in privékanelen. | | `im:history` | Berichten lezen in direct-messagekanalen met de bot. | | `reactions:write` | Reacties toevoegen en verwijderen, gebruikt voor de denkindicator bij berichten en agenttools. | ## Agenttools Wanneer je Slack-tools aan een agent toevoegt, zijn de volgende ingebouwde tools beschikbaar: | Tool | Beschrijving | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `slack_add_reaction` | Voegt een emoji-reactie toe. Standaard worden kanaal en bericht-`ts` ingevuld vanuit `integration__slack_channel_id` en `integration__slack_trigger_message_ts`; het model kiest alleen de emoji-shortcode (zonder dubbele punten), bijvoorbeeld `thumbsup`. Buiten door Slack getriggerde gesprekken ontbreken deze variabelen, tenzij je ze instelt — pas het toolschema aan als het model kanaal en `ts` expliciet moet doorgeven. | | `slack_remove_reaction` | Verwijdert een emoji-reactie (dezelfde standaardwaarden als bij toevoegen). Volgens Slack mag de aanroepende bot alleen reacties verwijderen die deze zelf oorspronkelijk heeft toegevoegd; zie [reactions.remove](https://docs.slack.dev/reference/methods/reactions.remove). | ## 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**. #### Kies de agent en het kanaal Configureer de triggervelden: * **Agent**: de agent die het gesprek afhandelt. * **Channel ID**: de Slack-kanaal-ID, bijvoorbeeld `C0123456789`. De UI biedt een deeplink om het kanaal in Slack te openen. #### Sla de trigger op Sla de trigger op. ElevenLabs nodigt de bot automatisch uit voor openbare kanalen. Als je de trigger later verwijdert, verlaat de bot dat kanaal. > **Info** > > 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. > **Warning** > > 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. #### Voeg een SlackDirectMessage-trigger toe Voeg op de configuratiepagina van je agent een nieuwe trigger toe en selecteer **SlackDirectMessage**. #### Kies de agent Selecteer de **Agent** die DM-gesprekken afhandelt. #### Sla de trigger op Sla de trigger op. Elke Slack-gebruiker in de workspace kan nu een DM met de bot openen en een gesprek starten. > **Info** > > 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. > **Warning** > > 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`) #### Start een thread met een vermelding Vermeld de bot in een kanaal om een nieuwe thread te starten, bijvoorbeeld `@Eleven what's the status of order 1234?`. De bot reageert in een thread onder dat bericht. #### Zet de thread voort Vermeld de bot opnieuw in elk bericht waarop je wilt dat deze reageert, ook bij vervolgberichten binnen dezelfde thread. Berichten zonder vermelding worden genegeerd. ### Alle berichten (`message.channels`, `message.groups`) #### Start een thread Verstuur een willekeurig bericht in een kanaal waarin de bot aanwezig is. De bot reageert in een thread onder dat bericht. Je hoeft de bot niet met `@` te vermelden. #### Zet de thread voort Reageer in dezelfde thread zonder de bot te vermelden. Elk nieuw bericht in de thread wordt verwerkt. 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. > **Note** > > 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. > **Warning** > > 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 `@` voordat de agent ze verwerkt. ### Dynamische variabelen Wanneer een agent vanuit Slack wordt uitgevoerd, zijn de volgende dynamische variabelen beschikbaar in prompts en tools: | Variabele | Beschrijving | | --------------------------------------- | ------------------------------------------------------------------------------------------------------- | | `integration__slack_channel_id` | Slack-kanaal-ID. | | `integration__slack_thread_ts` | Tijdstempel van de Slack-thread. | | `integration__slack_user_id` | Slack-afzender-ID. Dit is een gebruikers-ID, of een bot-ID voor verouderde bot-events zonder gebruiker. | | `integration__slack_team_id` | Slack-workspace-ID (team-ID). | | `integration__slack_connection_id` | Verbindings-ID van de ElevenLabs-integratie. | | `integration__slack_trigger_message_ts` | Slack-`ts` van het bericht dat deze agentbeurt heeft getriggerd (unieke bericht-ID in het kanaal). | Zie [dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables) 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](https://api.slack.com/apps), ga naar **OAuth & Permissions** en controleer of `files:read` vermeld 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. ## Handige links * [Slack API-documentatie](https://api.slack.com/docs) * [Slack-appmachtigingen](https://api.slack.com/scopes)