# 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="/files/JJHJLDVyrLmUnq7H92do" 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.**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.calk-ai.com/knowledge/integrations/slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.