Skip to main content

​
Overview

What it does

Slack integration connects AI tools directly to your Slack workspace, enabling natural language interactions with channels, messages, users, and workflows.Key Features:
  • Send and read messages in channels and DMs
  • Manage channels and user groups
  • Upload and share files
  • Search message history
  • Create and manage reminders
  • Set status and Do Not Disturb
  • React to messages with emoji
  • Pin and star important items
  • Manage calls and participants
  • Custom emoji management

Use Cases

Team Collaboration:
  • Automate status updates and announcements
  • Send notifications from other systems
  • Archive and search conversation history
  • Create channels for new projects
Workflow Automation:
  • Trigger actions from Slack commands
  • Send alerts and monitoring updates
  • Automate standup reports
  • Create incident response workflows
Information Management:
  • Search across all channels
  • Extract and summarize discussions
  • Archive important conversations
  • Generate team activity reports

​
Quick Start

1

Connect Your Slack Workspace

NimbleBrain Studio uses OAuth2 to securely connect to your Slack workspace.
  1. Navigate to Connections in the sidebar
  2. Click Browse Catalog
  3. Search for “Slack”
  4. Click Install
  5. Click Connect and authorize with your Slack workspace
  6. Grant the requested permissions
OAuth2 provides secure, token-based authentication. You’ll need workspace admin permissions to install apps.
2

Invite Bot to Channels

After connecting, invite the bot to channels you want it to access:
  1. Go to any channel in Slack
  2. Type /invite @NimbleBrain (or your bot name)
  3. Bot can now read and post in that channel
The bot must be invited to private channels before it can access them.
3

Test the Connection

In your Studio chat, try this prompt:
"List all channels in my Slack workspace"
Other test prompts:
  • “Send a message to #general saying ‘Hello from Studio!’”
  • “Show me recent messages in #random”
  • “Create a reminder for tomorrow at 9am”

​
Available Tools

The Slack connection provides 142+ tools organized into the following categories:

​
Messaging

Send, read, update, and delete messages across channels and DMs.
ToolDescription
SLACK_SEND_MESSAGESend a message to a channel, DM, or private channel
SLACK_POST_MESSAGE_TO_CHANNELPost a message to a specific channel
SLACK_UPDATE_MESSAGEEdit an existing message
SLACK_DELETE_MESSAGEDelete a message from a channel
SLACK_SCHEDULE_MESSAGESchedule a message for later delivery
SLACK_GET_PERMALINKGet permanent link to a specific message
SLACK_UNFURL_LINKCustomize URL preview in messages
Example Usage:
"Send a message to #engineering: 'Deployment complete for v2.1.0'"

​
Channel Management

Create, manage, and organize channels.
ToolDescription
SLACK_CREATE_CHANNELCreate a new public or private channel
SLACK_ARCHIVE_CHANNELArchive a channel (make read-only)
SLACK_ARCHIVE_A_SLACK_CONVERSATIONArchive a conversation by ID
SLACK_UNARCHIVE_CHANNELRestore an archived channel
SLACK_RENAME_CHANNELChange a channel’s name
SLACK_SET_CHANNEL_TOPICSet or update channel topic
SLACK_SET_CHANNEL_PURPOSESet channel purpose/description
SLACK_JOIN_CHANNELJoin a public channel
SLACK_LEAVE_CHANNELLeave a channel
SLACK_LIST_CHANNELSGet all channels in workspace
SLACK_GET_CHANNEL_INFOGet detailed channel information
SLACK_GET_CHANNEL_HISTORYRetrieve messages from a channel
SLACK_INVITE_TO_CHANNELInvite users to a channel
SLACK_KICK_FROM_CHANNELRemove users from a channel
Example Usage:
"Create a new private channel called 'project-phoenix' and invite @sarah and @john"

​
Conversations & DMs

Manage direct messages and group conversations.
ToolDescription
SLACK_OPEN_CONVERSATIONOpen or create a direct message
SLACK_CLOSE_CONVERSATION_CHANNELClose a DM or group DM
SLACK_CREATE_GROUP_DMCreate multi-person direct message
SLACK_LIST_CONVERSATIONSList all conversations
SLACK_GET_CONVERSATION_MEMBERSGet members of a conversation
SLACK_GET_CONVERSATION_HISTORYGet message history
Example Usage:
"Create a group DM with @sarah, @john, and @alex to discuss the project"

​
Reactions & Engagement

