- An Organization Admin connects Omni to your Slack workspace. This only needs to happen once, and it sets up both the Omni Slack Agent and scheduled Slack deliveries.
- Anyone who wants to chat with the agent links their own Slack account to Omni.
Connecting your Omni organization
To connect your Omni organization to Slack, you’ll need:- The following in Slack:
- An existing Slack workspace
- Permissions to install apps
- The following in Omni:
- Organization Admin permissions
- AI features enabled
- At least one topic configured in a model
Connect your Slack workspace
- In Omni, navigate to Settings > Integrations.
- In the Slack tab, click Connect to Slack.
- Complete the Slack authorization flow.
Configure the agent's settings
Before your team starts using the agent, review its settings in the Slack tab. You can set the default model the agent uses and choose whether its channel responses are private. See Omni Slack Agent settings for more information.
Introduce the agent to your team
To help your team discover the Omni Slack Agent, use the workflow in the welcome message to let the agent introduce itself in a public channel. The welcome message includes a preview of the introduction.
Introducing the Omni Slack Agent in a public channel is the best way to drive broad awareness and encourage your team to connect their accounts and start asking questions.
Connecting your Omni account
This section applies to all users. Every user who wants to interact with the Omni Slack Agent must connect their Omni account.
- Send a message to the Omni Slack Agent, either in a DM or a channel that Omni is a member of.
- Click the Connect account button in the agent’s reply.
- Follow the prompts to link your Slack identity to your Omni account.
Managing Slack
Organization Admins can configure the Omni Slack Agent, reconnect or disconnect the integration, and upgrade scopes in Settings > Integrations > Slack. See Omni Slack Agent settings for details.Troubleshooting
Agent doesn't respond to DMs
Agent doesn't respond to DMs
If the agent doesn’t respond to direct messages, the
im:history scope may not have been granted during setup. DMs can’t reach the agent without this scope.If this happens, use /omni ask instead.Received an info message after clicking Connect account
Received an info message after clicking Connect account
If you receive an info message after clicking the Connect account button, an Organization Admin may have turned the Omni Slack Agent off after the agent sent you the button. You won’t be able to link your account until the agent is turned on again.

