LogoLogo
  • GETTING STARTED
    • Welcome to the NLX platform
    • How NLX works
    • Guides
      • Analytics dashboard
      • Chat
      • Generative Journey (Slots)
      • Model Context Protocol
      • Voice
      • Voice+ script
      • Touchpoint components
        • Carousel modality
        • Video modality
    • Terms & concepts
    • Generative AI
    • Developer
  • Build
    • Workspace setup
    • Flows
      • Intro to flows & variables
      • The Canvas
      • Flow settings
      • Nodes
      • Flow appearance
    • Resources
      • Actions
        • Implementation
        • Request model
      • Analytics tags
      • Context variables
      • Data requests
        • Implementation
        • Response model
        • Request model
      • Knowledge bases
        • Ingest content
        • Add metadata (beta)
        • Apply KB
      • Lifecycle hooks
        • Implementation
      • Modalities
      • Secrets
      • Slots (custom)
        • Adding values
        • Translating slots
      • Voice+ scripts
        • Add + download script
        • Deploy script + install SDK
        • Create Voice+ flow
    • Integrations
      • Channels
        • Alexa
        • Amazon Chime SDK
        • Amazon Connect
        • AWS End User Messaging SMS
        • AWS End User Messaging Social
        • Bandwidth
        • Genesys
        • Twilio
        • Zendesk Sunshine
      • LLM services
        • Amazon Bedrock
        • Anthropic
        • Azure OpenAI
        • Cerebras
        • Cohere
        • Google Vertex AI
        • Groq
        • NVIDIA
        • OpenAI
        • xAI
      • NLP
        • Amazon Lex
        • Google Dialogflow
        • Google Dialogflow CX
        • Custom NLP
    • Translations
  • Deploy & test
    • Applications
      • Attach flows
      • Assign default behavior
      • Add channels
        • API
          • REST API
        • Alexa
        • Amazon Chime SDK
        • Amazon Connect
        • AWS End User Messaging SMS
        • AWS End User Messaging Social
        • Genesys
        • Genesys SMS
        • Messenger
        • Microsoft Teams
        • Slack
        • SMS via Bandwidth
        • Twilio SMS
        • Twilio Voice
        • WhatsApp via Twilio
        • Zendesk Sunshine
      • Deploy
      • Optional: Set lifecycle
      • Optional: Set languages
    • Test
      • Test a conversation
      • Automated tests
      • Test an external integration
  • Analyze
    • Conversations
    • Analytics
      • Creating dashboards
      • Formulas & multi-metrics
      • Canvas analytics
    • Training
  • Workspace Settings
    • Escalation channels
    • Resource tags
    • Audit
  • Admin
    • Access control
      • Roles & permissions
    • Notifications
    • FAQ
    • Contact support
Powered by GitBook
On this page
  • Step 1: Create a Slack app
  • Step 2: Generate Bot user access token
  • Step 3: Access Signing secret
  • Step 4: Create Slack channel in NLX
  • Step 5: Post deployment
  1. Deploy & test
  2. Applications
  3. Add channels

Slack

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

Last updated 16 days ago

Step 1: Create a Slack app

In order to get your application up and running with Slack, you'll first start by creating a Slack app:

  • Go to .

  • Under Customize your workspace, click the Create an app button

  • Select create From scratch

  • Enter a name under App Name

  • Select a workspace for developing your app

  • 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:

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

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

  • Select the Chat:write permissions scope


Step 2: Generate Bot user access token

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

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

  • Click Allow

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


Step 3: Access Signing secret

  • 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.


Step 4: Create Slack channel in NLX

  • Navigate to Channels tab of your application

  • Expand Slack option

  • Select + Create channel

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

  • 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

  • Click Create channel


Step 5: Post deployment

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.

  • From the Deployments tab of your application, click the Details link for the deployment:

  • Under Setup instructions, expand the Slack channel > Click the copy icon to copy the Application URL

  • 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)

  • Under Features, select Interactivity & Shortcuts from the menu

  • Set the toggle to enable interactivity

  • Paste the Application URL into the Request URL field

  • Under Features, click Event Subscriptions from the menu

  • Set the toggle to enable events

  • Paste the Application URL into the Request URL field

  • Click the down caret to the right of the Subscribe to bot events section

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

  • When finished, click Save Changes

Before proceeding to Step 5, create a .

build and deploy your application
https://api.slack.com
Slack api page for your apps
Slack api page for your app
Providing the Bot URL in Slack
Enable Events in Slack
Adding Bot User Events in Slack