> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Workspace

The Slack Workspace connection installs the Duvo app into your Slack workspace, enabling notifications, human-in-the-loop interactions, and the ability to trigger agents directly from Slack. Unlike the personal [Slack connection](/user-guide/connections/available-connections/slack), which gives agents broader Slack actions and can optionally act as you for some steps, the Slack Workspace connection operates as the **Duvo app** for team-level notifications and Slack-triggered runs.

## Setup

<Note>
  This is a **team-level** connection. A team admin installs the Duvo app once per Slack workspace from the Connections page, and each team member links their own Slack account from **Settings > Notifications** so Duvo can reach them individually.
</Note>

<Steps>
  <Step title="Install the Duvo app (team admin)" icon="plug">
    1. Go to the [Connections page](https://app.duvo.ai/integrations).
    2. Find **Slack Workspace** and click **Enable**.
    3. Authorize the Duvo app to access your Slack workspace.
  </Step>

  <Step title="Link your Slack account (each user)" icon="user">
    1. Go to **Settings**.
    2. Open **Notifications**.
    3. Link your Slack user account.

    This tells Duvo which Slack user to message when your agents need attention.
  </Step>
</Steps>

## How It Differs from the Slack Connection

|                 | **Slack Connection**                                | **Slack Workspace Connection**                                                            |
| --------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| **Set up from** | Connections page (per user)                         | Connections page (per team)                                                               |
| **Identity**    | Duvo bot by default; some actions can act as you    | Messages appear as the Duvo app                                                           |
| **Purpose**     | Send messages, manage channels, upload files as you | Notifications, human-in-the-loop requests, trigger agents from Slack                      |
| **Scope**       | Per user                                            | Per team (one installation per Slack workspace), plus each user links their Slack account |

## Capabilities

* **Human-in-the-loop notifications** — When an agent needs your approval or input, the Duvo app sends you a direct message. You can approve, deny, or answer questions directly in Slack, or click through to handle the request in Duvo. Multiple requests during a single run are grouped into one DM thread.
* **Trigger agents from Slack** — Tag the Duvo app in any channel to start a run. The agent runs and posts results back to the same thread. Useful for on-demand reports, quick actions, and team-accessible automation without leaving Slack.
* **File and image support** — When an agent is triggered from a Slack thread, any files or images attached to messages in that thread are automatically downloaded and made available to the agent for processing.
* **Bot and third-party app message reading** — Agents capture the full content of all messages in a thread, including structured messages from bots and third-party Slack apps like Jira, GitHub, and PagerDuty. Titles, field values, and descriptions are extracted automatically.
* **Live status updates** — While a Run is in progress, Duvo posts live progress messages in the Slack thread showing what the agent is currently doing. Updates clear when a human-in-the-loop request pauses the Run and resume when work continues.
* **Formatted output delivery** — Agent output is posted back to the Slack thread with Markdown converted to Slack's native format. Long messages are split at paragraph boundaries, and tables are converted to a key-value format for readability.

## Key Benefits

* **Respond without leaving Slack** — Handle approvals, answer questions, and review agent output directly in your team's communication hub.
* **Team-wide access** — One installation covers the entire team. Any linked team member can trigger agents and receive notifications.
* **Real-time visibility** — Live status updates keep everyone in the thread informed about run progress without switching to Duvo.
* **Context-rich triggers** — Agents triggered from Slack threads automatically receive files, images, and bot messages as context, so requests can include supporting documents.
* **Clear bot identity** — Messages from agents are clearly labeled as the Duvo app, keeping automated communication distinct from personal messages.

## Works Well With

<CardGroup cols={3}>
  <Card title="Slack" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/slack.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=8a64bdd1af39e903923e4a273b4a4618" href="/user-guide/connections/available-connections/slack" width="512" height="512" data-path="images/connections/slack.svg">
    Use both connections together: the Slack connection for agents that need broader Slack actions or optional act-as-you behavior, and the Slack Workspace connection for bot notifications and Slack-triggered runs.
  </Card>

  <Card title="Gmail" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/gmail.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=ad4e229283f3fe2f26c0f96a49f28e13" href="/user-guide/connections/available-connections/gmail" width="88" height="66" data-path="images/connections/gmail.svg">
    Trigger an agent from Slack to process an email thread, then have results posted back to the Slack channel for team discussion.
  </Card>

  <Card title="Google Sheets" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/google-sheets.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=0ef8d55e05c34e7a4a618933bdf0ceb3" href="/user-guide/connections/available-connections/google-sheets" width="24" height="24" data-path="images/connections/google-sheets.svg">
    Ask the Duvo app in Slack to generate a report, and have the agent write results to a spreadsheet while posting a summary back to the thread.
  </Card>
</CardGroup>

## Notification Preferences

You can enable or disable Slack notifications in **Settings > Notifications**. When enabled, the Duvo app sends you:

* Human-in-the-loop requests (approvals, questions, input needed)
* Error alerts when a run fails

## Troubleshooting

<AccordionGroup>
  <Accordion title="Notifications not appearing" icon="bell-off">
    * Verify the Slack workspace is connected on the [Connections page](https://app.duvo.ai/integrations)
    * Confirm your Slack user account is linked to your Duvo profile
    * Check that Slack notifications are enabled in Settings > Notifications
    * Make sure the Duvo app is not muted in Slack
  </Accordion>

  <Accordion title="Cannot connect workspace" icon="triangle-alert">
    * Confirm you have admin permissions in your Slack workspace
    * Allow browser popups for the authorization flow
    * Check for network restrictions blocking OAuth
  </Accordion>

  <Accordion title="Triggers not working" icon="zap-off">
    * Verify the agent has Slack triggers enabled
    * Confirm you are tagging the Duvo app correctly
    * Ensure the agent is active and has a published build
  </Accordion>
</AccordionGroup>