Slack Integration

Nexa delivers agent and automation notifications to Slack. Configuration lives across two tabs in System Configuration: Slack Configuration (the bot credentials) and Slack Channel (which channels receive messages). Set up Slack in the dev environment; the add and edit controls are hidden in higher environments.

Slack Configuration tab

This tab holds the credentials for the Slack app that Nexa posts as. Existing rows show token fields masked as ********; the real values are only entered in the add/edit panel.

Field	Key	Description
Slack Bot Name	slack_bot_name	Display name for the bot configuration.
Slack Bot Token	slack_bot_token	Bot user OAuth token (starts with xoxb-). Used to post messages.
Slack App Token	slack_app_token	App-level token (starts with xapp-). Used for socket-mode connections.
Slack Signing Secret	slack_signing_secret	Verifies that inbound requests originate from Slack.

All four fields are required.

Add or edit the bot configuration

1. Open System Configuration → Slack Configuration.

2. Select ADD to create a configuration, or the edit (pencil) action on an existing row.

3. In the Add Slack Configuration panel, enter the bot name, bot token, app token, and signing secret.

4. Select Save. The row appears with the token columns masked.

Slack Channel tab

This tab maps the Slack channels that receive Nexa messages. Each channel is paired with the bot token used to post to it.

Field	Key	Description
Channel	channel	The Slack channel (name or ID) to post to.
Slack Bot Token	slack_bot_token	The bot token authorized to post to this channel.

Add or edit a channel

1. Open System Configuration → Slack Channel.

2. Select ADD, or the edit action on an existing channel.

3. Enter the channel and the bot token in the Add Slack Channel panel.

4. Select Save.

Note

Both Channel and Slack Bot Token are required. The bot must be invited to the channel in Slack before it can post there.

Where to get the credentials

Create a Slack app in your workspace, then copy the values from the Slack app settings:

• Bot token (xoxb-…) — from OAuth & Permissions after installing the app to your workspace.
• App token (xapp-…) — from Basic Information → App-Level Tokens.
• Signing secret — from Basic Information → App Credentials.

Caution

Treat these tokens as secrets. Once saved, the token columns display only ******** — rotate the token in Slack and re-enter it here if you suspect exposure.