Add and manage emoji reactions on messages.
ToolDescription
SLACK_ADD_REACTION_TO_MESSAGEAdd emoji reaction to a message
SLACK_REMOVE_REACTIONRemove a reaction from a message
SLACK_GET_REACTIONSGet all reactions on a message
SLACK_LIST_REACTIONSList items with specific reaction
Example Usage:
"Add a thumbs up reaction to the last message in #general"

​
Pins & Stars

Pin important messages and star items for quick access.
ToolDescription
SLACK_PIN_MESSAGEPin a message to a channel
SLACK_UNPIN_MESSAGEUnpin a message
SLACK_LIST_PINSList all pinned items in a channel
SLACK_ADD_A_STAR_TO_AN_ITEMStar a channel, file, or message
SLACK_REMOVE_STARRemove star from an item
SLACK_LIST_STARSList all starred items
Example Usage:
"Pin the message with the sprint goals to #engineering"

​
Reminders

Create and manage personal reminders.
ToolDescription
SLACK_CREATE_A_REMINDERCreate a reminder with text and time
SLACK_COMPLETE_REMINDERMark a reminder as complete
SLACK_DELETE_REMINDERDelete a reminder
SLACK_LIST_REMINDERSList all reminders
SLACK_GET_REMINDER_INFOGet details about a specific reminder
Example Usage:
"Create a reminder for tomorrow at 2pm: 'Review PR #123'"
Time accepts Unix timestamps, seconds from now, or natural language (e.g., ‘in 15 minutes’, ‘every Thursday at 2pm’).

​
User Management

Manage workspace members and their information.
ToolDescription
SLACK_LIST_USERSGet all users in workspace
SLACK_GET_USER_INFOGet detailed user information
SLACK_GET_USER_BY_EMAILFind user by email address
SLACK_GET_USER_PRESENCECheck if user is online/away
SLACK_SET_USER_PRESENCESet your own presence status
SLACK_GET_USER_PROFILEGet user’s profile information
SLACK_SET_USER_PROFILEUpdate your profile
Example Usage:
"Find the Slack user with email [email protected]"

​
User Groups

Create and manage user groups (subteams).
ToolDescription
SLACK_CREATE_A_SLACK_USER_GROUPCreate a new user group
SLACK_UPDATE_USER_GROUPUpdate group settings
SLACK_DISABLE_USER_GROUPDisable a user group
SLACK_ENABLE_USER_GROUPRe-enable a disabled group
SLACK_LIST_USER_GROUPSList all user groups
SLACK_GET_USER_GROUPGet group details
SLACK_UPDATE_USER_GROUP_MEMBERSAdd/remove group members
Example Usage:
"Create a user group called 'frontend-team' with @sarah, @john, and @alex"

​
Do Not Disturb

Manage Do Not Disturb settings.
ToolDescription
SLACK_SET_SNOOZE_DURATIONTurn on DND mode
SLACK_END_DNDEnd Do Not Disturb
SLACK_END_SNOOZEEnd snooze early
SLACK_GET_DND_INFOGet your DND status
SLACK_GET_TEAM_DND_INFOGet DND status for multiple users
Example Usage:
"Turn on Do Not Disturb for 2 hours"

​
File Management

Upload, share, and manage files.
ToolDescription
SLACK_UPLOAD_FILEUpload a file to Slack
SLACK_DELETE_A_FILE_BY_IDPermanently delete a file
SLACK_LIST_FILESList files in workspace
SLACK_GET_FILE_INFOGet file details
SLACK_SHARE_FILEShare file to channels
SLACK_ADD_A_REMOTE_FILEAdd external file reference (Google Drive, Dropbox)
SLACK_UPDATE_REMOTE_FILEUpdate external file info
SLACK_DELETE_REMOTE_FILERemove external file reference
SLACK_DELETE_FILE_COMMENTDelete a comment on a file
Example Usage:
"Upload the Q4_Report.pdf to #leadership with message 'Q4 results attached'"

​
Custom Emoji

Manage custom workspace emoji.
ToolDescription
SLACK_ADD_EMOJIAdd custom emoji to workspace
SLACK_ADD_A_CUSTOM_EMOJI_TO_A_SLACK_TEAMAdd custom emoji with image URL
SLACK_ADD_AN_EMOJI_ALIASCreate alias for existing emoji
SLACK_LIST_EMOJIList all custom emoji
Example Usage:
"Add a custom emoji called 'shipit' using this image URL"

​
Calls

Manage Slack calls and participants.
ToolDescription
SLACK_ADD_CALL_PARTICIPANTSRegister new call participants
SLACK_END_CALLEnd an active call
SLACK_UPDATE_CALLUpdate call information
SLACK_GET_CALL_INFOGet call details
Example Usage:
"Add @sarah and @john as participants to the current call"
Search messages and files across your workspace.
ToolDescription
SLACK_SEARCH_MESSAGESSearch for messages
SLACK_SEARCH_FILESSearch for files
SLACK_SEARCH_ALLSearch messages and files
Example Usage:
"Search for all messages mentioning 'API documentation' from last week"

