Prerequisites
- A Slack workspace where you have admin permissions
- Ability to install apps in your workspace
Creating a Slack App
- Visit the Slack API website
- Click “Create an app” or “Your apps”
- Choose “From scratch”
- Enter your app name and select your workspace
- Click “Create app”
Configuring Your Slack App
Basic Information
- In your app settings, go to “Basic Information”
- Note your Client ID and Client Secret (you’ll need these later)
- Add a short description of your app
OAuth & Permissions
- Navigate to “OAuth & Permissions” in the sidebar
- Add the following scopes to your app:
Bot Token Scopes
channels:read
- View basic information about public channelschannels:write
- Manage public channelschat:write
- Send messages as your appchat:write.public
- Send messages to channels your app isn’t ingroups:read
- View basic information about private channelsgroups:write
- Manage private channelsim:read
- View basic information about direct messagesim:write
- Send direct messagesmpim:read
- View basic information about group direct messagesmpim:write
- Send messages to group direct messagesusers:read
- View people in your workspaceusers:read.email
- View email addresses of people in your workspace
User Token Scopes (if needed)
channels:read
- View basic information about public channelschat:write
- Send messages as the user
Event Subscriptions (Optional)
- Go to “Event Subscriptions”
- Enable events if you want to receive real-time updates
- Add relevant events like
message.channels
,message.im
, etc.
Setting Up in Jinba Flow
- Go to your workspace settings in Jinba Flow
- Navigate to the “Secret” section
- Find “Slack” in the list of available credentials
- Click “Configure” or “Add New”
- Enter your Slack app credentials:
- Client ID: From your Slack app’s Basic Information
- Client Secret: From your Slack app’s Basic Information
- Bot Token: From OAuth & Permissions (starts with
xoxb-
) - User Token: From OAuth & Permissions (starts with
xoxp-
) if needed
- Click “Save” to store your credentials
Installing Your App
- Go to “OAuth & Permissions” in your Slack app
- Click “Install to Workspace”
- Review the permissions and click “Allow”
- Copy the Bot User OAuth Token (starts with
xoxb-
) - Copy the User OAuth Token (starts with
xoxp-
) if you requested user scopes
Usage
Once configured, you can use Slack in your flows to:- Send messages to channels, direct messages, or group messages
- Create and manage channels
- Read messages and user information
- Upload files and attachments
- Respond to events in real-time