Slack

Overview of the Slack integration.

The following documentation is for Slack v2.3.1.

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:

1

Navigate

Using the left navigation menu, go to Integrations → Explore Integrations.

2

Find

Search for the integration and click on it.

3

Connect

Click on Connect to add a connection to the integration.

4

Configure

Add a name for the connection. You'll be prompted for authentication details if needed. Then, click on Connect.

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