Slack Installation

alice needs to be installed as a Slack app in your workspace before you can use slash commands, receive reports, or interact with action buttons. The process is quick and uses standard Slack OAuth.

Installation Methods

There are two ways to install the alice Slack bot:

During Onboarding

When you first sign up with Slack, the onboarding flow prompts you to install the bot immediately after creating your workspace. This is the recommended path since it gets everything connected in one go.

From Settings

If you skipped the onboarding step or need to reinstall, go to Dashboard > Settings > Workspace. The Slack connection section shows your current status and provides an Add to Slack button.

Installation Steps

1. Click the Add to Slack button from either onboarding or Settings
2. Slack opens an authorization screen showing the permissions alice requests
3. Review the scopes and click Allow
4. You are redirected back to alice with a confirmation that the bot is connected
5. The /alice slash command is now available in your workspace

The entire process takes less than a minute. You do not need to configure webhook URLs, event subscriptions, or slash command endpoints manually -- alice handles all of that.

Permissions Requested

alice requests a minimal set of Slack OAuth scopes. Here is exactly what the bot can and cannot do:

What alice can do

What alice cannot do

• Read your message history or private conversations
• Access files shared in channels
• Modify channel settings or membership
• Send messages as another user
• Access any data outside of explicit skill executions

alice follows the principle of least privilege. The bot only has access to what it needs to deliver skill results and handle interactions.

After Installation

Once the bot is installed, verify everything is working:

Test the slash command

Open any channel in your Slack workspace and type:

/alice help

You should see a list of your available skills. If you have not created any skills yet, the response will show built-in commands and a prompt to create your first skill.

Invite the bot to channels

For scheduled reports to deliver to a specific channel, alice must be a member of that channel. In the target channel, type:

/invite @alice

For ephemeral responses (the default response type), the bot does not need to be in the channel -- Slack handles ephemeral delivery differently.

Verify the connection

Go to Dashboard > Settings > Workspace to see the connected Slack workspace name and status indicator. A green status means the bot token is valid and the connection is active.

Multiple Workspaces

Each alice workspace maps to exactly one Slack workspace via the slack_team_id. If your organization uses multiple Slack workspaces, you will need a separate alice workspace for each one.

The first person from a Slack workspace to sign up becomes the owner. Subsequent people from the same workspace are automatically added as members -- no invite flow needed. See Members & Roles for details on how team access works.

Reinstalling the Bot

If the Slack connection is broken (for example, after revoking the app in Slack's admin panel), you can reinstall from Dashboard > Settings > Workspace. Click Reconnect Slack to go through the OAuth flow again. Your skills, sources, and settings are preserved -- only the bot token is refreshed.

Uninstalling the Bot

To remove alice from your Slack workspace:

1. Go to your Slack workspace's Settings & administration > Manage apps
2. Find alice in the installed apps list
3. Click Remove

This revokes the bot token and disables all slash commands and scheduled reports. Your alice workspace, skills, and data remain intact -- you can reinstall at any time to restore functionality.

Alternatively, the workspace owner can delete the entire workspace from alice's Settings if you want to remove everything permanently.

Troubleshooting

The bot does not respond to slash commands

1. Confirm alice is installed: check Dashboard > Settings > Workspace for a green connection status
2. Ensure alice is invited to the channel: type /invite @alice in the channel
3. Verify you have at least one connected source -- skills need a data source to query
4. Check that the skill you are trying to run exists: go to Dashboard > Skills to see your skill list

Authorization fails during installation

• Make sure you have permission to install apps in your Slack workspace. Some workspaces require admin approval for new apps.
• If your workspace uses Slack Enterprise Grid, ask your IT team to approve the alice app.
• Try clearing your browser cookies and starting the OAuth flow again.

Scheduled reports are not delivering

• The bot must be a member of the target channel. Use /invite @alice in that channel.
• Check that the scheduled report is active (not paused) in Dashboard > Skills.
• Verify your plan supports the schedule frequency you configured. The Free plan only allows one weekly report.

Commands show "This app is not available"

This typically means the bot was uninstalled from Slack's side. Go to Dashboard > Settings > Workspace and click Reconnect Slack to reinstall.

Next Steps

• Slash Commands -- Full command reference and examples
• Quickstart -- Complete setup from signup to first query
• Connect Stripe -- Add Stripe as a data source
• Connect Supabase -- Add Supabase as a data source
• Scheduled Reports -- Set up automatic delivery