# Slack

## Setup Guide

To setup an integration with Slack, you need to create an app in the [Slack Apps Portal](https://api.slack.com/apps).

You'll need the following information to set up your Slack App with KollaConnect:

* Client ID
* Client Secret
* Shareable URL

### Prerequisites

* Slack account - [Create a free account here](https://slack.com/intl/en-in/get-started)

### Create a Slack App

1. In the Slack Apps dashboard, click `Create New App` and select `From Scratch`
2. Name your app, usually this is the name of your company as it will be used when requesting permission to access a users Slack account.
3. Choose the permissions you will need for your integration in `OAuth & Permissions` > `Scopes`

{% hint style="info" %}
You can change these later, but it will require any connected users to re-connect and approve the new permission
{% endhint %}

### Configure Slack App

1. Add the KollaConnect redirect URL to your Slack App in `OAuth & Permissions` > `Redirect URLs:`\
   `https://connect.getkolla.com/oauth`<br>

   <figure><img src="/files/wZZ8DjzmFg4QtorAFgwQ" alt=""><figcaption><p>Adding the KollaConnect Redirect URL</p></figcaption></figure>

2. Set your app to be distributed publicly by going to `Manage Distribution` and clicking the button `Activate Public Distribution`

3. For better security go to OAuth & Permissions and in the section titled `Advanced token security via token rotation` and click the `Opt in` button.

### Add your Slack app to Kolla

Get the following information from your Slack App

* Client ID (in Basic Info)
* Client Secret (in Basic Info)
* Shareable URL (in Manage Distribution)

Login to your Kolla admin portal and go to Connectors. Click on "Add New Connectore" and select Slack from the list of available connectors.

Input all the data from the previous steps and click "Create"


---

# Agent Instructions: 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.getkolla.com/kolla/connector-guides/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.