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

# Slack Integration

> Run CloudThinker AI operations directly from Slack — manage infrastructure, review costs, and investigate incidents without leaving your workspace

Transform your Slack workspace into a cloud operations command center. Interact with CloudThinker agents, receive alerts, and run operations without leaving Slack.

<Note>
  **[VibeOps](/guide/tutorial/vibeops) vs SlackOps**: VibeOps is the conversational approach to cloud operations — the broader paradigm of talking to AI agents in natural language. SlackOps is how you do VibeOps *inside Slack*. The same `@agent #tool` syntax works identically in both the CloudThinker web app and Slack.
</Note>

***

## The Problem With Context Switching

When an alert fires, engineers context-switch through 5+ tools: acknowledge in PagerDuty → open AWS console → check CloudWatch → pull up kubectl → open Datadog. By the time they have a full picture, 20 minutes have passed and the team is asking for updates in Slack — the one place everyone already is.

Even routine operations require context switching: checking costs means opening Cost Explorer, checking security findings means opening Security Hub, checking Kubernetes means opening Lens or running kubectl commands.

***

## How SlackOps Is Different

| Scenario                  | Traditional Approach                                                           | CloudThinker SlackOps                                               |
| ------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------- |
| **Alert fires at 3 AM**   | Page → open AWS Console → CloudWatch → correlate manually                      | `@CloudThinker alex investigate the spike in errors` in #incidents  |
| **Cost check**            | Open browser → navigate to Cost Explorer → build filter                        | `@CloudThinker alex what's our AWS spend this week?`                |
| **Security audit**        | Open Security Hub → filter findings → export report                            | `@CloudThinker oliver any critical security findings?`              |
| **Incident coordination** | Multiple engineers in different dashboards, status updates via manual messages | `@CloudThinker anna coordinate investigation: @alex @tony @kai`     |
| **Team alerts**           | Configure PagerDuty/OpsGenie routing rules                                     | `@CloudThinker kai #alert pod failures in production → #k8s-alerts` |

SlackOps works because it meets engineers where they already are — and because it provides the full intelligence of CloudThinker agents, not just [notifications](/guide/notifications).

***

## Setup

<Info>
  By default, any Slack workspace member can install apps. If your workspace has **App Approval** enabled, a Workspace Owner or app manager must approve CloudThinker before it can be installed.
</Info>