​
Team & Workspace

Get workspace and team information.
ToolDescription
SLACK_GET_TEAM_INFOGet workspace information
SLACK_GET_TEAM_PROFILEGet team profile fields
SLACK_LIST_TEAM_MEMBERSList workspace members
SLACK_GET_ACCESS_LOGSGet workspace access logs
SLACK_GET_BILLABLE_INFOGet billable user info
Example Usage:
"Show me information about this Slack workspace"

​
Example Workflows

Scenario: Automate daily standup updatesPrompt:
"Post to #engineering: 'Daily Standup - May 15

Yesterday: Completed API authentication, reviewed PRs
Today: Working on database optimization
Blockers: None

cc: @tech-lead'"
What happens:
  • Formats message with clear sections
  • Posts to team channel
  • Mentions relevant people
  • Creates searchable standup history

​
Authentication

OAuth2 Authentication: This connection uses OAuth2 for secure authentication.

​
How It Works

When you connect Slack in NimbleBrain Studio:
  1. You’ll be redirected to Slack’s authorization page
  2. Select your workspace
  3. Review and grant permissions
  4. You’re automatically redirected back to Studio

​
Required Scopes

The integration requests comprehensive scopes for full functionality: Message Scopes:
  • chat:write - Send messages
  • channels:history - Read public channel messages
  • groups:history - Read private channel messages
  • im:history - Read direct messages
  • mpim:history - Read group DMs
Channel Scopes:
  • channels:read / channels:write - Manage channels
  • groups:read / groups:write - Manage private channels
  • im:read / im:write - Manage DMs
User & Team Scopes:
  • users:read / users:write - User management
  • users:read.email - Access email addresses
  • usergroups:read / usergroups:write - User groups
  • team:read - Workspace info
Other Scopes:
  • files:read / files:write - File management
  • pins:read / pins:write - Pin management
  • reactions:read / reactions:write - Reactions
  • reminders:read / reminders:write - Reminders
  • search:read - Search functionality
  • emoji:read - Custom emoji
  • dnd:read / dnd:write - Do Not Disturb
You can review connected apps in Slack under Settings & Administration → Manage Apps.

​
Rate Limits

Slack has rate limits to ensure platform stability:
TierMethodsLimit
Tier 1Most read operations1 req/sec
Tier 2Posting messages1 req/sec per channel
Tier 3File uploads20 req/min
Tier 4Admin operations20 req/min
Posting too many messages quickly can trigger rate limiting. Studio automatically handles retries with appropriate delays.

​
Troubleshooting

Issue: OAuth authorization didn’t completeSolutions:
  • Ensure you have workspace admin permissions
  • Try a different browser or incognito mode
  • Check that popup blockers aren’t interfering
  • Contact your workspace admin if you lack permissions
Issue: missing_scope errorSolutions:
  • Reconnect to grant additional scopes
  • Verify your workspace allows the app
  • Some operations require workspace admin
Issue: channel_not_found errorSolutions:
  • Verify channel name or ID is correct
  • Invite bot to private channels first
  • Ensure channel hasn’t been archived
  • Use channel ID instead of name for reliability
Issue: rate_limited errorSolutions:
  • Wait for retry-after time to pass
  • Reduce frequency of requests
  • Use threads instead of channel messages
  • Studio automatically handles retries
Issue: Can’t read or post to a channelSolutions:
  • Invite bot with /invite @BotName
  • Bot must be member of private channels
  • Check channel permissions allow bots

​
Best Practices

Message Etiquette

  • Use threads for detailed discussions
  • Don’t spam channels with bot messages
  • Format messages clearly
  • Mention users only when needed
  • Use appropriate emoji reactions

Channel Organization

  • Use descriptive channel names
  • Set clear channel topics
  • Archive inactive channels
  • Use naming conventions
  • Document channel purposes

Security

  • Review app permissions regularly
  • Monitor bot activity
  • Use minimal required scopes
  • Don’t share tokens
  • Audit connected apps

Automation

  • Test in dedicated channels first
  • Avoid message flooding
  • Provide context in messages
  • Use appropriate channels
  • Handle errors gracefully

Slack API Reference

Official Slack API methods reference

Slack App Directory

Browse and manage Slack apps

Slack Community

Connect with Slack developers
Need help? Join the NimbleBrain Discord or email [email protected]