GNETiX Docs
Integrations

Slack

Connect GNETiX to Slack

GNETiX integrates with Slack using Socket Mode, which means no public URL or webhook endpoint is required. The bot connects to Slack over an outbound WebSocket, just like the Webex integration.

Features

FeatureSupported
Direct messagesYes
Channel messages (mention)Yes
Text messagesYes

Setup

Step

Create a Slack App

  1. Go to api.slack.com/apps and click Create New App
  2. Choose From scratch and give it a name and workspace
  3. Under OAuth & Permissions, add the following Bot Token Scopes:
    • app_mentions:read
    • chat:write
    • im:history
    • im:read
    • im:write
    • users:read
    • users:read.email

Step

Enable Socket Mode

  1. In your app settings, go to Socket Mode and enable it
  2. Generate an App-Level Token with the connections:write scope
  3. Copy the token (starts with xapp-)

Step

Enable Events

  1. Go to Event Subscriptions and enable events
  2. Subscribe to the following bot events:
    • app_mention
    • message.im

Step

Install the App

  1. Go to Install App and click Install to Workspace
  2. Authorize the requested permissions
  3. Copy the Bot User OAuth Token (starts with xoxb-)

Step

Configure in GNETiX

  1. Navigate to System Settings > Integrations > Slack
  2. Enter the Bot Token (xoxb-...)
  3. Enter the App Token (xapp-...)
  4. Click Save

GNETiX connects to Slack via Socket Mode automatically.

User Matching

GNETiX matches Slack users by their email address. The Slack workspace email must match the email configured in GNETiX for each user.

Users must have the Slack platform toggle enabled in their profile.

Slack requires the users:read.email scope to resolve email addresses from user IDs. Without this scope, user matching will fail.

Usage

  • Direct messages: Send a message directly to the bot. No mention required.
  • Channels: Invite the bot to a channel and mention it with @BotName to trigger a response.