> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kowalah.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up in Slack

> Install and configure the Kowalah Agent in your Slack workspace.

Install the Kowalah Agent in your Slack workspace to give your team an always-on AI expert directly in channels and threads.

## Admin setup

A Slack workspace administrator installs the Kowalah app once for the whole workspace. It's a single step.

<Steps>
  ### Go to Integrations in Kowalah

  Sign in to [app.kowalah.com](https://app.kowalah.com) and go to **Settings** > **Integrations**. You'll see Slack listed with an install button.

  Click it, or use the button below as a shortcut:

  [  <img alt="Add to Slack" height="40" width="139" src="https://platform.slack-edge.com/img/add_to_slack.png" noZoom />](https://slack.com/oauth/v2/authorize?client_id=8403244001427.10851703583746\&scope=im:write,app_mentions:read,assistant:write,channels:history,channels:read,chat:write,groups:history,groups:read,im:history,im:read,mpim:history,mpim:read,reactions:write,users:read,users:read.email\&user_scope=)

  ### Review permissions and click Allow

  Slack will show you the permissions the Kowalah app needs:

  * Read messages where it's mentioned
  * Post replies in channels and threads
  * Read channel and user information (to identify users)

  Click **Allow** to install. The Integrations page in Kowalah will update to show Slack as **Connected**, and the bot is immediately available in your workspace.
</Steps>

<Note>
  The admin only needs to do this once. It doesn't matter whether you click the button here or in the app — both hit the same connection and the status will show as Connected in your Kowalah settings either way.
</Note>

## Individual user setup

Once the app is installed in the workspace, each user connects their Kowalah identity the first time they interact with it.

<Steps>
  ### Mention @Kowalah

  In any channel or thread, type `@Kowalah` followed by a question or request.

  ### Link your account

  The first time you mention Kowalah, it will ask you to link your Slack identity to your Kowalah account. Follow the provided link to sign in and complete the connection. This is a one-time step.

  ### Start using it

  Once linked, you're set. Mention `@Kowalah` in any conversation to get help.
</Steps>

## Where it works

The Kowalah Agent works in:

* **Public channels** — anyone in the channel can see the interaction
* **Private channels** — only channel members see it
* **Threads** — replies stay in the thread, keeping channels clean
* **Direct messages** — for private interactions with the Agent

<Tip>
  Use threads for multi-step conversations. The Agent remembers thread context, so follow-up questions don't need to repeat background information.
</Tip>

## What to expect

* **First message in a thread:** The Agent takes around 20 seconds to respond as it loads your workspace context
* **Follow-up messages:** Responses come in 3-5 seconds since the context is already loaded
* **Typing indicator:** You'll see "Kowalah is typing..." while it works on your request

<CardGroup cols={2}>
  <Card title="Using the agent" icon="sparkles" href="/integrations/agent/using-the-agent">
    Learn what you can do
  </Card>

  <Card title="Kowalah Agent overview" icon="bot" href="/platform/kowalah-agent">
    Full capabilities reference
  </Card>
</CardGroup>