Skip to main content

​
Prerequisites

Before installing the Slack integration, make sure you have:
  • A Vigilos account with admin or owner role in your organization
  • Admin access to the Slack workspace where you want to install the app
  • At least one database connection and semantic model configured in Vigilos

​
Installing the App

1

Open the Integrations page

Navigate to Integrations in the Vigilos sidebar and click Connect Slack.
2

Authorize with Slack

You will be redirected to Slack’s OAuth authorization page. Review the permissions being requested, select the workspace where you want to install the app, and click Allow.
3

Confirm the connection

After authorization, you will be redirected back to Vigilos. The Slack integration will appear with an Active status, showing the connected workspace name.
The OAuth flow creates a bot user in your Slack workspace. This bot user is how Vigilos sends and receives messages. Your personal Slack credentials are never stored by Vigilos.

​
What Gets Installed

When you authorize the Vigilos Slack app, the following are set up in your workspace:
  • Bot user - A @Vigilos bot user that can receive mentions and post responses
  • Bot token - An encrypted token that allows the bot to read messages where it is mentioned and post replies
  • Scoped permissions - The bot requests only the permissions it needs for messaging and channel access

​
User Linking

Vigilos automatically links Slack users to Vigilos accounts by matching email addresses. When a Slack user mentions @Vigilos, the bot looks up their Slack profile email and matches it to a Vigilos user in the same organization.
If a Slack user’s email does not match any Vigilos account in the connected organization, they will not be able to use the bot. Make sure team members use the same email address for both Slack and Vigilos.

​
Channel Configuration

The Vigilos bot can respond in any channel where it has been invited. To use the bot in a channel:
  1. Invite the bot to the channel by typing /invite @Vigilos or mentioning @Vigilos
  2. The bot will respond to mentions in that channel going forward
The bot can also respond in direct messages and private channels, as long as it has been added to them.

​
Connection Status

Your Slack integration can have one of three statuses:
StatusMeaningAction
ActiveConnected and operationalNo action needed
InactivePaused or temporarily unavailableCheck the integration settings
RevokedAccess has been revoked from Slack or VigilosReconnect the integration

​
Disconnecting

To disconnect the Slack integration:
  1. Navigate to Integrations in the Vigilos sidebar
  2. Find the Slack integration and click Disconnect
  3. Confirm the disconnection
This revokes the bot token and removes the connection from Vigilos. The bot user will remain in your Slack workspace but will no longer respond to messages. You can also revoke access from Slack’s app management settings at Slack > Settings > Manage Apps.
If you want to temporarily stop the bot without fully disconnecting, you can set the integration status to Inactive instead.