> For the complete documentation index, see [llms.txt](https://docs.csml.dev/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.csml.dev/studio/channels/slack/installation.md).

# Installation

Step by step guide to install a Slack channel

The Slack integration provides you with a **Manifest** that allows you to setup most of the heavy Slack App configuration in seconds. To get started, simply click on the link provided here:

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6OZMoZlXP9VSWYMW_T%2Fuploads%2FHWvRXO76Dmcfi5Du5zBS%2Fimage.png?alt=media\&token=f8330682-9faa-47cf-be90-8529a220229d)

Simply follow the on-screen instructions until the app is installed to your workspace. You will be required to allow the app to perform the necessary actions - you must be a workspace admin to do that.

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6OZMoZlXP9VSWYMW_T%2Fuploads%2FV3LU2G30CUN2Hedqx6Ge%2Fimage.png?alt=media\&token=425fa0bb-af48-42d8-9500-e0a85285a758)

You will still need to perform a few actions to correctly setup your app. First, visit the **App Manifest** menu. It may have an orange warning box at the top: in that case, click the "**Click here to verify**" link to make that warning disappear. Another way to perform this verification if needed is by visiting **Event Subscriptions** and performing the same operation.

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6OZMoZlXP9VSWYMW_T%2Fuploads%2F5iArZlVZzZazci5ObweE%2Fimage.png?alt=media\&token=6236033b-093a-4e1b-9057-66c00127061f)

Next, visit the **OAuth & Permissions** menu, copy the **Bot User Token** and save it for later.

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6OZMoZlXP9VSWYMW_T%2Fsync%2Fc399ba718632fee3413a3d3c5e7151466c019b41.png?generation=1590013349541065\&alt=media)

Next, select **App Home** in the left-side menu. Enter a Display Name and a Default Name for your bot and select **Always Show My Bot as Online**.

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6OZMoZlXP9VSWYMW_T%2Fsync%2F8ef708f851a25e46aa9130921f14c11399d145b6.png?generation=1590013350977155\&alt=media)

At the bottom of the same **App Home** page, under **Show Tabs**, make sure the **Messages Tab** toggle is *on* and the **Allow users to send Slash commands and messages from the messages tab** checkbox is *checked*.

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6OZMoZlXP9VSWYMW_T%2Fuploads%2FSePSSxulkoH6gO0FVrz7%2Fimage.png?alt=media\&token=2586a79a-7b61-458d-9ba2-be587cefb77c)

Next, visit **Basic Information** from the left-side menu, copy the **App ID**, **Client ID**, **Client Secret** and **Signing Secret** under **App Credentials** and save them for later.

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6OZMoZlXP9VSWYMW_T%2Fsync%2Fc16033106a12eb92a7a4675fa1688140565b5855.png?generation=1590013361465896\&alt=media)

On the same page, you can also customize the appearance of your chatbot in Slack (image, colors...).

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6OZMoZlXP9VSWYMW_T%2Fsync%2Fd248ee6e85423ebe7f7821cb29601422fc543d04.png?generation=1590013351406143\&alt=media)

Finally, back in CSML Studio, paste the credentials you retrieved earlier: **Bot User Token**, **App ID**, **Client ID**, **Client Secret**, **Signing Secret**, then click on **Submit**.

You should now be able to see your app in the left sidebar of your Slack workspace, under **Apps**. This is where you can chat with your slack bot!

![](https://2862118938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6OZMoZlXP9VSWYMW_T%2Fuploads%2FWlaPAsZ8Zi2axjGmb6oo%2Fimage.png?alt=media\&token=0e75c21a-5750-4594-8ece-7783f5b2d52f)