Slack

Learn to set up a Slack communication channel for your application in your NLX workspace

Create a Slack app

  1. Go to https://api.slack.com.

  2. Under Customize your workspace, click the Create an app button

  3. Select create From scratch

  4. Enter a name under App Name

  5. Select a workspace for developing your app

  6. Click Create App > This brings up the Slack api page for Your Apps with your newly-created app selected in the dropdown of the upper left:

Slack api page for your apps

  1. Next, define what your bot can access by Click OAuth & Permissions under the Features in the menu bar

  2. Scroll to the Scopes section and under Bot Token Scopes > Click Add an OAuth Scope button

  3. Select the Chat:write permissions scope

Generate Bot user access token

  1. Under Features in the Slack account menu, select OAuth & Permissions.

  2. Under OAuth Tokens for Your Workspace, click the Install to Workspace button

  3. Click Allow

An OAuth token is automatically generated for your workspace and the value now displays in the Bot User OAuth Token.

Access Signing secret

  1. Under Settings in the menu, select Basic Information and look under App Credentials

The Signing Secret value is hidden by default. Click Show to reveal the value.

Slack api page for your app

Add channel to app

  1. Select Configuration tab of your Core application in your NLX workspace

  2. Choose + Add channel under Delivery section > Choose Slack

  3. Enter Bot user access token found under the OAuth & Permissions page of your Slack app

  4. Enter Signing Secret found on the Basic Information page of your Slack app

Optional:

  • Language: Allows you to select the language used for this channel

  • Token endpoint: For retrieving a Slack access token for a given Slack conversation

  • Token endpoint API key: The API key that protects the Token endpoint

  1. Click Create channel

  2. Click Save

Before proceeding to Step 5, create a build and deploy your application.

Add URL to Slack

Once you've set up the Slack channel and deployed your application in NLX, you'll need to provide the URL to your Slack api.

  1. From the Configuration tab of your application, click the Slack channel and choose the Setup instructions tab

  2. Copy the Application URL

  3. Go to the Slack api page (if you have more than one app in Slack, make sure the correct app is selected in the dropdown on the upper-left of the page)

  4. Under Features, select Interactivity & Shortcuts from the menu

  5. Set the toggle to enable interactivity

  6. Paste the Application URL into the Request URL field

Providing the Bot URL in Slack

  1. Under Features, click Event Subscriptions from the menu

  2. Set the toggle to enable events

  3. Paste the Application URL into the Request URL field

Enable Events in Slack

  1. Click the down caret to the right of the Subscribe to bot events section

Adding Bot User Events in Slack

  1. Click the Add Bot User Event button, then select from the list to add the appropriate events

  2. When finished, click Save Changes

Last updated