Installation
Open Integrations
Navigate to Anyshift → Integrations → Slack from the Slack Integrations page.
Install the Slack App
Click Install Slack App. You’ll be redirected to Slack to authorize Annie in your workspace. Select your workspace and approve the requested permissions.
Discover Channels
Once installed, Annie automatically discovers channels it’s been added to. Invite Annie to any channel where you’d like it available.
Map Channels to Projects
If your Anyshift organization is multiproject, you’ll need to assign Annie one project per channel.
It will prompt users in Slack to set this, or you can assign each Slack channel to one of your projects from the Anyshift UI.
This tells Annie which integrations and knowledge to use when answering questions in that channel.
You can also use the
/switch-project command to change a channel’s project directly in Slack.What You Can Do
Ask Infrastructure Questions
Mention @Annie in any mapped channel to ask questions about your cloud resources, Terraform configurations, dependencies, and more. Annie responds in a thread with answers drawn from the integrations connected to that channel’s project.Automatic Root Cause Analysis
When a monitoring bot (Datadog, PagerDuty, etc.) posts an alert in a channel where Annie is registered on-call, it automatically investigates and posts a threaded analysis including:- A summary of the incident
- A timeline of related changes
- The likely root cause
- Recommended remediation steps
Register On-Call Bots
Tell Annie which monitoring bots to watch so it can automatically pick up and analyze their alerts. There are three ways to register a bot:Slash command in a channel
Slash command in a channel
Use
/register_annie_on_call <slack_id> in any Slack channel where Annie is present. The Slack ID can be a user ID (e.g., U01234ABCDE), bot ID (B01234ABCDE), or user group ID (S01234ABCDE). To find a user or bot ID, click their profile picture → ⋮ → Copy member ID.Reply in a thread
Reply in a thread
From the Anyshift UI
From the Anyshift UI
Go to the Slack Integrations page and add entries to the Annie On-Call Registry section. Annie validates the Slack ID before registering it.
Set On-Call Engineers
Define which team members are on-call for each project so Annie can tag them when incidents are detected.Live Progress Updates
While Annie investigates an incident, it posts real-time progress updates in the thread so your team can follow along without waiting for the final analysis.Connect Your Account
Link your Slack identity to your Anyshift account for personalized responses and proper access control. Annie will prompt you to connect when you first interact with it.Managing Channels
- Map Slack channels to Anyshift projects from the Slack Integrations page
- When Annie joins a new channel, it appears as Unassigned — assign it to a project to enable Annie’s full capabilities
- Each channel maps to exactly one project, so Annie knows which integrations and knowledge to use
- Multiple Slack workspaces can be connected to a single organization
Permissions & Access Control
Only Organization Admins and Project Admins can:- Register bots in the on-call registry (
/register_annie_on_callor@Annie listen) - Change which Anyshift project a channel is mapped to
- Configure on-call engineer assignments
Privacy & Security
- Annie only reads messages in channels where it’s explicitly added
- Messages are processed in the context of the mapped project’s integrations — Annie only accesses data your team has connected
- Workspace tokens are encrypted at rest
- All communication between Slack and Anyshift is verified using Slack’s signing secret to ensure request authenticity
- You can remove Annie from any channel at any time to stop monitoring
- Uninstalling the Slack app immediately revokes all access
Tips & Best Practices
Map incident channels to the right project
Map incident channels to the right project
Annie uses the channel’s project mapping to determine which integrations to query. Accurate mapping means more relevant RCA results.
Register your monitoring bots
Register your monitoring bots
Use
/register_annie_on_call for bots like Datadog and PagerDuty so Annie can automatically investigate alerts as they come in.Use dedicated channels
Use dedicated channels
Keep Annie in focused channels (e.g.,
#infra-alerts, #prod-incidents) to maintain a high signal-to-noise ratio.Customize Annie's behavior
Customize Annie's behavior
Tailor Annie’s responses per project using Annie Instructions — for example, to focus on specific services or follow your team’s runbook conventions.