Slack

Supported version: Cloud based

API Rate Limit: 30000 requests/hour/workspace.

Supported Authentication: Token based Authentication, OAuth2.0
IMPORTANT: Please make sure your Slack Connector instance must be accessible from the Klera 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 "Scopes" section.

6. In the "User Token Scopes" section, click "Add an OAuth Scope" and select the following scopes:

    1.) channels:read

    2.) chat:write

    3.) files:read

    4.) groups:read

    5.) im:read

    6.) mpim:read

    7.) users.profile:read

    8.) users:read

    9.) search:read

   10.) chat:write:user

   11.) chat:write:bot

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 this steps.

10. Copy the OAuth Token and save it in a Notepad file. This token will be used as API Key.

Copy the User OAuth and Bot User Token both.

To configure Slack to use token based authentication, follow the steps below:-

1. Enter Slack URL: https://api.slack.com.
2. Select “Create New Account” and add user friendly name for account “Slack Account”
3. Check "Pass Parameter(s) in Header" and enter following details:
   1. Token Parameter Key : Authorization
   2. Value : Bearer <Your API Key>
4. Click on “Save”.
   
   
   
   

Slack Connector configuration using OAuth2.0:

Steps to get OAuth credentials from Slack UI:

1. Go to Slack App configuration page.

for example: https://api.slack.com/apps/<Your app Id here>/general

2. Go to the 'Basic Information' section and scroll down to the section 'App Credentials' and get 'Client Id' and 'Client Secret'.

To configure Slack Connector to use OAuth2.0 authentication, follow the steps below:-

1. 1. Right click on the entity of column “Slack” and go-to Connectors → Connections → Configure.
   2. Enter following details in the opened form:
   3. Instance URL: Instance URL of your Slack instance: https://api.slack.com
   4. Application Key: Enter Client ID.
   5. Application Secret: Enter Client Secret.
   6. Authorization URL: https://slack.com/oauth/v2/authorize
   7. Access Token URL: https://slack.com/api/oauth.v2.access
   8. Enter the required scopes for example: channels:read users:read users.profile:read dnd:read bookmarks:read reactions:read team:read emoji:read calls:read im:read groups:read chat:write
   9. Domain for Callback: Enter Hostname with domain of Klera.
   10. Click on save.