Slack Integration

Connect Slack so your team can mention @vuon to request help directly in chat. This guide covers installation, required permissions, and how to use the integration.

Get started

Installation

Open the Vuon Admin panel.
Go to Integrations → Slack.
Click Connect Slack and approve the Vuon app for your workspace.
Pick the default Slack channel for integration updates.
Save the integration.

Required Slack permissions

Vuon requests Slack permissions so it can read thread context and respond with updates.

app_mentions:read
chat:write
channels:read
channels:history
groups:read
groups:history
im:read
im:history
mpim:read
mpim:history
team:read

How to use

Mention @vuon and give your prompt. This handles most use cases, but you can also use commands below to guide the agent.

For example, mention @vuon fix the login bug directly in a conversation, or use specific commands like @vuon [repo=vuon/warehouse] fix the ingest bug to target a repository.

Commands

Run @vuon help for an up-to-date command list.

Command	Description
`@vuon [prompt]`	Start an agent. In threads with existing agents, adds follow-up instructions.

Troubleshooting

@vuon does not respond

If @vuon does not respond, confirm the app is installed in the workspace. Go to your Slack workspace settings and verify the Vuon app is listed under installed apps.

Missing permissions errors

If you see missing permissions errors, reinstall the app after updating scopes. Go to the Vuon Admin panel → Integrations → Slack and click Reconnect.

Updates post to the wrong channel

If updates post to the wrong channel, confirm the default channel in Admin → Integrations → Slack. You can change the default channel at any time.

FAQ

Can I use Vuon in private channels?

Yes, Vuon can be used in private channels. You'll need to invite the @vuon bot to the private channel first by typing /invite @vuon.

Can I use Vuon in direct messages?

Yes, you can mention @vuon in direct messages and group DMs. The bot will respond in the same thread.

How do I remove the Slack integration?

To remove the integration, go to Admin → Integrations → Slack and click Disconnect. This will remove the bot from your workspace.