alicehasnoidea/docs
WebsiteLog inGet Started Free
Slack Integration

Slack Integration

Run skills, receive reports, and take actions directly from Slack with alice's bot integration

Slack Integration

alice is designed to live where your team already works. Rather than switching between dashboards, spreadsheets, and Stripe tabs, you run a single slash command and get structured results with actionable buttons right in your Slack workspace.

What You Can Do in Slack

Run Skills on Demand

Every skill you create becomes a /alice subcommand. Type /alice mrr and get your monthly recurring revenue breakdown. Add flags like --days=30 to pass parameters dynamically. Results arrive within seconds, formatted for easy scanning.

Receive Scheduled Reports

Set up scheduled reports to deliver skill results to any channel on a cron schedule. Your daily metrics can land in #ops at 9am every weekday without anyone lifting a finger.

Take Actions from Results

When a skill returns actionable data -- like a list of at-risk customers -- action buttons appear below each result. One click to tag a customer in Stripe, send a Slack DM to a teammate, or fire a webhook. No context-switching required.

Control Who Sees What

Skill results default to ephemeral messages visible only to the person who ran the command. Use the --channel flag to share results with everyone in the channel.

How It Works

The flow from command to result follows a straightforward pattern:

  1. You type a command -- /alice churn-risk --days=60
  2. Slack sends the request to alice's API endpoint
  3. alice responds immediately with a "Running..." indicator (within Slack's 3-second timeout)
  4. The skill executes asynchronously -- querying your connected Stripe or Supabase data
  5. Results post back to the conversation via Slack's response_url, complete with formatted output and action buttons
  6. You interact with the result -- click an action button, and alice executes it and updates the message with a confirmation

This asynchronous pattern means even complex combined queries that join data across multiple sources never time out.

The Skill Picker Modal

If you type /alice with no subcommand, alice opens a modal picker in Slack. The modal displays a dropdown of all your available skills with dynamic parameter inputs -- date pickers, checkboxes, text fields, and dropdowns -- that match the parameter types defined in each skill.

This is especially useful when you cannot remember the exact skill name or want to fill in parameters visually rather than typing flags.

Sections in This Guide

PageWhat It Covers
InstallationAdding alice to your workspace, permissions, and troubleshooting
Slash CommandsFull command reference, built-in commands, flags, and examples
Action ButtonsInteractive buttons on results, available actions, and idempotency
Response TypesEphemeral vs in-channel messages, permissions, and scheduled report delivery

Prerequisites

Before using alice in Slack, you need:

  • A Slack workspace where you can install apps (requires workspace admin approval in some cases)
  • An alice account -- sign up with Slack to create your workspace
  • At least one connected data source (Stripe or Supabase)
  • At least one skill configured, or use a template to get started quickly

Next Steps

Was this page helpful?

On this page