Skip to main content
Getting Omni into Slack has two steps:
  1. 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.
  2. 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:
1

Connect your Slack workspace

  1. In Omni, navigate to Settings > Integrations.
  2. In the Slack tab, click Connect to Slack.
  3. Complete the Slack authorization flow.
You’ll be redirected back to Omni once the connection is established. Admins receive a welcome message in Slack confirming the integration is active.
Already connected for deliveries? If your Slack workspace is already connected for scheduled deliveries, you’ll see an option to upgrade the connection with additional permissions required by the Omni Slack Agent. Click Reconnect to authorize the expanded permissions.
2

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.
3

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.
Before you can use the Omni Slack Agent, you’ll need to link your Slack account to your Omni account:
  1. Send a message to the Omni Slack Agent, either in a DM or a channel that Omni is a member of.
  2. Click the Connect account button in the agent’s reply.
  3. Follow the prompts to link your Slack identity to your Omni account.
After you connect, you’ll receive confirmation and welcome messages. The agent will also reply to your original question. See Interacting with the Omni Slack Agent for more information on using the agent.

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

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.
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.