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

# 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 %}