Slack Integration Setup

Terracotta AI connects to your Slack workspace to deliver PR review results, drift alerts, and AI-powered infrastructure chat — all without leaving your team's channels.

Slack integration is available on Team plan and above. OSS (Free) plan users can upgrade from Settings > Billing.

🚀 Overview

With Slack connected, your team gets:

Real-time notifications — PR review results, drift alerts, and guardrail violations posted directly to your chosen channel
AI chat — Ask Terracotta about your infrastructure, recent reviews, or drift status by mentioning it in any channel
Slash commands — Quick status checks and activity summaries from the command line

🛠️ Setting Up Slack

Navigate to Settings > Integrations > Slack in your Terracotta dashboard
Click Connect Slack
You are redirected to Slack's OAuth authorization screen — review the requested permissions and click Allow
Select the channel where Terracotta should post notifications
You are redirected back to Terracotta with a confirmation banner

The user initiating the connection must have admin permissions in both Terracotta and the Slack workspace.

🔍 Notifications

Once connected, Terracotta posts structured messages to your selected channel for:

PR review completions — Summary of findings, severity breakdown, and a link to the full review
Drift alerts — Drifted resources detected during scheduled or on-demand scans
Guardrail violations — Policy violations caught during PR review with file and line references

Configure which notification types are active in Settings > Integrations > Slack > Notification Preferences.

🧠 AI Chat

Terracotta's Slack bot responds to natural-language questions about your infrastructure:

@mention Terracotta in any channel where the bot is present
DM the bot directly for private queries

Example prompts:

"What repos have active drift?"
"Summarize the last review on infra-core"
"Which guardrails failed this week?"

AI chat requires account linking (see below) to scope responses to your organization's data.

✅ Account Linking

To enable personalized AI responses, link your Slack identity to your Terracotta account:

Open a direct message with the Terracotta bot in Slack
Send any message — the bot responds with a linking prompt
Click the link and authenticate with your Terracotta credentials
Your Slack user is now associated with your Terracotta account

Linked accounts see responses scoped to their organization, repositories, and permissions.

🛠️ Slash Commands

Command	Description
`/terracotta status`	Check connection status and recent activity

Slash commands work in any channel where the Terracotta bot is installed.

🔐 Disconnecting

To remove the Slack integration:

Go to Settings > Integrations > Slack
Click Disconnect
Confirm the action in the dialog

Disconnecting removes all channel bindings and stops notifications. AI chat and slash commands become unavailable. You can reconnect at any time by repeating the setup flow.

📋 TL;DR

Slack integration is available on Team plan and above
Connect via Settings > Integrations > Slack using OAuth
Receive PR review, drift, and guardrail notifications in your channel
Use AI chat by @mentioning the bot or DMing it directly
Link your Slack account to your Terracotta account for personalized responses
/terracotta status for quick connection and activity checks
Disconnect anytime from Settings without affecting your Terracotta data