# Slack Integration

Connect Brizz to Slack for real-time alerts and notifications

Connect Brizz to your Slack workspace to receive real-time alerts and notifications about your AI agents directly in Slack.

## Why Connect Slack?

Integrating Slack with Brizz enables:

- **Daily Activity Reports**: Receive daily summaries of your agent's performance
- **Weekly Summaries**: Get weekly insights delivered to your team
- **Emerging Intent Alerts**: Be notified when new user intents are detected
- **Issue Notifications**: Stay informed about critical issues as they happen

## How to Connect

1. Navigate to **Settings > Integrations** in the Brizz dashboard
2. Click **Connect Slack**
3. Authorize Brizz in your Slack workspace
4. Select the channel where you want to receive notifications

### Upgrading an existing install

When Brizz adds new bot scopes (for example, the AI agent features coming soon), Slack does not auto-prompt installed workspaces. A workspace admin must re-authorize Brizz once to grant the new permissions. If your workspace needs an upgrade, the integration card will show an **Update required** state with a **Reconnect Slack** button — one click completes the flow and preserves all of your existing channel settings.

## App Directory Listing

### Short Description
Real-time insights and alerts for your AI agents.

### Long Description
**Brizz is the analytics layer for AI agents, turning every conversation into actionable insights to improve performance and drive product decisions.**

The Brizz app for Slack brings these critical insights directly to where your team collaborates, ensuring you never miss a beat with your AI agent's behavior.

**How it works**
Once connected, Brizz monitors your AI agents in real-time and delivers high-signal notifications to your chosen channels. You can customize which alerts you receive to keep your product and engineering teams aligned.

**Key Features:**
*   **🚨 Real-time Issue Alerts**: Get instantly notified when your agent encounters critical errors or anomalies.
*   **📊 Daily & Weekly Summaries**: Receive automated reports on agent performance, conversation volume, and success rates.
*   **💡 Emerging Intents**: Be the first to know when users start asking about new topics or features your agent doesn't handle yet.
*   **🔗 Rich Link Previews**: Paste a link to a Brizz session or trace, and see a detailed preview including user intent, duration, and status without leaving Slack.
*   **⚡️ Quick Commands**: Use `/brizz status` to check system health instantly.

Connect Brizz to Slack today to accelerate feedback loops and make your AI agents more successful.

## Required Permissions

When you connect Slack, Brizz requests the following permissions:

| Permission          | Why We Need It                                                                                      |
| ------------------- | --------------------------------------------------------------------------------------------------- |
| `channels:join`     | Automatically join public channels when you configure notifications, so the bot can post without manual `/invite` |
| `chat:write`        | Send daily reports, weekly summaries, emerging intent alerts, and issue notifications to channels   |
| `commands`          | Enable the `/brizz` slash command so your team can check status and access help directly in Slack   |
| `team:read`         | Identify your Slack workspace to ensure notifications are delivered to the correct organization     |
| `users:read`        | Display user names in notifications and activity reports for better context and identification      |
| `users:read.email`  | Match Slack users with their Brizz accounts to associate your workspace with your organization      |
| `app_mentions:read` | Allow Brizz to respond when mentioned in channels for interactive queries and commands (future)     |
| `incoming-webhook`  | Deliver webhook-based notifications for real-time alerts and automated messages to your channels    |
| `channels:read`     | List available public channels in your workspace so you can select where to receive notifications   |
| `groups:read`       | List private channels in your workspace so you can configure notification delivery to private groups|
| `links:read`        | Receive link_shared events when Brizz dashboard URLs are posted in Slack for rich link previews     |
| `links:write`       | Unfurl Brizz dashboard links with rich previews showing session, intent, and journey details         |

### Coming soon

These scopes power the new **Brizz AI agent in Slack** and will be requested once Slack approves the expanded app manifest. No action is needed today — when they ship, the integration card will prompt for a one-click reconnect.

| Permission          | Why We Need It                                                                                      |
| ------------------- | --------------------------------------------------------------------------------------------------- |
| `assistant:write`   | Power the Brizz AI agent container — thread titles, status, and suggested prompts                  |
| `im:history`        | Read direct messages sent to the Brizz agent so it can reply with analytics insights               |

## Slash Commands

Once connected, you can use these commands in Slack:

- `/brizz` or `/brizz help` - Show available commands
- `/brizz status` - Check Brizz connection status

## Managing the Integration

To disconnect or reconfigure the Slack integration:

1. Go to **Settings > Integrations**
2. Find the Slack integration card
3. Click **Disconnect** or **Configure**

## See also

- [Jira](/docs/integrations/jira.md) — the other outbound issue integration.
- [Issues](/docs/platform/issues.md) — the source of what Slack alerts are notifying you about.