Integration guide

Set up Slack in RouteIQ Dispatch Software

Create a Slack app, install its bot in your workspace, choose a default channel, and connect dispatch notifications.

Updated September 3, 2026
Use a bot token, not a user token. The platform expects a Bot User OAuth Token beginning with xoxb-. Treat it and the optional signing secret like passwords.

Before you start

You will need permission to create or install apps in the target Slack workspace, permission to add a bot to the destination channel, and administrator access to your dispatch workspace.

1. Create a Slack app

  1. Open Your Apps on Slack API.
  2. Select Create New App, then create it from scratch.
  3. Name it clearly, such as dispatch notifications, and select the correct workspace.

2. Add the minimum bot permission

  1. Open OAuth & Permissions in the Slack app settings.
  2. Under Bot Token Scopes, add chat:write.
  3. Avoid unrelated permissions. Sending notifications does not require access to read channel history.

Slack documents this scope in its chat:write reference.

3. Install the app and invite the bot

  1. Select Install to Workspace and approve the requested permission.
  2. Copy the Bot User OAuth Token beginning with xoxb-.
  3. Open the channel RouteIQ Dispatch Software should use and invite the app to it.
  4. Copy the channel name exactly, including the leading # when you enter it in your dispatch workspace. You can use a channel ID when names are ambiguous.
Leave Signing Secret empty for standard notifications

The signing secret is only for a separately configured inbound Slack request URL. Event Subscriptions and slash commands are not part of this outbound-notification setup.

4. Connect Slack to your dispatch workspace

  1. Sign in to your dispatch workspace and open Settings > Integrations.
  2. Find Slack and turn it on.
  3. After it shows Connected, select Configure.
  4. Paste the bot token into Bot User OAuth Token.
  5. Enter the invited channel in Default Channel.
  6. Leave Signing Secret empty for standard notifications.
  7. Leave Is Active selected and save.

5. Verify the setup

  1. Trigger a non-production RouteIQ Dispatch Software notification that targets Slack.
  2. Confirm the message appears in the expected channel under the Slack app's name.
  3. Confirm the app is not posting to an unintended channel or workspace.

Troubleshooting

Slack reports invalid_auth

Confirm the token begins with xoxb-, belongs to the correct workspace, and the app has not been uninstalled.

Slack reports missing_scope

Add chat:write, reinstall the app, and update RouteIQ Dispatch Software if Slack issued a new token.

The channel is not found

Check the channel name or use its channel ID. Invite the bot explicitly, especially for a private channel.

Rotate or remove Slack access

  1. Rotate the bot token or reinstall the app in Slack.
  2. Update the Bot User OAuth Token in your dispatch workspace.
  3. Send a test notification.
  4. Revoke the old token or uninstall the app only after the replacement works.