Skip to main content

​
Overview

Slack workflows allow you to automate routine tasks and interactions within your Slack workspace. You can integrate Dust agents into these workflows. For example:
  • create a Slack workflow sending a message every day at 10a.m. in the #general channel: @dust +highlights What have been the highlights since yesterday?
  • trigger a Dust agent in the #your-channel channel every time a member adds an emoji to a Slack message.

​
Setting up a Slack Workflow with a Dust agent

  1. Create a Slack workflow. This includes defining the workflow trigger, for example a scheduled time (such as daily at 10a.m.) or an action (such as adding an emoji to a message). You can find more details about creating a Slack workflow in Slack’s documentation.
  2. Connect the Dust Slack bot to your workspace. The bot must be connected before a workflow can summon Dust agents. If the bot is not connected, follow the Slack connection setup guide.
  3. Allow the workflow in Dust. Workspace admins on credit-priced plans can manage workflow access themselves:
    1. Open Admin > Automations.
    2. Select the Slack workflows tab.
    3. Select Allow a workflow.
    4. Enter the exact sender name shown in Slack on the workflow’s messages. Spelling and capitalization must match.
    5. Select the Spaces the workflow can reach. The Company Space is always included; add any regular or project Spaces whose agents the workflow should be able to summon.
    6. Select Allow.
    Anyone who can run the workflow in Slack, including guests, can summon agents in the selected Spaces. Give workflows access only to Spaces appropriate for their audience. To remove access, return to Admin > Automations > Slack workflows and select the revoke action for the workflow.
    Plan availabilityThe self-serve Slack workflows tab is available to workspace admins on credit-priced plans. Legacy-plan workspaces continue using the existing support or Poke workflow for access management.
  4. Invoke @dust and the Dust Agent of your choice in the Slack workflow message. Specify which Dust agent to use in a workflow by including the agent’s name following this message format: @dust +agentName. This ensures that the correct Dust agent responds to workflow-triggered messages.

​
Workflow access rules

  • Access is granted per exact Slack workflow name. If you rename the workflow in Slack, allow the new name again.
  • Access is scoped to the Spaces selected by the admin. If the workflow needs to use another Restricted Space or private Pod, update its allowed Spaces before running it.
  • The workflow’s Slack sender must be able to run the workflow in Slack, and the Dust Slack bot must be connected to the workspace.