Slack Workspace

Introduction

The Slack Workspace connection installs the Duvo app into your Slack workspace. Unlike the Slack connection, which sends messages as you, the Slack Workspace connection operates as the Duvo bot—all messages and notifications it sends appear under the Duvo app identity.

This is a team-level connection configured through Team Settings (not the Connections page). A team admin installs the Duvo app into the Slack workspace, and each team member must also link their own Slack user account so Duvo can reach them.

---

How It Differs from the Slack Connection

	Slack Connection	Slack Workspace Connection
Set up from	Connections page (per user)	Team Settings > External Apps / Notifications
Identity	Messages appear as you	Messages appear as the Duvo bot
Purpose	Assignment sends messages, manages channels, uploads files on your behalf	Notifications, human-in-the-loop requests, invoking assignments from Slack
Scope	Per user	Per team (one installation per Slack workspace), plus each user links their Slack account

---

Setting Up

Step 1: Install the Duvo App (Team Admin)

1. Go to Team Settings in the left sidebar

2. Navigate to the External Apps or Notifications tab

3. Click to connect your Slack workspace

4. Authorize the Duvo app to access your Slack workspace

This only needs to be done once per Slack workspace.

Step 2: Link Your Slack Account (Each User)

Each team member who wants to receive Slack notifications or invoke assignments from Slack must also link their own Slack account:

1. Go to Team Settings

2. Navigate to the External Apps or Notifications tab

3. Link your Slack user account

This tells Duvo which Slack user to DM when your assignments need attention. Without this step, Duvo won't know how to reach you in Slack.

---

Features

Human-in-the-Loop Notifications

When an assignment needs your approval or input, the Duvo bot sends you a direct message in Slack. This is enabled by default.

The notification is sent specifically to you—the user who started the job—not to an arbitrary team member or channel.

From the DM, you can:

• Approve or deny the request

• Answer questions directly in Slack

• Open in Duvo using the link in the message to handle the request in the Activity Inbox instead

If an assignment sends multiple requests during a single job, they are grouped into a single DM thread.

Invoking Assignments from Slack

If Slack triggers are enabled for an assignment, users can start jobs directly from Slack by tagging the Duvo bot. The assignment runs, and results are posted back into the Slack thread.

Use cases:

• On-demand reports triggered by team members

• Quick actions without leaving Slack

• Team-accessible automation

Assignment Output to Slack

When an assignment is triggered from Slack, its output is posted back to the same thread as the Duvo bot:

• Standard markdown (bold, italic, lists, code blocks) is converted to Slack's message format

• Tables are converted to a key-value row format (e.g., Header: value), since Slack does not render markdown tables natively

• Long messages are split at paragraph boundaries to stay within Slack's message size limits

• Special characters (&, <, >) are escaped automatically

Write your assignment's SOP using standard markdown. The formatting conversion happens automatically before delivery.

---

Configuration

Notification Preferences

Control what gets sent to Slack:

• Human-in-the-loop requests (enabled by default)

• Error alerts

---

Use Cases

Approval Workflow

Scenario: Expense reports need manager approval

1. Assignment processes an expense report

2. Reaches an approval step and pauses

3. Duvo bot sends you a DM asking for approval

4. You approve or deny directly in Slack (or click the link to review in Duvo)

5. Assignment continues with the approval

On-Demand Reports from Slack

Scenario: Sales team needs quick status updates

1. Assignment is configured with Slack triggers enabled

2. A team member tags the Duvo bot in a Slack channel with their request

3. Assignment runs and generates the report

4. Results are posted back to the same Slack thread

Alert Distribution

Scenario: Critical events need immediate attention

1. Assignment monitors for specific conditions

2. When triggered, it completes its analysis

3. Sends a formatted alert to the Slack thread

4. Team sees the alert and can take action

---

Troubleshooting

Notifications Not Appearing

Check that:

• The Slack workspace is connected in Team Settings

• Your Slack user account is linked to your Duvo profile

• Slack notifications are enabled in your profile settings

• The Duvo app isn't muted in Slack

Can't Connect Workspace

Verify:

• You have admin permissions in your Slack workspace

• Browser allows popups for authorization

• No network restrictions blocking OAuth

Triggers Not Working

Ensure:

• The assignment has Slack triggers enabled

• You are tagging the Duvo bot correctly

• The assignment is active and has a published build

---

Things to Know

• The Slack Workspace connection is separate from the Slack connection—you may need both depending on your use case

• The Workspace connection is team-level (one connection per Duvo team, per Slack workspace)

• Admin permissions in Slack may be required to install the Duvo app

• Notifications respect Slack's rate limits

• Multiple assignments can use the same workspace connection