Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
42 changes: 38 additions & 4 deletions references/integrations/slack-integration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,21 +20,55 @@ No other content will be shared from your workspace.
After installing the app you'll see these settings:

<Frame>
![](/images/references/integrations/slack-integration/slack-settings-c8979ed5520aa02ba740718ab4736e2c.png)
![](/images/references/integrations/slack-integration/slack-settings.png)
</Frame>

### Select a notification channel
Here you may choose a Slack channel where Lightdash will send alerts when any scheduled deliviries fail in your organization.
Here you may choose a Slack channel where Lightdash will send alerts when any scheduled deliveries fail in your organization.

You must add the Lightdash app into that organization for notifications to work properly.

### Slack bot avatar

You can customize the avatar for your Lightdash slack app by adding an image URL in the Profile photo URL field. Slack recommends these images be square with a minimum of 512x512 pixels, but no larger than 1024x1024 pixels.

### AI Bot channel mappings
### AI Agents configuration

Configure how AI Agents interact with your Slack workspace. You can control whether AI Agents can access thread messages when mentioned, require OAuth authentication for AI Agent usage, and set up a multi-agent channel where users can choose which AI agent to chat with when starting a thread.

## Using Lightdash in private channels

Lightdash supports private Slack channels, but because Slack doesn't allow apps to see private channels by default, you'll need to manually add the Lightdash app to your private channel first.

To add Lightdash to a private channel, you can either:

- **Use the invite command** - Type `/invite @Lightdash` in the channel

<Frame>
![](/images/references/integrations/slack-integration/slack-invite-command.png)
</Frame>

- **Use channel settings** - Click on the channel name, go to **Integrations** > **Add an app**, then search for and add Lightdash

<Frame>
![](/images/references/integrations/slack-integration/slack-add-app-settings.png)
</Frame>

Once the app is added, you can find the channel in Lightdash by either:

- **Refreshing the channel list** in the Lightdash UI
- **Looking up the channel by ID** - You can find your channel ID in Slack by right-clicking on the channel name, selecting "View channel details", then copying the Channel ID from the bottom of the modal.

<Frame>
![](/images/references/integrations/slack-integration/slack-channel-id.png)
</Frame>

In Lightdash, paste the channel ID into the Channels input field and select the "Look up channel ID" option to find your private channel.

<Frame>
![](/images/references/integrations/slack-integration/slack-lookup-id.png)
</Frame>

Here you can choose which project is used by the Lightdash AI analyst co-pilot for each of your Slack channels. Only one project can be used for each channel.

## Unfurl Lightdash links

Expand Down