> For the complete documentation index, see [llms.txt](https://docs.nisa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nisa.ai/deploying-bots/slack.md).

# Slack

Slack is a powerful collaboration platform that enables teams to communicate and work together effectively.

## Setting Up Slackbot

To connect your Slackbot to Nisa using internal Slack apps, follow these steps:

**Note: You must be an admin of the Slack workspace to set up the app.**

**Step 1.** Navigate and sign in to <https://api.slack.com/apps>&#x20;

**Step 2.** Create a new Slack app:

* Click the **Create New App** button in the top right.
* Select **From an app manifest** option.
* Select the relevant workspace from the dropdown and click **Next**.

<figure><img src="/files/q9hvGC2A2gADDELQZhjP" alt=""><figcaption></figcaption></figure>

**Step 3.** Copy the following manifest into the text box.

> **Note:** Replace `redirect_urls` with your own Dashboard URL. You can update the request URL later on.

```
display_information:
  name: Nisa
  description: Indexing Business Knowledge into AI
  background_color: "#2c2d30"
features:
  bot_user:
    display_name: Nisa
    always_online: false
oauth_config:
  redirect_urls:
    - https://dashboard.nisa.ai/oauth/slack
  scopes:
    bot:
      - app_mentions:read
      - channels:history
      - channels:read
      - chat:write
      - conversations.connect:read
      - im:history
      - mpim:history
      - groups:history
settings:
  event_subscriptions:
    request_url: https://chatapi.nisa.ai/v1/slack/LICENSE_KEY
    bot_events:
      - app_mention
      - message.im
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false
```

**Step 4.** Click **Next** and **Create** button.

**Step 5.** Navigate to your Nisa dashboard and select **Deployments**.

**Step 6.** Click create and select **Slack**.

**Step 7.** Fill-up the form and click save. You can get the Bot User OAuth Token under **Features** tab and **OAuth and Permissions** page.

**Step 8.** Copy and save your request URL.

**Step 9.** Back to your Slack app, change your request URL under **Features** tab and **Event Subscriptions** page. Click change then save changes.

**Step 10.** Navigate to the **App Home** tab under the **Features** header. Inside the **Shows Tabs** panel, enable **Messages Tab** and check "*Allow users to send Slash commands and messages from the messages tab"*.

**Step 11.** Navigate to the **OAuth & Permissions** tab under the **Features** header. Under **OAuth Tokens for Your Workspace**, select `Install to Workspace` and Allow the app.

Congratulations! You have successfully connected your slackbot to Nisa. Start sending messages now by mentioning **@Nisa** to your channels.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nisa.ai/deploying-bots/slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.