🔌 Slack Connection

How to set-up your Slack connection on Dust

🚧

Warning

Please be aware that Slack Admin permissions are required to establish this connection. Ensure you have the necessary rights or coordinate with your Slack Admin to proceed.

Overview

Dust's integration with Slack allows you to synchronize data from selected public Slack channels. Dust assistants can retrieve and utilize conversations and information shared within these channels to provide more relevant and contextual responses.

Setting up the Connection

Initial Connection Setup

  1. Initial Connection by a Slack Admin: A Slack Admin must initiate the connection process. This is done through the Dust platform under Build > Connections. Select Slack from the list and click Connect.
  2. Authorize Dust in Slack: You'll be redirected to Slack for authorization. Here, you must allow Dust to access your workspace information. This step ensures that Dust can read messages from your public channels.
Slack Authorization popup.

Slack Authorization popup.

Dust modal, to select the data you want to sync with your Dust workspace.

Dust modal, to select the data you want to sync with your Dust workspace.

  1. Select Channels for Synchronization: After authorization, you'll return to Dust. A modal will appear, allowing you to select which public channels you want Dust to synchronize data from. Later on, you can change the channels selection using the Add / Remove data button.
  2. Enable Dust Slack bot: From the Slack Connection, toggle right the Slack bot to enable it for your workspace. To avoid information leaks, only members of the Dust workspace can ask questions to assistants in Slack.
  3. @Dust Slack bot Addition: The @Dust Slack bot will automatically be invited in the channels you've selected for synchronization.
    You can invite the Slack bot to private channels to ask questions, but the data from the private channels won’t be synchronized.
Click on Add/Remove data to select or unselect public Slack channels, toggle right to enable the Slack bot

Click on Add/Remove data to select or unselect public Slack channels, toggle right to enable the Slack bot

Select or unselect the Slack channels you want to synchronize with Dust

Select or unselect the Slack channels you want to synchronize with Dust

🚧

Warning

Remember, the @Dust Slack bot presence in a channel does not necessarily mean all messages from that channel are being synchronized. Only the channels an admin selects in the Add / Remove data section will have their data ingested by Dust.

Managing Permissions

  • Adopt a shared-by-default approach—share everything except for the data you want to exclude from Dust.
  • Admins can update permissions directly from the Slack connection in Dust by clicking on Manage Permissions

Updating the connection

  • Admins can synchronize or unselect any Slack public channel by clicking on  Add / Remove data from the Dust Slack connection panel.

Link an assistant to a specific channel.

To ensure your assistant answers by default whenever a user summons @dust, set up your assistant as Shared or Company, then toggle right the Slack integration setting and select the channel you want to link to your assistant.

Untitled

Summon any assistant from synchronized channels.

Untitled

If you don’t want to link one specific assistant to one channel, you can use the ~ or the + sign to talk to any shared or company assistant directly from Slack.

@dust ~assistantname
or
@dust +assistantname










Refresh Rate

A few seconds: Changes to channel selections in the Add / Remove data modal are reflected within a few seconds or minutes, depending on the size of the data. The actual sync of new messages from Slack channels is almost instantaneous, meaning Dust will have access to new messages as soon as they are posted.

Slack Connection Specificities

Data Synchronization

  • Dust synchronizes text messages and information from selected public channels.
  • Private channels, direct messages, and external files are not accessible by Dust.
  • Messages from other bots (eg: Slack workflows) are not synchronized with Dust.
  • When messages are not threaded, Dust points to the window of the channel message that represents the chunk whose URL is the first message. To optimize Dust synchronization and retrieval of Slack messages, we recommend formatting Slack threads as is: first message with the title and then create a thread.