Integration guide

Set up Slack in RouteIQ

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

Updated September 3, 2026
Use a bot token, not a user token. RouteIQ 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 RouteIQ administrator access.

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 RouteIQ 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 should use and invite the app to it.
  4. Copy the channel name exactly, including the leading # when you enter it in RouteIQ. 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 RouteIQ

  1. Sign in to RouteIQ 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 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 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 RouteIQ.
  3. Send a test notification.
  4. Revoke the old token or uninstall the app only after the replacement works.