## What is included in the Slack integration?

URL: https://docs.atlan.com/product/integrations/collaboration/slack/faq/slack-integration

> Learn about the features and capabilities of the Slack integration with Atlan.

With two of your most important workspaces connected, you can save time and improve the way you share data assets with your team.

Once you [integrate Slack with Atlan](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt) you can do all of the following — all without leaving Atlan!

- Share data assets on Slack
- Link important Slack threads to Atlan assets
- Start Slack conversations
- Set up Slack notifications for [announcements](https://docs.atlan.com/llms/governance/integrations/create-announcements/llms.txt), [governance workflows](https://docs.atlan.com/llms/governance/stewardship/manage-governance-workflows/llms.txt), [glossary updates](#enable-alerts-for-glossary-updates-in-atlan), [starred assets](https://docs.atlan.com/llms/catalog/discovery/star-assets/llms.txt), and [playbook runs](https://docs.atlan.com/llms/governance/playbooks/manage-playbooks/llms.txt)

When users share assets on Slack (like assets, glossaries and saved queries) Atlan provides an embedded preview and context for the asset directly in Slack.

:::info

💪 **Did you know?** To use all of the features outlined, each user needs to [connect their individual Slack account](https://docs.atlan.com/llms/governance/integrations/link-your-slack-account/llms.txt) to their Atlan profile.

:::

## Ask questions about assets, without leaving Atlan

To ask questions about assets on Slack, without leaving Atlan:

1. For any asset, in the asset sidebar, click the **Slack** icon.
2. In the _Share on Slack_ dialog:
 1. For _Channel_, choose the Slack channel where you want to post your question.
 2. For _Message_, enter the question you want to ask on the Slack channel. (Optional) Type `@` to select another user from your Atlan workspace and tag them in your message.
 3. (Optional) For _Add as a resource_, toggle the slider on to add the message as a [resource](https://docs.atlan.com/llms/catalog/discovery/add-a-resource/llms.txt) to your asset. When you add the message as a resource, anyone viewing the asset in Atlan can see previous discussions in Slack about that asset.
3. Click **Share** to post on Slack.

Your message is now on Slack and linked to the asset for future reference! 🎉

## Add existing Slack discussions to assets

:::warning

🤓 **Who can do this?** Any [non-guest user with edit access to an asset's metadata](https://docs.atlan.com/llms/governance/access-control/delegate-administration/llms.txt) can add existing Slack discussions to assets.

:::

Ever discussed a data asset in Slack? It's important to bring that context back to your asset.

### From within Slack

To add existing discussions in Slack into Atlan, from Slack:

1. On any discussion in Slack, open the context menu for actions and click **Send to Atlan**.
2. Find the asset you want to link the discussion to:
 1. For _Title_ enter a brief summary of the discussion.
 2. For _Asset Types_ select the type of asset you want to link the discussion to.
 3. For _Asset_ start typing in the asset you want to link the discussion to. Slack runs a search for your asset in Atlan and gives you a list of options — select your asset from the list.
3. At the bottom right of the dialog, click the **Submit** button.

Your existing discussion on Slack is now linked to the asset for future reference. And Atlan has even updated the discussion thread with a link to the asset for everyone's convenience within Slack! 🎉

### From within Atlan

To add existing discussions in Slack into Atlan, from Atlan:

1. From the asset, on the right of the screen, click the **Slack** sidebar icon:
 - If there are existing discussions on the asset, to the right of _Slack Conversations_, click the **Add** link.
 - If there are no existing discussions on the asset, click the **Add Slack Thread** button.
2. In the _Add Slack Thread_ dialog, under the _Link_ heading, paste the link to the Slack discussion.
3. Under the _Title_ heading, write a brief description of the discussion. This is only displayed to users who haven't [linked their Slack account](https://docs.atlan.com/llms/governance/integrations/link-your-slack-account/llms.txt).
4. At the bottom of the dialog, click the **Add** button.

Your existing discussion on Slack is now linked to the asset for future reference! 🎉

## Start direct chats from Atlan user profiles

You can only start a direct chat with Atlan users who have [linked their Slack account](https://docs.atlan.com/llms/governance/integrations/link-your-slack-account/llms.txt) to their Atlan profile. Once linked, the _Say Hi_ Slack icon appears next to the user's name.

To start a direct chat with another Atlan user:

1. Hover over any username.
2. In the resulting dialog, click the **Say Hi** Slack icon next to the user's name.

You're now in a direct chat with that user in Slack! 🎉

## Enable alerts for glossary updates in Atlan

:::warning

**🤓 Who can do this?** You need to be an [admin user](https://docs.atlan.com/llms/governance/access-control/delegate-administration/llms.txt) in Atlan to enable Slack notifications for glossary updates. Once enabled, anyone in the selected Slack channel can view these alerts directly in Slack.

:::

You can set up Slack notifications for updates made to your [glossaries](https://docs.atlan.com/llms/governance/glossary/set-up-glossaries/llms.txt) in Atlan. You can also customize the type of change alerts you want to receive. With real-time alerts sent to a [Slack channel of your choice](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt), you can stay informed about the latest changes to your glossaries.

Slack notifications can only be set up at the glossary level. Even if configured from a specific term or category profile, the notification settings apply to the entire glossary.

To enable Slack notifications for glossary updates, from Atlan:

1. From the left sidebar, click on **all assets** and then view the glossary.
 * If you are using the **Old UI (Classic)**, click on **Business Graph** from the left sidebar.
2. Under _Glossary_ in the left menu, click the name of the glossary for which you want to set up change notifications.
3. From the top right of the glossary profile, click the bell icon to set up notifications for glossary updates.
4. In the notifications setup dialog, click **Slack** and then enter the following details:
 1. For _Notification channel_, click the dropdown to select a Slack channel where you want to receive notifications from the channel(s) configured in your [Slack integration in Atlan](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt). 
 2. For _Notify me about_, you can either:
 1. Click **All updates** to receive notifications for all the changes listed in _Custom updates_ made to your glossary.
 2. Click **Custom updates** to limit notifications to specific types of updates:
 - Click **+ New term or category** to receive an alert when a new term or category is added to the glossary.
 - Click **Name** to receive an alert when the name of the glossary or that of a nested category or term is updated.
 - Click **Description** to receive an alert when a [description](https://docs.atlan.com/llms/catalog/discovery/add-descriptions/llms.txt) is added to, updated, or removed from the glossary or a nested category or term.
 - Click **Announcement** to receive an alert when an [announcement](https://docs.atlan.com/llms/governance/integrations/create-announcements/llms.txt) is added to, updated, or removed from the glossary or a nested category or term.
 - Click **Certificate** to receive an alert when a [certificate](https://docs.atlan.com/llms/catalog/discovery/add-certificates/llms.txt) is added to, updated, or removed from the glossary or a nested category or term.
 - Click **Owners** to receive an alert when an [owner](https://docs.atlan.com/llms/catalog/discovery/add-owners/llms.txt) is assigned to or removed from the glossary or a nested category or term.
 - Click **Readme** to receive an alert when a [README](https://docs.atlan.com/llms/catalog/discovery/faq/llms.txt) is added to, updated, or removed from the glossary or a nested category or term.
 - Click **Tags (for terms)** to receive an alert when a tag is [attached to](https://docs.atlan.com/llms/governance/tags/attach-a-tag/llms.txt) or [removed from](https://docs.atlan.com/llms/governance/tags/remove-a-tag/llms.txt) a term within the glossary.
 - Click **Categories updated (for terms)** to receive an alert when a [term is assigned to a different category](https://docs.atlan.com/llms/governance/glossary/set-up-glossaries/llms.txt) within the same glossary. (Notifications for moving terms across glossaries aren't currently supported.)
 - Click **Remove term** to receive an alert when a term is removed from the glossary. (Notifications for removal of categories aren't currently supported.)
 3. Click **Save** to save your notification preferences.
5. (Optional) To edit notification settings, click the bell icon. In the notifications setup dialog, you can change the channel or further customize your notifications.
6. (Optional) To remove notifications, click the bell icon. In the notifications setup dialog, click the **Enabled (by username)** dropdown. Click **Remove notification** to reset your notification settings.

You'll now receive Slack notifications for changes made to your glossary! 🎉

If the [Slack channel](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt) you selected for sending notifications is removed from your Slack integration in Atlan, glossary alerts continue to be sent to that channel. In that case, you can either remove the notifications or select a different channel.

:::info

💪 **Did you know?** You can also set up Slack notifications for metadata updates on all your [starred assets](https://docs.atlan.com/llms/catalog/discovery/star-assets/llms.txt) in Atlan.

:::

## Query Atlan from within Slack

### Find terms

To search for terms in Atlan from within Slack:

1. Enter `/search-term <search words>`.
2. Review the results (only visible to you).
3. Send any result(s) you want to the channel.

You've now shared terms with others without ever leaving Slack! 🎉

### Find queries

To search for queries in Atlan from within Slack:

1. Enter `/search-query <search words>`.
2. Review the results (only visible to you).
3. Send any result(s) you want to the channel.

You've now shared queries with others without ever leaving Slack! 🎉

### Provide context for any asset link

Other times you may have a link for an asset already. You can do more than just share the link — Atlan's bot expands the context of that link directly in Slack.

To provide detail for an asset in Slack:

1. Paste an asset link into Slack, along with any other context in your message.
2. The Atlan bot expands the link with a card of contextual metadata.

The channel can now understand the basics about the asset without ever leaving Slack! 🎉

:::info

💪 **Did you know?** Once your organization's Slack account is integrated with Atlan, your users can receive [Slack notifications on their requests](https://docs.atlan.com/llms/catalog/requests/manage-requests/llms.txt).

:::

## View workflow alerts in Slack

You can [configure the Slack integration](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt) to receive alerts for workflow activities from Atlan. This can help you [monitor your workflows](https://docs.atlan.com/llms/catalog/connector-capabilities/monitor-connectivity/llms.txt) directly in Slack. You can also choose to receive failure alerts only.

To view workflow alerts in Slack:

1. Open the Slack channel you [configured](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt) to view workflow notifications.
2. The Atlan bot shares workflow alerts—including details like run status, start time, run time, trigger type, and last three runs.
3. (Optional) Click **View on Atlan** to open the workflow link in Atlan.

You can now inspect crawled assets or troubleshoot in case of any failed workflows.

:::info

💪 **Did you know?** Atlan also supports workflow alerts for all [custom packages](https://docs.atlan.com/llms/platform/packages/llms.txt). If you've set up any custom packages on your Atlan instance, you can monitor your workflows directly in Slack.

:::

## Take action on requests in Slack

You can [configure the Slack integration](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt) to receive notifications for metadata update [requests](https://docs.atlan.com/llms/catalog/requests/manage-requests/llms.txt) raised in Atlan, and approve or reject them directly from Slack.

To take action on requests in Slack:

1. From the left _Apps_ menu in Slack, click the Atlan app.
2. If [request notifications are enabled](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt), the app displays requests raised in Atlan—including asset name and basic information, and the type of metadata update requested. To take action on a request:
 - Click **Reject** to reject the update.
 - Click **Accept** to accept the update.

The status of the request is updated in Slack to inform your team that no further action is required.

---