<Steps>
  <Step title="Navigate to Integrations">
    Go to [**Admin Settings → Integrations**](https://app.cloudthinker.io/admin-settings/integrations) and find **Slack**
  </Step>

  <Step title="Connect with Slack">
    Click **Add to Slack** and authorize via Slack's OAuth flow.

    <Info>
      If your workspace has **App Approval** enabled, CloudThinker must be approved
      by a Workspace Owner or app manager before you can complete this step. If the
      app hasn't been approved yet, you'll be prompted to submit a request.
    </Info>
  </Step>

  <Step title="Install the App">
    Select which Slack workspace to install CloudThinker into and confirm the
    OAuth scopes. The app will appear in your workspace's app directory.
  </Step>

  <Step title="Map Channels to Workspaces">
    Map your Slack channels to CloudThinker workspaces so agents know which cloud
    accounts to operate on
  </Step>

  <Step title="Configure Notifications">
    Optionally select channels for each notification type (cost alerts, security
    findings, incident updates)
  </Step>

  <Step title="Test">
    Try `@CloudThinker alex show AWS costs` in a channel to verify the connection
  </Step>
</Steps>

***

## Syntax

In Slack, prefix all commands with `@CloudThinker`:

```bash theme={null}
@CloudThinker alex analyze EC2 spending trends
@CloudThinker oliver audit security groups for public access
@CloudThinker tony check database performance
@CloudThinker kai review EKS cluster health
```

All [CloudThinker Language](/guide/language) syntax works in Slack—just add the `@CloudThinker` prefix.

***

## Examples

### Quick Queries

```bash theme={null}
@CloudThinker alex what's our AWS spending this week?
@CloudThinker oliver any critical security findings?
@CloudThinker tony why are queries slow on production?
@CloudThinker kai check pod status in payment namespace
```

### With Tools

```bash theme={null}
@CloudThinker alex #dashboard cost trends by service
@CloudThinker oliver #report weekly security summary
@CloudThinker tony #recommend index optimizations
@CloudThinker kai #alert on pod OOMKilled events
```

### Multi-Agent

```bash theme={null}
@CloudThinker anna coordinate investigation of latency spike
@CloudThinker alex and tony analyze database infrastructure costs
```

***

## Alerts

Configure agents to send alerts to Slack channels:

```bash theme={null}
@CloudThinker alex #alert daily spend exceeds $5,000 → #cloud-ops
@CloudThinker oliver #alert security group changes → #security
@CloudThinker kai #alert pod failures in production → #k8s-alerts
```

***

## Code Review Notifications

When an AI code review completes on a connected repository, CloudThinker can send a summary notification to your Slack channels. These notifications use Block Kit formatting with:

* **Severity indicators** — color-coded emoji for each severity level (🔴 Critical, 🟠 High, 🟡 Medium, 🟢 Low)
* **Severity breakdown** — count of findings by severity
* **Finding details** — up to 5 unresolved findings with title, file path, and line number
* **Resolved count** — number of previously identified findings that have been resolved
* **View Code Review** button — direct link to the review dashboard
* **Clean pass** — when no issues are found, a simple "No issues found" message

<Info>
  Configure which Slack channel receives code review notifications and set severity thresholds in **Settings > Notifications > Code Review / Pipeline Monitoring**. See [Notifications Center](/guide/notifications) for details.
</Info>

***

## Channel Patterns

| Channel         | Use Case                                          |
| --------------- | ------------------------------------------------- |
| `#cloud-ops`    | General infrastructure operations and cost alerts |
| `#security`     | Security findings and compliance updates          |
| `#incidents`    | Active incident investigation and coordination    |
| `#code-reviews` | Code review findings and pipeline monitoring      |
| `#reports`      | Scheduled reports and summaries                   |

***

## Troubleshooting

<Accordion title="Agents not responding">
  * Check if CloudThinker app is added to the channel
  * Verify you're using `@CloudThinker agent` syntax (not just `agent`)
  * Confirm agents are configured in the CloudThinker console
  * Check Slack workspace admin consent status
</Accordion>

<Accordion title="Missing alerts">
  * Check alert configuration in CloudThinker Settings
  * Verify Slack channel notification settings
  * Ensure the bot has permission to post in the target channel
  * Test with `/cloudthinker alerts test`
</Accordion>

<Accordion title="Permission errors">
  * **"Missing required scopes"** — The app may have been installed without all required OAuth scopes. Remove the app from the workspace and reinstall it from CloudThinker's Integrations page.
  * **Connection appears successful but bot doesn't respond** — This can happen if the OAuth flow did not complete fully. Try removing and reinstalling the app.
  * **"not\_allowed\_token\_type" or scope errors** — Your Slack workspace may have App Approval enabled. Ask your Workspace Owner or app manager to approve CloudThinker in Slack's admin dashboard under **Manage Apps**.
  * For any other permission errors, check workspace permissions in CloudThinker, or try removing and re-adding the app to the channel.
</Accordion>

<Accordion title="My workspace has App Approval enabled — how do I get CloudThinker approved?">
  If your workspace requires app approval, here's what to share with your Workspace Owner or app manager:

  1. Sign in to CloudThinker (they need a CloudThinker account with admin access to the organization)
  2. Go to [**Admin Settings → Integrations → Slack**](https://app.cloudthinker.io/admin-settings/integrations)
  3. Click **Add to Slack** and complete the Slack OAuth flow
  4. Approve the app in Slack's **Manage Apps** dashboard

  This is a **one-time setup**. Once approved, any workspace member can interact with CloudThinker by mentioning `@CloudThinker` in channels where the app has been added.
</Accordion>

***

## Permissions

### Slack OAuth Permissions

By default, any workspace member can install the CloudThinker Slack app. If your workspace has **App Approval** enabled, a Workspace Owner or app manager must approve CloudThinker before members can install it. This approval is a one-time operation — once approved, no further admin actions are required.

### CloudThinker Permissions

Within Slack, users can only access agents and cloud connections that their CloudThinker account permits. CloudThinker workspace roles apply the same way as they do in the web console.

***

## Related

<CardGroup cols={2}>
  <Card title="CloudThinker Language" icon="code" href="/guide/language">
    Complete syntax reference for all commands
  </Card>

  <Card title="Microsoft Teams Integration" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/teams.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=3c0044a0e91d90c33f6aee6c57b8d4aa" href="/guide/teams-integration" width="24" height="24" data-path="images/icons/teams.svg">
    Set up CloudThinker in Microsoft Teams
  </Card>
</CardGroup>
