> 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/connecting-data-sources/slack.md).

# Slack

Slack is a powerful collaboration platform that enables teams to communicate and work together effectively. Our Business Chatbot seamlessly integrates with Slack using internal Slack apps, allowing for automatic gathering, synchronization, and indexing of the following elements:

<table data-header-hidden><thead><tr><th width="358"></th><th></th></tr></thead><tbody><tr><td>Channels</td><td>This includes Channel ID, Name, Purpose, and relevant timestamps.</td></tr><tr><td>Messages</td><td>We capture Message Content, Sender, Channel, and pertinent timestamps.</td></tr></tbody></table>

By connecting your Slack workspace with our Business Chatbot, you enhance ChatGPT's understanding of your team's communications and enable more contextual responses.

## Setting Up the Slack Internal App Connector

To connect Slack to our Business Chatbot dashboard using internal Slack apps, follow these steps:

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

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

**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/oq2PYRDOVZFCExnHGKGA" alt=""><figcaption></figcaption></figure>

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

> **Note: Replace** `redirect_urls` **with your own Dashboard URL.**

```
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/
  scopes:
    bot:
      - channels:read
      - conversations.connect:read
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false
```

**Step 4.** Click the **Create** button.

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

**Step 6.** Navigate to **Basic Information** tab under the **Settings** header. Note down the `Client ID` and `Client Secret` displayed on the **App Credentials** panel.

**Step 7.** Now, in the Business Chatbot dashboard, go to the Sources section, add new Organizational Source, and find Slack. Enter the `Client ID` and `Client Secret` obtained from your Slack App.

**Step 8.** Click configure and allow the app.

Congratulations! You have successfully added a connection to synchronize your Slack workspace using internal Slack apps. The Business Chatbot will now be able to capture and process data from your Slack channels, messages, users, and attachments.


---

# 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/connecting-data-sources/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.