> For the complete documentation index, see [llms.txt](https://docs.kognitos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kognitos.com/guides/platform/integrations/slack.md).
# Slack
{% hint style="info" %}
The following documentation is for **Slack v2.3.0**.
{% endhint %}
## Overview
Slack is a leading business communication platform featuring channels, direct messaging, and integrations. This integration allows automated message sending, channel management, file sharing, and team notification workflows. Enhance team communication and streamline collaborative work processes.
## Setup
The following integrations need to be connected to your Kognitos workspace:
* **Slack**
### Steps
Follow these steps to connect the integration in Kognitos:
{% stepper %}
{% step %}
#### Navigate
Using the left navigation menu, go to **Integrations** → **Explore Integrations**.
{% endstep %}
{% step %}
#### Find
Search for the integration and click on it.
{% endstep %}
{% step %}
#### Connect
Click on **Connect** to add a connection to the integration.
{% endstep %}
{% step %}
#### Configure
Add a name for the connection. You'll be prompted for [**authentication**](#authentication) details if needed. Then, click on **Connect**.
{% endstep %}
{% endstepper %}
## Authentication
Use one of the following authentication methods to connect this integration in Kognitos. Each method has its own configuration requirements.
### Connect using Bot Token
Connect to Slack using a Bot User OAuth Token.
| Label | Description | Type |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| Bot Token | The Slack Bot User OAuth Token (starts with `xoxb-`). Found in the Slack App Management page under "OAuth & Permissions" > "Bot User OAuth Token". | `sensitive` |
## Actions
The following actions are available in the **Slack** integration:
### 1. List channels from slack
List all channels from Slack.
### 2. List users from slack
List all users from Slack.
### 3. Read the item's messages
Read messages from a channel.
### 4. Retrieve a channel from slack
Retrieve a channel from Slack.
### 5. Retrieve a user from slack
Retrieve a user from Slack.
### 6. Send message to an item
Send a message to a channel or user.
## Concepts
### Slack channel
Represents a reference to a channel in Slack.
| Field Name | Description | Type |
| -------------- | ------------------------ | ------ |
| `channel_id` | The ID of the channel. | `text` |
| `channel_name` | The name of the channel. | `text` |
### Slack user
Represents a reference to a channel in Slack.
| Field Name | Description | Type |
| ------------ | --------------------------------------------------- | ---------------- |
| `user_id` | The ID of the user. | `text` |
| `user_name` | The name of the user. | `text` |
| `channel_id` | The ID of the IM channel with the current user/bot. | `optional[text]` |
### Slack message
Represents a reference to a message in the Slack
| Field Name | Description | Type |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| `text` | The message. | `text` |
| `timestamp` | The timestamp of the message. | `number` |
| `meta` | Metadata of the message | `json` |
| `channel_id` | The ID of the channel where the message was posted. | `optional[text]` |
| `user_id` | The ID of the user who posted the message. | `optional[text]` |
| `team_id` | The ID of the workspace (team) the message belongs to. | `optional[text]` |
| `channel_type` | The type of conversation the message was posted in, e.g. `channel` (public), `group` (private), `im` (direct message) or `mpim` (group direct message). | `optional[enum[CHANNEL, GROUP, IM, MPIM]?]` |
### Slack action block
Represents an action block in Slack.
| Field Name | Description | Type |
| ---------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `block_id` | The ID of the block. | `optional[text]` |
| `elements` | The elements of the action. | `optional[list of list of slack button element` or `slack checkbox element` or `slack date picker element` or `slack image element` or `slack markdown element?` or `slack overflow element` or `slack static select element]` |
### Slack context block
Represents a context block in Slack.
| Field Name | Description | Type |
| ---------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `block_id` | The ID of the block. | `optional[text]` |
| `elements` | The elements of the context block. | `optional[list of list of slack button element` or `slack checkbox element` or `slack date picker element` or `slack image element` or `slack markdown element?` or `slack overflow element` or `slack static select element]` |
### Slack divider block
Represents a divider block in Slack.
| Field Name | Description | Type |
| ---------- | -------------------- | ---------------- |
| `block_id` | The ID of the block. | `optional[text]` |
### Slack header block
Represents a header block in Slack.
| Field Name | Description | Type |
| ---------- | ----------------------- | ---------------- |
| `text` | The text of the header. | `text` |
| `block_id` | The ID of the block. | `optional[text]` |
### Slack image block
Represents an image block in Slack.
| Field Name | Description | Type |
| ----------- | --------------------------- | ---------------- |
| `image_url` | The URL of the image. | `text` |
| `alt_text` | The alt text for the image. | `text` |
| `block_id` | The ID of the block. | `optional[text]` |
### Slack markdown block
Represents a markdown block in Slack.
| Field Name | Description | Type |
| ---------- | ------------------------------- | ---------------- |
| `text` | The text of the markdown block. | `text` |
| `block_id` | The ID of the block. | `optional[text]` |
### Slack section block
Represents a section block in Slack.
| Field Name | Description | Type |
| ----------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `text` | The text of the section. | `optional[text]` |
| `fields` | The fields of the section. | `optional[slack markdown element?` or `text]` |
| `accessory` | The accessory of the section. | `optional[slack button element` or `slack checkbox element` or `slack date picker element` or `slack image element` or `slack markdown element?` or `slack overflow element` or `slack static select element]` |
| `block_id` | The ID of the block. | `optional[text]` |
### Slack attachment
Represents a reference to an attachment in the Slack
| Field Name | Description | Type |
| ----------- | --------------------------- | ------ |
| `file_name` | The name of the attachment. | `text` |
| `data` | The File object | `file` |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.kognitos.com/guides/platform/integrations/slack.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.