Skip to main content

Slackbot

Slack connector that acts as your app's bot identity for managing messages, channels, users, and file operations.

Set up​

Slackbot needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Slackbot. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Slack app dashboard.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Slackbot login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (28)

Grant the scopes for the tools you plan to allow.

  • canvases:write
  • channels:history
  • channels:join
  • channels:manage
  • channels:read
  • channels:write.invites
  • channels:write.topic
  • chat:write
  • files:read
  • files:write
  • groups:history
  • groups:read
  • groups:write
  • groups:write.invites
  • groups:write.topic
  • im:history
  • im:read
  • im:write
  • mpim:history
  • mpim:read
  • mpim:write
  • pins:read
  • pins:write
  • reactions:read
  • reactions:write
  • users:read
  • users:read.email
  • users:write

Tools​

Slackbot offers 50 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (23)​

View and search information without changing it.

ToolWhat it does
get_channel_infoGet information about a channel using Channel ID (not channel name)
get_channel_membersGet members of a channel
get_conversation_historyGet message history from a channel using Channel ID with enhanced timestamp filtering.
get_conversation_repliesGet all replies in a Slack thread.
get_current_userResolve the authenticated user ('me'/'myself') to their Slack user ID and profile.
get_file_contentGet the content of a text file
get_file_infoGet information about a file
get_message_permalinkGet a permanent link to a message
get_reactionsRead the emoji reactions on a message: which emoji, how many people used each, and the user IDs who did.
get_unread_messages_from_channelGet all unread messages from a specific channel.
get_unread_messages_from_userGet all unread direct messages from a specific user.
get_user_infoGet complete user information including workspace role, permissions, and profile
get_user_presenceGet a user's presence status
get_users_conversationsGet conversations a user is a member of
list_channelsList channels in the workspace (public and private; direct messages are excluded by default).
list_filesList files in the workspace, most recent first by default. sort (created|timestamp) and sort_dir (asc|desc) order the returned page only — Slack's files.list has no server-side sort, so non-default ordering is not globally consistent across pages.
list_pinned_messagesList all pinned messages and items in a channel
list_scheduled_messagesList scheduled messages that haven't been sent yet
list_unread_channel_messagesGet all unread messages from channels with their message content.
list_unread_direct_messagesGet all unread direct messages and group DMs with their message content.
list_usersList users in the workspace.
lookup_user_by_emailLook up a user by their email address
validate_credentialValidate Slack credentials.

Write (11)​

Create or send data.

ToolWhat it does
add_reactionAdd an emoji reaction to a message
create_canvasCreate a new standalone Slack canvas with optional title and markdown content.
create_channelCreate a new channel
create_channel_canvasCreate a canvas linked to a Slack channel.
invite_to_channelInvite users to a channel
join_channelJoin a channel
pin_messagePin a message to a channel
post_messageSend a message to a Slack channel using Channel ID (not channel name)
post_message_by_nameSend a message to a person or channel by name instead of ID.
schedule_messageSchedule a message to be sent later
upload_fileUpload a file or image to Slack.

Delete or overwrite (16)​

Remove or replace existing data.

ToolWhat it does
archive_channelArchive a channel
delete_canvasPermanently delete a Slack canvas by ID.
delete_fileDelete a file
delete_messageDelete a message from Slack
delete_scheduled_messageDelete a scheduled message
edit_canvasWrite to or edit an existing Slack canvas by applying one or more change operations.
kick_from_channelRemove a user from a channel
leave_channelLeave a channel
remove_reactionRemove an emoji reaction from a message
rename_channelRename a channel
revoke_file_public_urlRevoke public access to a file
set_channel_purposeSet the purpose for a channel
set_channel_topicSet the topic for a channel
set_user_presenceSet your own presence status (auto or away)
unpin_messageRemove a pinned message from a channel
update_messageUpdate an existing message in Slack
⌘J