> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyshift.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Integration

> Bring Annie directly into Slack: ask questions, get automatic root cause analysis, and collaborate on incidents where your team already works.

Annie is your infrastructure copilot, available directly in Slack. Ask questions about your cloud resources, get automatic incident analysis when alerts fire, and keep your team in the loop, all without leaving the conversation.

## Installation

<Steps>
  <Step title="Open Integrations">
    Go to **Integrations → Slack** on the [Slack Integrations page](https://app.anyshift.io/integrations/messaging/slack).
  </Step>

  <Step title="Install the Slack app">
    Click **Install Slack App**, then authorize Annie in your workspace.
  </Step>

  <Step title="Invite Annie to channels">
    Annie discovers the channels it's added to. Invite it wherever you'd like it available.
  </Step>

  <Step title="Map channels to projects">
    Assign each channel one Anyshift [project](/pages/product/project_management/overview) so Annie knows which integrations and knowledge to use.
  </Step>
</Steps>

<Accordion icon="diagram-project" title="Multiproject & switching channels">
  If your organization runs multiple projects, assign one project per channel: Annie prompts users in Slack, or you set it from the Anyshift UI. Use `/switch-project` to change a channel's project directly in Slack. You can also connect multiple Slack workspaces to a single Anyshift organization.
</Accordion>

## What you can do

<AccordionGroup>
  <Accordion icon="comments" title="Ask infrastructure questions">
    Mention **@Annie** in any mapped channel to ask about cloud resources, Terraform, dependencies, and more. Annie answers in a thread, drawing on the integrations connected to that channel's project.
  </Accordion>

  <Accordion icon="bolt" title="Automatic root cause analysis">
    When a monitoring bot (Datadog, PagerDuty, etc.) posts an alert in a channel where Annie is registered on-call, Annie investigates and posts a threaded analysis: a summary, a timeline of related changes, the likely root cause, and recommended fixes. See [Root Cause Analysis](/pages/product/root_cause_analysis).
  </Accordion>

  <Accordion icon="spinner" title="Live progress updates">
    While Annie investigates, it posts real-time progress in the thread so your team can follow along without waiting for the final analysis.
  </Accordion>

  <Accordion icon="sliders" title="Customize Annie per project">
    Tailor Annie's responses with [Automation](/pages/product/customization/instructions) rules, and use its **Slack identities** list to choose which users and bots Annie auto-processes vs. only answers when tagged. Keep Annie in focused channels (for example `#infra-alerts`) for a high signal-to-noise ratio.
  </Accordion>
</AccordionGroup>

## Register on-call bots

For Annie to investigate alerts automatically, register your monitoring bots (Datadog, PagerDuty, etc.) from any channel where Annie is present:

```bash theme={null}
/register_annie_on_call <slack_id>
```

<Accordion icon="bell" title="Other ways to register a bot">
  The Slack ID can be a user (`U01234ABCDE`), bot (`B01234ABCDE`), or user group (`S01234ABCDE`). To find one, click the profile picture → **⋮** → **Copy member ID**.

  * **Reply in a thread:** post **@Annie listen** under any bot's message and Annie resolves the bot automatically.
  * **In the app:** add it to the **Annie On-Call Registry** on the [Slack Configuration page](https://app.anyshift.io/integrations/messaging/slack).

  Only Organization and Project Admins can register bots (see [Permissions](#permissions)).
</Accordion>

## Other settings

The rest lives on the [Slack Configuration page](https://app.anyshift.io/integrations/messaging/slack), which manages channels, the on-call registry, on-call engineers, and report delivery per workspace.

<AccordionGroup>
  <Accordion icon="user-group" title="On-call engineers">
    In the **On-Call Engineers** section, set who Annie should tag per project when it detects an incident.
  </Accordion>

  <Accordion icon="link" title="Connect your account">
    Link your Slack identity to your [Anyshift account](https://app.anyshift.io/) for personalized responses and access control. Annie prompts you to connect the first time you interact with it.
  </Accordion>
</AccordionGroup>

## Reports & insights

Annie pushes [proactive](/pages/product/proactive_annie) and [custom](/pages/product/reports) reports into Slack: to a shared channel, to DMs with each project member, or both. Each report keeps its context, so any thread reply continues the discussion with Annie.

<AccordionGroup>
  <Accordion icon="sliders" title="Choose where reports go">
    On the [Slack Integrations page](https://app.anyshift.io/integrations/messaging/slack), in your project's **Insights** section:

    * **Send via DM** *(default: on):* every member who linked their Slack account gets the report in a DM.
    * **Post to a channel** *(default: off):* pick a channel Annie is in; the report posts with vote buttons and a "View Full Report" link.

    Both can be on at once.
  </Accordion>

  <Accordion icon="envelope" title="Get reports in your DMs">
    Link your Slack account once: DM **@Annie** anything to get a one-time link, click it, and sign in. You'll then appear as Slack-mapped in your project, and Annie DMs you each new report. Link once per workspace.
  </Accordion>

  <Accordion icon="thumbs-up" title="Vote on findings">
    Each proactive finding has **Relevant** and **Ignore** buttons. Votes save against the finding, update every Slack copy (channel post and DMs), and stay in sync with the Anyshift UI. Custom reports use the **View Full Report** link and thread replies instead.
  </Accordion>

  <Accordion icon="comments" title="Continue in a thread">
    Reply in any pushed report's thread. Annie opens a chat tied to that report's session, so it already knows the findings, timeline, and integrations without re-pasting context.
  </Accordion>
</AccordionGroup>

## Permissions

Only **Organization** and **Project Admins** can register bots, remap a channel's project, or set on-call engineers. Everyone else can ask questions and view results. See [Roles & Permissions](/pages/product/project_management/roles).

## Privacy & security

<AccordionGroup>
  <Accordion icon="shield-halved" title="What Annie can access">
    Annie only reads channels it's explicitly added to, and only data from the mapped project's connected integrations. Remove it from a channel, or uninstall the app, to revoke access immediately.
  </Accordion>

  <Accordion icon="lock" title="How data is secured">
    Workspace tokens are encrypted at rest, and every Slack-to-Anyshift request is verified with Slack's signing secret.
  </Accordion>
</AccordionGroup>

## Get Started

<CardGroup cols={2}>
  <Card title="Open Anyshift" icon="rocket" href="https://app.anyshift.io/integrations/messaging/slack">
    Install the Slack app and start using Annie in your workspace.
  </Card>

  <Card title="Book a Demo" icon="calendar" href="https://calendly.com/anyshift">
    See Annie in action with a personalized walkthrough from our team.
  </Card>
</CardGroup>