# Slack

#### 🔌 Slack Integration – Step-by-Step Guide

Slack is one of the most powerful sources of company knowledge. With Calk, you can connect it to pull messages, links, files, and conversations that matter to your agents.

***

**✅ What You Can Pull from Slack**

Once connected, Calk can access:

* Messages in **public channels**
* **Pinned** messages and content
* **Shared links**, files, and documents
* Basic info about **users and user groups**
* **Bookmarks** and **call history**

This allows your agents to answer internal questions using your real conversations.

***

**🔄 How to Connect Slack to Calk (Step-by-Step)**

1. **Go to your Calk dashboard**\
   → Click on **Knowledge** in the left sidebar\
   → Then click **“Connect Integrations”**
2. **Select Slack**\
   → Click on the **Slack** card\
   → Hit “Connect”

<figure><img src="https://2442470273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBGWv9tHN4FLRiQu7ou5P%2Fuploads%2FctC6C6ynxMklxzq6E2ja%2FScreenshot%202025-04-09%20at%209.51.08%E2%80%AFAM.png?alt=media&#x26;token=985276a6-244c-4580-bf4c-e15bd2146347" alt=""><figcaption></figcaption></figure>

1. **Authorize Calk in Slack**\
   → You’ll be redirected to Slack’s authentication page\
   → Choose the correct Slack workspace\
   → Authorize Calk to access the scopes listed (see below)

✅ *You only need to do this once.*

***

**🔐 Slack Permissions Required**

Here’s what Calk asks for (and why):

| Permission                     | Why It’s Needed                                |
| ------------------------------ | ---------------------------------------------- |
| `View Public Channel Messages` | To read knowledge in team discussions          |
| `Access Files`                 | To allow agents to answer based on shared docs |
| `Access Pins`                  | To access content your team marked important   |
| `View Users & Groups`          | For tagging and context-aware answers          |
| `Access Shared Links`          | To fetch and retrieve URLs shared internally   |

👉 *We never read private channels or DMs.*

***

**📌 Once Connected, What Happens?**

* Your **Slack workspace** appears in your **Knowledge panel**
* You can **see what’s been pulled**
* You can **unlink or update permissions** at any time
* Slack  is available to **any agent it’s linked to. You just have to activate the tool "Slack for each one of your Agents.**