# Connect Slack

Goal: connect Slack so employees can submit requests in chat and admins can work from threads and the Siit inbox.

### Prerequisites

* Slack workspace admin privileges, or approval from an org admin if your directory requires it
* Siit admin access
* If your Slack is Enterprise Grid: know which workspaces need the app enabled

### Step-by-step

1. **Start the install**

* In Siit: [Settings → Integrations](https://app.siit.io/settings/integrations/apps) → Slack → Connect
* You’ll be redirected to Slack’s permission screen<br>

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

2. **Approve permissions**

* Review and click *Allow*. Scopes shown by Slack may include:
  * commands (slash and global shortcuts)
  * chat:write (post updates to threads)
  * users:read, users.profile:read (map Slack users to Siit People)
  * channels:read, groups:read (list public/private channels you add the bot to)
  * im:write (bot DMs)

Note: exact scopes depend on features you enable; Slack displays the current list before install.

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

3. **Enable request creation**&#x20;

* Siit App : App Home: Open the Siit app in Slack → “New request”
* Message action: From any message, “More actions …” → “Create a Siit request”
* Optional channel:

  * Create or choose a channel (e.g., #ask-it)
  * Invite the bot: /invite @Siit
  * Pin a message with “Start a request via the Siit shortcut” so employees know how to submit

4. **Test your first request**

* Use the siit App → pick the service “App Access” → Submit
* You’ll see a thread in Slack; the request appears in the Siit inbox
* Reply in thread.

### **Post-install recommended setup**

* Rename the App
* Create a #siit-test channel for internal dry runs
* Share a short announcement with the shortcut link and when to use Siit vs ad-hoc DMs<br>

{% hint style="info" %}
Enterprise Grid notes

* Install to each workspace that should submit requests
* If your org restricts apps, ask a Slack Org Admin to approve Siit in the App Directory, then repeat the install per workspace
  {% endhint %}


---

# 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.siit.io/getting-started/connect-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.