> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Connect Slack to your Atako agents — 21 read and 18 write actions.

Let your agents work in your Slack workspace — post, update and schedule messages, react, manage channels, and read conversations, users and files.

## Connection

* **Authentication**: API key (Bot User OAuth Token).

<Note>
  Create an app at api.slack.com/apps → OAuth & Permissions. Add the bot scopes you need — at minimum "chat:write" and "channels:read"; for the full action set also "channels:history", "channels:manage", "reactions:read", "reactions:write", "users:read", "users:read.email", "pins:read", "pins:write", "usergroups:read", "files:read", "emoji:read", "dnd:read" and "team:read". Install the app to your workspace, then copy the Bot User OAuth Token (starts with xoxb-).

  See [Slack's documentation](https://api.slack.com/concepts/token-types#bot).
</Note>

## Read actions (21)

| Action                     | Description                                                                |
| -------------------------- | -------------------------------------------------------------------------- |
| `get_channel_info`         | Fetch metadata about a channel (name, topic, purpose, member count).       |
| `get_channel_members`      | List the member user IDs of a channel.                                     |
| `get_conversation_history` | Fetch recent messages from a channel.                                      |
| `get_dnd_info`             | Fetch the Do Not Disturb status of a user.                                 |
| `get_message_permalink`    | Fetch a shareable permalink URL for a specific message.                    |
| `get_reactions`            | Fetch the reactions on a specific message.                                 |
| `get_team_info`            | Fetch information about the workspace (name, domain, icon).                |
| `get_thread_replies`       | Fetch the replies of a message thread.                                     |
| `get_user_info`            | Fetch information about a workspace member.                                |
| `get_user_presence`        | Fetch whether a user is currently active or away.                          |
| `get_user_profile`         | Fetch the profile fields (real name, email, title…) of a user.             |
| `list_channels`            | List channels in the workspace.                                            |
| `list_custom_emoji`        | List the custom emoji of the workspace.                                    |
| `list_files`               | List files in the workspace, optionally filtered by channel, user or type. |
| `list_pins`                | List the items pinned to a channel.                                        |
| `list_scheduled_messages`  | List pending scheduled messages, optionally filtered by channel.           |
| `list_user_group_members`  | List the user IDs belonging to a user group.                               |
| `list_user_groups`         | List the user groups of the workspace.                                     |
| `list_user_reactions`      | List items (messages, files) a user has reacted to.                        |
| `list_users`               | List the members of the workspace.                                         |
| `lookup_user_by_email`     | Find a workspace user by their email address.                              |

## Write actions (18)

| Action                     | Description                                                                  |
| -------------------------- | ---------------------------------------------------------------------------- |
| `add_reaction`             | Add an emoji reaction to a message.                                          |
| `archive_channel`          | Archive a channel.                                                           |
| `create_channel`           | Create a public or private channel.                                          |
| `delete_message`           | Delete a message posted by the bot.                                          |
| `delete_scheduled_message` | Cancel a pending scheduled message before it is sent.                        |
| `invite_to_channel`        | Invite users to a channel (comma-separated user IDs).                        |
| `join_channel`             | Join an existing public channel as the bot.                                  |
| `open_conversation`        | Open a direct or multi-person message with users (comma-separated user IDs). |
| `pin_message`              | Pin a message to a channel.                                                  |
| `post_ephemeral`           | Post a message in a channel that only one user can see.                      |
| `post_message`             | Post a message to a channel, optionally as a thread reply.                   |
| `remove_reaction`          | Remove an emoji reaction from a message.                                     |
| `schedule_message`         | Schedule a message to be posted at a future time.                            |
| `set_channel_purpose`      | Set the purpose (description) of a channel.                                  |
| `set_channel_topic`        | Set the topic of a channel.                                                  |
| `unarchive_channel`        | Restore an archived channel.                                                 |
| `unpin_message`            | Un-pin a message from a channel.                                             |
| `update_message`           | Edit the text of a message previously posted by the bot.                     |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.