> ## 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.

# Duvo for Slack

> Duvo agents run real business work end to end. The Duvo app brings them into Slack — mention an agent to start a Run, read its evidence in the thread, and approve the actions your process gates on a human.

Duvo agents do the work, not just the reporting. They pull data from your
systems, apply your rules, decide what needs to happen, ask a human when the
call is theirs to make, and then carry the action out — raise the purchase
order, send the email, update the record.

The Duvo app puts that loop where your team already is. Mention the app in a
Slack channel and an agent starts a Run. It gathers what it needs, posts its
evidence and its recommendation back into the thread. Where your process gates
an action on a human, it waits for your approval before it acts.

<Note>
  The Duvo app is a companion to the Duvo platform. You need a Duvo account to
  use it — [start here](https://app.duvo.ai).
</Note>

## How it works in Slack

<Steps>
  <Step title="Someone asks in a channel" icon="at-sign">
    A team member mentions the Duvo app with a question or a request. That
    mention starts a Run on the agent configured for that channel.
  </Step>

  <Step title="The agent gathers evidence and recommends" icon="chart-column">
    It reads the systems it is connected to, runs the checks its process
    defines, and posts what it found — figures, charts, the checks it ran, and a
    clear recommendation — into the same thread.
  </Step>

  <Step title="A human decides, where you asked for one" icon="circle-check">
    You choose which steps need a person — typically the ones that commit money
    or leave the company. A gated step pauses and asks in the thread; approve or
    deny, and the agent either carries on or stops.
  </Step>

  <Step title="The agent completes the work" icon="play">
    It performs the action in the target system and reports back in the thread.
    Live status updates keep the channel informed while it works.
  </Step>
</Steps>

<Frame caption="Mentioning the Duvo app starts a Run. The agent posts its evidence and recommendation in the thread, then asks for approval before placing the order.">
  <img src="https://mintcdn.com/duvo-d8027998/QOekqREm8cH1X1vC/images/user-guide/slack/mention-and-evidence.png?fit=max&auto=format&n=QOekqREm8cH1X1vC&q=85&s=f4db7e4b15ad6c7d6835fadaeb846244" alt="A Slack thread where a Category Manager mentions the Duvo app to ask whether to place a replenishment order. The agent replies with a chart of stock cover and input prices, a recommendation, a list of validation checks, and an approval request with Approve and Deny buttons." width="1254" height="1766" data-path="images/user-guide/slack/mention-and-evidence.png" />
</Frame>

<Frame caption="Approving in the thread resolves the request and the Run continues.">
  <img src="https://mintcdn.com/duvo-d8027998/QOekqREm8cH1X1vC/images/user-guide/slack/approval-resolved.png?fit=max&auto=format&n=QOekqREm8cH1X1vC&q=85&s=bde1a5907285536cc9fcc681dcf3d5c3" alt="The same Slack thread after approval. The request is marked resolved and approved, and Duvo posts a live status update showing it is still working." width="1232" height="297" data-path="images/user-guide/slack/approval-resolved.png" />
</Frame>

<Note>
  Figures in these examples are illustrative.
</Note>

## What the app does in your workspace

* **Starts Runs from a mention** — Tag the app in a channel it has been invited to and the agent for that channel begins work, replying in the same thread.
* **Asks for decisions where you are** — Approvals, questions, and input requests arrive as a direct message from the app. Answer in Slack; the Run resumes.
* **Posts results and updates** — Reports, alerts, and Run output go to the channels you choose, with live progress while a Run is in flight.
* **Reads the thread as context** — Attached files and images, and messages posted by other apps such as Jira or GitHub, are picked up automatically so a request carries its supporting material.
* **Acts in Slack when a process needs it** — Sending and scheduling messages, reactions, channel management, file upload and download, and user or channel lookups.

## Install it

The app is installed once per Slack workspace from inside Duvo.

<Steps>
  <Step title="Open Connections in Duvo" icon="plug">
    Go to the [Connections page](https://app.duvo.ai/integrations), find
    **Slack**, and click **Enable**. This needs the Manager role or above in
    Duvo, and permission to add apps in your Slack workspace.
  </Step>

  <Step title="Authorize the app in Slack" icon="shield-check">
    Slack shows you exactly what the app is asking for. Approve it, and the app
    is installed for the whole workspace.
  </Step>

  <Step title="Link your own Slack account" icon="user">
    Back on the [Connections page](https://app.duvo.ai/integrations), open
    **Slack**, find your workspace, and click **Enable** next to your account.
    Every team member does this once — it tells Duvo which Slack user to
    message.
  </Step>
</Steps>

## After you install

<CardGroup cols={2}>
  <Card title="Invite the app to a channel" icon="hash">
    Run `/invite @Duvo` in the channel you want to work from. The app only sees
    the channels it has been added to.
  </Card>

  <Card title="Choose which channels start a Run" icon="zap" href="/user-guide/assignment-features/slack-channel-triggers">
    Enable Slack triggers per agent so a mention in the right channel starts the
    right work.
  </Card>

  <Card title="Decide when a human is asked" icon="hand" href="/user-guide/assignment-features/human-in-the-loop">
    Gate the actions that need a decision, so approvals land in Slack before
    anything commits.
  </Card>

  <Card title="Turn on Slack notifications" icon="bell">
    In Duvo, open **Settings > Requests** to get approvals, questions, and
    failure alerts as direct messages.
  </Card>

  <Card title="Full setup and troubleshooting" 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">
    The complete Slack Connection reference — capabilities, message formatting,
    and what to check when something does not work.
  </Card>

  <Card title="Worked examples" icon="book-open" href="/user-guide/examples/slack-mention-workflows">
    Step-by-step Slack workflows: on-demand reports, request intake and routing,
    threshold alerts, and weekly summaries.
  </Card>
</CardGroup>

## Permissions, data, and privacy

Installing authorizes two separate identities, and they reach different things:

* **The Duvo app** reaches only the channels and conversations it has been added to. It posts with an **APP** badge, so automated messages stay distinguishable from people.
* **Your linked Slack account** reaches whatever that account can already see. Duvo uses it to identify you and, where a process explicitly asks for it, to act as you — see [Slack bot identity](/user-guide/connections/slack-bot-identity).

An agent never gets access beyond those boundaries. Tokens are encrypted at
rest, and you can revoke either identity at any time from the
[Connections page](https://app.duvo.ai/integrations) or by removing the app in
Slack.

For how Duvo handles connected data, see
[Security and privacy](/user-guide/resources/security-and-privacy), the
[Privacy Policy](https://www.duvo.ai/privacy-policy), and the
[Terms of Use](https://www.duvo.ai/terms-of-use).

## Support

Email [support@duvo.ai](mailto:support@duvo.ai) with your Slack workspace name
and what you were trying to do.
