Supported version: Cloud based
API Rate Limit: https://api.slack.com/apis/rate-limits
Supported Authentication: Token based Authentication, OAuth2.0
IMPORTANT: Please make sure your Slack Connector instance must be accessible from the Gathr Machine.
Slack Connector configuration using Token Authentication:
Steps to generate API Key from Slack UI:
1. Go to https://api.slack.com and click on "Create an App" button.
2. Define an appropriate name for the App and select your Slack workspace from the "Development Slack Workspace" dropdown.
3. Click on "Create App".
4. In the "Add features and functionality" section, go to "Permissions".
5. Scroll down and you will find the "Scopes" section.
6. In the "Bot Token Scopes" section, click "Add an OAuth Scope" and select the following scopes:
1.) channels:read
2.) chat:write
3.) chat:write.public
4.) files:read
5.) groups:read
6.) im:read
7.) mpim:read
8.) users.profile:read
9.) users:read
10.) pins:read
11.) team:read
12.) channels:history
13.) groups:history
14.) mpim:history
15.) im:history
16.) user:read.email
17.) emoji:read
7. After adding all the above-mentioned scopes, scroll up and click "Install to Workspace".
8. A web page will appear for your app asking permissions to access your Slack workspace.
9. Click "Allow". You may need administrative rights to perform these steps.
10. Copy the Bot OAuth Token and save it in a Notepad file. This token will be used as API Key.
To configure Slack to use token based authentication, follow the steps below:-
- Enter Slack URL: https://api.slack.com.
- Select “Create New Account” and add user friendly name for account “Slack Account”
- Check "Pass Parameter(s) in Header" and enter following details:
1. Token Parameter Key : Authorization
2. Value : Bearer <Your API Key> - Click on “Save”.
After clicking on ‘Save’, there will be one more connection form popup. Fill in the exactly same information there, which is as follows:
- Enter Slack URL: https://api.slack.com.
- Select “Select Existing Account” and select the same account created in the last form.
- Check "Pass Parameter(s) in Header" and enter following details:
- Click on “Save”.