Slack
Overview
Pre-built tooling
✅ Authorization
✅ Authorization
✅ Read & write data
✅ Read & write data
| Tools | Status |
|---|---|
| Pre-built integrations | ✅ |
| API unification | ✅ |
| 2-way sync | ✅ |
| Webhooks from Nango on data modifications | ✅ |
| Real-time webhooks from 3rd-party API | ✅ |
| Proxy requests | ✅ |
✅ Observability & data quality
✅ Observability & data quality
| Tools | Status |
|---|---|
| HTTP request logging | ✅ |
| End-to-type type safety | ✅ |
| Data runtime validation | ✅ |
| OpenTelemetry export | ✅ |
| Slack alerts on errors | ✅ |
| Integration status API | ✅ |
✅ Customization
✅ Customization
| Tools | Status |
|---|---|
| Create or customize use-cases | ✅ |
| Pre-configured pagination | ✅ |
| Pre-configured rate-limit handling | 🚫 (time to contribute: <48h) |
| Per-customer configurations | ✅ |
Pre-built integrations
Messages
Messages
| Endpoint | Description | Readme |
|---|---|---|
POST /messages | An action that sends a message to a slack channel. | 🔗 |
GET /messages | Syncs Slack messages, thread replies and reactions from messages & thread replies for all channels, group dms and dms the bot is a part of. For every channel it will do an initial full sync on first detection of the channel. For subsequent runs it will sync messages, threads & reactions from the last 10 days. Scopes required: channels:read, and at least one of channels:history, groups:history, mpim:history, im:history | 🔗 |
Others
Others
| Endpoint | Description | Readme |
|---|---|---|
GET /users | Syncs information about all Users on the Slack workspace | 🔗 |
GET /channels | Syncs information about all Slack channels. Which channels get synced (public, private, IMs, group DMs) depends on the scopes. If joinPublicChannels is set to true, the bot will automatically join all public channels as well. Scopes: At least one of channels:read, groups:read, mpim:read, im:read. To also join public channels: channels:join | 🔗 |
GET /messages-reply | Syncs Slack messages, thread replies and reactions from messages & thread replies for all channels, group dms and dms the bot is a part of. For every channel it will do an initial full sync on first detection of the channel. For subsequent runs it will sync messages, threads & reactions from the last 10 days. Scopes required: channels:read, and at least one of channels:history, groups:history, mpim:history, im:history | 🔗 |
GET /messages-reaction | Syncs Slack messages, thread replies and reactions from messages & thread replies for all channels, group dms and dms the bot is a part of. For every channel it will do an initial full sync on first detection of the channel. For subsequent runs it will sync messages, threads & reactions from the last 10 days. Scopes required: channels:read, and at least one of channels:history, groups:history, mpim:history, im:history | 🔗 |
Access requirements
| Pre-Requisites | Status | Comment |
|---|---|---|
| Paid dev account | ✅ Not required | Free, self-signup here. |
| Paid test account | ✅ Not required | Provision a sandbox for free from your developer account. Note that you will need to provide a payment method. The payment method is used for identity verification purposes only; you will not be charged. |
| Partnership | ✅ Not required | |
| App review | ✅ Not required | Only required if you intend to list your app in the Slack Marketplace |
| Security audit | ✅ Not required |
Setup guide
Create a developer account
Go to Slack Developer Program signup page and click Join the Program.
Create & configure a Slack app
Start creating a Slack app by clicking on the Your Apps button then Create New App.
Choose how you’d like to configure your app’s scopes and settings. You can do this using a manifest file or starting from scratch.
After choosing how you’d like to configure your app, add your app’s name and pick a workspace to develop your app in.
In the Basic Information tab, copy/paste your app’s Client ID and Client Secret, you will need to specify it in Nango later on.
Set up the OAuth scopes
In the OAuth & Permissions tab, configure the following Redirect URL: https://api.nango.dev/oauth/callback.
Still in the OAuth & Permissions tab, under Scopes, add the scopes that are relevant to how you want to consume Slack’s API.
There are 2 types of scopes, Bot Token Scopes and User Token Scopes. Bot tokens represent a bot associated with an app installed in a workspace. They govern what your app can access. They will be added to Nango when creating a Slack integration.
User Token Scopes access user data and act on behalf of users that authorize them. They will be added to Nango when creating a Slack connection.
Create a Slack Developer Sandbox
If you don’t have a Slack Developer Sandbox already, head over to Slack’s Developer Program dashboard and provision one to test your integration.
Next
Follow the Quickstart.