> ## Documentation Index > Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt > Use this file to discover all available pages before exploring further. # Deploy an agent as a Slack app > Deploy an AI agent as its own Slack app with the agent's name and image, so people can DM it and it answers in the Slack channels connected to its channels. Deploy an agent (AI agents with rules, knowledge, and tools that handle requests for your team) as its own Slack app, and it shows up in Slack as itself: its own name, its own image, and its own DM. People message the agent directly, and it takes over the Slack channels connected to the Ravenna channels it's assigned to. You can deploy as many agents as you like. Each one becomes its own Slack app, and Ravenna installs it in every connected workspace of your Slack organization. Agent Slack apps are in alpha and available to selected organizations. To request access, contact your Ravenna representative, or reach out to the Ravenna team on Slack or through the in-app chat. Testing them? See the [alpha tester guide](https://docs.ravenna.ai/documentation/automate/agents/slack-app-beta). > [!NOTE] > > Deploy from the agent's **Connections** tab, in the **Slack** section. Organization admins connect the Slack admin access the deploy needs. *** ## Before you start * Connect Slack to Ravenna. See [Slack setup](https://docs.ravenna.ai/integrations/slack/setup.md). * Give the agent a name, description, and image on its **Identity** tab. The Slack app uses them. Slack shows the image as the app icon when it's a PNG, JPG, or GIF. * Assign the agent to the Ravenna channels it should answer in. See [Connections](https://docs.ravenna.ai/documentation/automate/agents/deploy-monitor.md#connections). *** ## Connect privileged access Ravenna creates and installs agent apps with Slack's app management permission, so each Slack organization needs privileged access with **App management** granted first. **1. Open the agent's Slack section** Go to **Agents**, open the agent, and select the **Connections** tab. Each Slack workspace, or each Enterprise Grid organization with its workspaces nested under it, appears as a card in the **Slack** section. **2. Connect privileged access** On a card that shows **Needs Slack admin approval to deploy**, click **Connect privileged access**. Only organization admins see this button. Everyone else sees **Missing Slack admin access** and asks an organization admin to connect it. **3. Grant App management** Ravenna sends you to Slack, where a Slack admin authorizes **App management** and returns you to Ravenna. > [!TIP] > > Privileged access belongs to the Slack organization, so every agent deployed there shares it. Connect it once, from any agent. *** ## Deploy the agent **1. Open the agent's Slack section** Go to **Agents**, open the agent, and select the **Connections** tab. **2. Deploy** In the **Slack** section, click **Deploy**. Ravenna confirms that the agent is now live in Slack. Deploying runs for each Slack organization with **App management** access: 1. Ravenna creates the agent's app in the Slack organization, with the agent's name, description, and image. 2. Ravenna installs the app's bot in every connected workspace of that organization. 3. Ravenna creates a Ravenna channel for the agent's DMs, named after the agent, with the agent's image in the sidebar. A redeploy reuses it. 4. The Ravenna app adds the agent's bot to every Slack channel connected to the Ravenna channels the agent is assigned to, and the agent's bot takes those channels over. Workspaces that join your Enterprise Grid organization later get the agent's app installed automatically. ### Deployment statuses Each workspace card shows the install date and these statuses: | Status | Meaning | | - | - | | Pending | Ravenna is installing the app in this workspace. | | Installed | The agent's app is installed in this workspace. | | Install failed | The install failed. Hover over the status to see why. | | Outdated | The bot's Slack permissions in this workspace are behind the app's. Click **Update app** to reinstall it. | If the agent's bot misses some Slack channels, the card names them: **Couldn't add the agent to #it-help. Invite the Ravenna app there, the agent joins on the next sync**. *** ## What changes in Slack Ravenna sends each Slack message to one bot, in this order: 1. A thread stays with the bot that started it. 2. A Slack channel connected to a Ravenna channel the agent is assigned to goes to the agent's bot. 3. Everything else goes to the app that handles tickets in that workspace. For people in Slack, that means: * They DM the agent's app directly, and those conversations land in the agent's channel in Ravenna. * The agent answers in its Slack channels as itself, with its own name and image. * Ravenna keeps the agent's channels in sync. Assign the agent to a channel, or connect a Slack channel to one of its channels, and the agent's bot joins. Unassign the agent or disconnect the Slack channel, and the bot leaves and the main app takes the channel back. * If someone removes the agent's bot from a Slack channel, the bot rejoins on the next sync while the agent is still assigned. Learn more about [Slack direct messages](https://docs.ravenna.ai/integrations/slack/direct-messages.md) *** ## Update the agent's app Ravenna pushes a new agent name or image to its Slack apps when you save it on **Identity**. After other changes, such as a new description, click **Update app** in the **Slack** section. **Update app** also reinstalls the bot where it's Outdated. *** ## Remove the agent from Slack **1. Open the agent's Slack section** Go to **Agents**, open the agent, and select the **Connections** tab. **2. Deprovision** In the **Slack** section, click **Deprovision**. **3. Confirm** In **Remove from Slack**, type the agent's name and click **Deprovision**. Ravenna deletes the agent's app in every connected Slack organization. Its Slack channels go back to the main app, and its open DMs end. The agent's Ravenna channel and its tickets stay. Deploy again to create a new app. Deleting the agent also removes its Slack apps. ## Related topics - [Agent apps](https://docs.ravenna.ai/integrations/slack/agent-apps.md) - [Agents](https://docs.ravenna.ai/documentation/automate/agents/overview.md) - [Custom Branded Service Desk App](https://docs.ravenna.ai/integrations/slack/branded-app.md) - [Deploy & monitor](https://docs.ravenna.ai/documentation/automate/agents/deploy-monitor.md) - [Slack direct messages](https://docs.ravenna.ai/integrations/slack/direct-messages.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.