---
title: "Slack Cloud Connection | AgentRQ Docs"
url: https://agentrq.com/docs/integrations/slack
description: "Step-by-step guide to connect and link your Slack workspace to AgentRQ Cloud."
---

[Docs](https://agentrq.com/docs/) / Integrations / Integrations

Integrations

# Slack Cloud Connection

Step-by-step guide to connect and link your Slack workspace to AgentRQ Cloud.

AgentRQ's Slack integration allows seamless, real-time collaboration between you and your AI agents directly from your Slack workspace. It enables:

- → **Slash Commands:** Use `/t` to create tasks instantly from any Slack channel.
- → **Bidirectional Sync:** Real-time message and private file attachment synchronization inside Slack threads.
- → **MCP Permission Control:** Approve or reject sensitive agent terminal commands (like writing a file) using interactive Block Kit buttons (Allow/Deny) inside Slack threads.
- → **Secure Isolation:** Each AgentRQ workspace maps directly to a single, isolated private Slack channel, ensuring strict task and file isolation between projects. All OAuth tokens are persisted and AES-256 encrypted.

**Running Self-Hosted?** This page describes linking workspaces to AgentRQ Cloud. If you are running your own self-hosted AgentRQ instance, first follow the [Self-Hosted Slack Setup Guide](https://agentrq.com/docs/integrations/slack-self-hosted) to configure your custom Slack App credentials.

## ☁️ Connecting Slack

If you are using the managed cloud version at [app.agentrq.com](https://app.agentrq.com), the Slack app is fully pre-configured and hosted for you. You only need to link your workspace:

1. 1.
   Open the AgentRQ web dashboard and log in.
2. 2.
   Select your workspace in the top left, then navigate to the **Settings** tab.
3. 3.
   Click the **Slack** sub-tab in the settings sidebar.
4. 4.
   Click the green **Link Slack Channel** button. This will initiate the secure OAuth2 v2 flow.
5. 5.
   Review the requested permissions in Slack and authorize the app.
6. 6.
   Upon redirect, associate your workspace with a private Slack channel. **Each AgentRQ workspace maps to exactly one private channel** to guarantee strict data separation between your projects:

- → **Automatic Provisioning (Recommended):** If left blank, the app automatically creates a secure private channel named `agentrq-[workspace-name]` and invites the installer.
- → **Manual Provisioning:** Enter your preferred Slack Channel ID and Name in the input fields manually.

## 🚀 Usage Guide

Once Slack is successfully connected and linked to your workspace, you can manage your AI operations entirely from Slack:

- → **Create a Task:** In your connected Slack channel, type `/t "Create a user login screen" "Include email and Google login buttons"`. A task will immediately be created and queued for your active workspace agent.
- → **Add Thread Replies:** Use `@bot-name message` (or `@AgentRQ message`) inside any task thread in Slack. Your reply, including any uploaded private file attachments, will instantly stream to the AgentRQ dashboard in real-time.
- → **Approve Agent Operations:** When an agent requests a manual or sensitive execution (e.g. running a script, editing code, or fetching sensitive URLs), Allowance buttons (Allow/Deny) will automatically appear in the task's Slack thread. Click them to grant authorization instantly!

Keep the Slack bot invited to the channel. If you manually provisioned a private channel, make sure you run `/invite @AgentRQ` to allow the bot to receive events and threads.