> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruby.ad/llms.txt
> Use this file to discover all available pages before exploring further.

# Ruby in Slack

> Call your Ruby agents from Slack channels, threads, and direct messages.

With the Ruby app for Slack, members can call agents without leaving Slack: mention **@Ruby** in a channel or thread, or send the app a direct message. The agent replies in a thread.

## Set up the Ruby app (admins)

A workspace admin enables the app once for the whole workspace:

1. In Ruby, go to **Admin** > **Integrations**.
2. Turn on **Slack Bot**.
3. Follow the Slack authorization flow to install the Ruby app in your Slack workspace.

The Slack Bot is separate from the [Slack connection](https://docs.ruby.ad/docs/user-documentation/admins/connections-management/slack.md), which syncs Slack channels into Ruby as company data, and from the [Slack tools](https://docs.ruby.ad/docs/user-documentation/agents/tools/slack-tools.md), which let agents search and post in Slack.

## Call an agent

Mention **@Ruby**, followed by your request. To pick a specific agent, add **+** and its name right after the mention (**\~** works too):

* `@Ruby What were the key decisions in this thread?`
* `@Ruby +SupportExpert How do I reset my password?`

Good to know:

* You can call one agent per message.
* Without an agent name, the channel's default agent answers if an admin has set one (see below). Otherwise, the **@ruby** agent answers, or another default agent if @ruby is turned off in your workspace.
* In a direct message with the Ruby app, you don't need the @Ruby mention. Write your request, optionally starting with **+** and the agent's name.

## Set up channels

* **Default agent for a channel**: admins can link an agent to channels from the agent's **Slack Channel Settings**, so @Ruby mentions there go to that agent. The agent can also answer every message in the channel without a mention. See [Slack Auto-Reply without @mention](https://docs.ruby.ad/docs/user-documentation/agents/integrations/ruby-in-slack/slack-auto-reply.md).
* **Slack workflows**: run agents from Slack Workflow Builder, for example when someone adds an emoji reaction. See [Slack workflows](https://docs.ruby.ad/docs/user-documentation/agents/integrations/ruby-in-slack/slack-workflows.md).
* **Auto-join (beta)**: automatically sync new public channels that match a pattern into the Slack connection. See [Slack Auto-Join](https://docs.ruby.ad/docs/user-documentation/agents/integrations/ruby-in-slack/slack-auto-join.md).

If something doesn't work as expected, see [Slack troubleshooting](https://docs.ruby.ad/docs/user-documentation/admins/admin-troubleshooting/slack-troubleshooting.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.