## Integrate Slack

URL: https://docs.atlan.com/product/integrations/collaboration/slack/how-tos/integrate-slack

> To integrate Slack and Atlan, follow these steps.

:::warning Who can do this?
 You need to be an admin in Atlan to configure the Slack integration. You also need inputs and approval from an administrator of your Slack workspace.

:::

To integrate Slack and Atlan, follow these steps.

## Retrieve tokens

To retrieve Slack's integration tokens:

1. Access your Slack apps console at: [https://api.slack.com/apps](https://api.slack.com/apps)
2. At the bottom of the page, in the _Your App Configuration Tokens_ box click the **Generate Token** button.
3. In the _Generate Your App Configuration Token_ dialog, from the _Workspace_ drop-down choose your Slack workspace and then click the **Generate** button.
4. From the _Your App Configuration Tokens_ box:
 1. Under _Access Token_ click the **Copy** button and save this temporarily.
 2. Under _Refresh Token_ click the **Copy** button and save this temporarily.

:::warning

These tokens usually expire after 12 hours, so you need to use them on the same day they're generated.

:::

<!-- vale Microsoft.Headings = NO -->

## Connect to Slack

<!-- vale Microsoft.Headings = YES -->

To connect Atlan to Slack, from within Atlan:

1. In your Atlan workspace, click **Settings** from the left menu.

 If you are using the **Old UI (Classic)**, from the left menu, click **Admin**.

2. Click **Integrations**.
3. In the _Slack_ tile, click the **Connect** button.
4. Enter the tokens you copied from Slack:
 1. For _Access token_ enter the access token value.
 2. For _Refresh token_ enter the refresh token value.
5. Click **Next** to continue.
6. Under _Install the Atlan app in your Slack workspace_ click the **Install now** button.
7. At the bottom of the resulting Slack popup, click the **Allow** button. (If you want more details on what each permission does, see [What does Atlan do with each Slack permission?](https://docs.atlan.com/llms/governance/integrations/slack-permissions/llms.txt))

### Request permission from your Slack admin

If you aren't a workspace administrator in Slack, Slack prompts you to request permission to install the integration. To request this permission:

1. Under _Add a message for your App Managers_ enter an explanation for installing the app.
2. At the bottom of the form, click the **Submit** button.
3. Contact your Slack workspace administrator and ask them to approve the Atlan app.
4. Once approved, you'll get an alert in Slack from Slackbot.
5. Once you receive the Slackbot alert, return to the _Integrations_ menu in Atlan (in the Admin Center) and click the **Add to Slack** button.

Atlan is now connected to Slack! 🎉

## Configure integration from Atlan to Slack

To configure the Slack integration from Atlan, from the _Integrations_ sub-menu:

1. Expand the _Slack_ tile.
2. Under the _Configurations_ tab, enter channels to use in your Slack workspace. Enter the channel name or provide a link to the channel without a `#`, and press tab or enter after each channel to add multiple channels.
 1. For _Channels_, add any channels that users can post to from within Slack or [get notified on glossary updates](https://docs.atlan.com/llms/governance/integrations/slack-integration/llms.txt).
 2. For _Announcements channel_, enter the name of a single channel that users can use to view [announcements on assets](https://docs.atlan.com/llms/governance/integrations/create-announcements/llms.txt) in Atlan.
 3. For _Workflows alert channel_, enter the name of a single channel that users can use to view [alerts for workflow activities](https://docs.atlan.com/llms/governance/integrations/slack-integration/llms.txt) in Atlan. To receive only failure alerts, toggle on the _Receive failure alerts only_ slider.
 4. For _Playbooks alert channel_, enter the name of a single channel that users can use to view [alerts for playbook runs](https://docs.atlan.com/llms/governance/playbooks/manage-playbooks/llms.txt) in Atlan. To receive only failure alerts, toggle on the _Receive failure alerts only_ slider.
 5. For _Query output share channels_, add any channels where users can share query output.
 6. For _Request notifications_, toggle on the slider to receive Slack notifications when [requests](https://docs.atlan.com/llms/catalog/requests/what-are-requests/llms.txt) are raised in Atlan and [approve or reject them](https://docs.atlan.com/llms/governance/integrations/slack-integration/llms.txt) directly from Slack.
3. At the bottom of the tile, click the **Update** button.

Users can now post to Slack without leaving Atlan! 🎉

:::info **Did you know?** 
 Channels need to be public for Atlan to be able to post to them. If you try to integrate a private channel, Atlan shows an error for that channel when you try to update.

:::

## Configure integration from Slack to Atlan

To configure the Atlan integration from Slack, from within Slack:

1. Open each channel you want Slack users to be able to query Atlan from within.
2. At the top of the channel, click the name of the channel.
3. Change to the **Integrations** tab.
4. In the _Apps_ tile, click the **Add an app** button.
5. Find the _Atlan_ app under the _In your workspace_ heading and click the **Add** button next to it.
6. To add an icon to the Atlan app in Slack, from the _Apps_ page, click the **Atlan** app. On the _Display Information_ page, under _App icon & Preview_, click **\+ Add App Icon** and upload the [Atlan icon](https://assets.atlan.com/assets/atlan-a-logo-bluebg-600x600.png) for the app. 

Users can now search for assets in Atlan without leaving Slack! 🎉

:::info **Did you know?** 
 You can even add the Atlan app to private channels.

:::

### Configure conversational AI in Slack 

If your tenant has [**Conversational AI**](https://docs.atlan.com/llms/governance/conversational-ai/llms.txt) enabled, you can ask natural-language questions about your data and metadata directly from Slack channels by mentioning @Atlan or by sending a direct message to the Atlan app. To configure conversational AI in Slack:

1. Enable conversational AI in Labs. For complete setup steps, see [Set up conversational AI](https://docs.atlan.com/llms/governance/conversational-ai/setup-conversational-ai/llms.txt).

2. In Atlan, go to **Admin → Integrations → Slack** and click **Update** to apply the latest integration configuration.

3. Ask users who use conversational AI in Slack to link their Slack account from **Profile → Integrations → Slack → Connect**. For details, see [Link your Slack account](https://docs.atlan.com/llms/governance/integrations/link-your-slack-account/llms.txt).

4. In any Slack channel where the Atlan app is added, mention **@Atlan** followed by your question, for example:

 ```
 @Atlan show me all verified tables in the finance domain.
 ```

You can continue the conversation in Atlan by clicking **Send chat to Atlan** in Slack. This moves the conversation to the chat experience in Atlan.

---