---
title: 'Panguard Chat'
description: 'AI-powered security notifications via Telegram, Slack, Email, and Webhook with role-based tone adaptation.'
icon: 'message-square'
---

Panguard Chat is the notification and communication layer. It delivers security alerts in plain language through your preferred channel, adapting the tone and detail level to your role -- whether you are a boss who wants impact summaries, a developer who wants raw technical data, or an IT admin who wants remediation steps.

## Quick Start

```bash
# Interactive setup wizard
panguard chat setup

# Direct configuration
panguard chat setup --channel telegram --user-type boss --lang zh-TW

# Test your notification channel
panguard chat test

# Check status
panguard chat status
```

## Notification Channels

<CardGroup cols={2}>
  <Card title="Telegram" icon="paper-plane" href="/products/chat/telegram">
    Bot API integration with Markdown formatting. Best for individual developers and personal
    servers.
  </Card>
  <Card title="Slack" icon="hashtag" href="/products/chat/slack">
    Block Kit rich formatting with channel routing. Best for teams and organizations.
  </Card>
  <Card title="Email & Webhook" icon="envelope" href="/products/chat/email-webhook">
    SMTP HTML emails and custom webhook payloads with mTLS. Best for compliance and automation.
  </Card>
  <Card title="User Roles" icon="users" href="/products/chat/user-roles">
    3 roles with tailored notification formats: boss, developer, IT admin.
  </Card>
</CardGroup>

## Notification Types

Chat sends the following notification types, each triggered by different Guard events:

| Type                     | Trigger                                  | Frequency  |
| ------------------------ | ---------------------------------------- | ---------- |
| **Threat Alert**         | Guard detects a threat                   | Real-time  |
| **Auto-Response Notice** | Guard executes a response action         | Real-time  |
| **Confirmation Request** | Confidence 70--90%, needs human approval | Real-time  |
| **Daily Summary**        | Scheduled digest                         | Once daily |
| **Learning Progress**    | During learning mode                     | Once daily |
| **Score Change**         | Significant security score movement      | Real-time  |

## 3 User Roles

The same security event is presented differently depending on your configured role:

| Role        | Target Audience          | Focus                                           |
| ----------- | ------------------------ | ----------------------------------------------- |
| `boss`      | Non-technical executives | Impact summary, business risk, action status    |
| `developer` | Engineers, DevOps        | Raw technical data, IPs, PIDs, rules, timelines |
| `it_admin`  | IT administrators        | Step-by-step remediation instructions           |

See [User Roles](/products/chat/user-roles) for example outputs.

## Bilingual Support

All notification templates are available in English and Traditional Chinese:

```bash
# Traditional Chinese notifications
panguard chat setup --channel telegram --lang zh-TW

# English notifications
panguard chat setup --channel slack --lang en
```

## Credential Security

Channel credentials (Bot tokens, SMTP passwords, webhook secrets) are encrypted with AES-256-GCM and stored locally. Credentials are never transmitted in plaintext and never leave your machine.

## CLI Options

```
panguard chat <command> [options]

Commands:
  setup              Interactive setup wizard
  test               Send test notification
  status             Show channel status
  config             Show current configuration
  prefs              View/update notification preferences

Options:
  --channel <type>       Channel type (telegram|slack|email|webhook)
  --user-type <type>     User role (developer|boss|it_admin)
  --lang <en|zh-TW>      Language
  --data-dir <path>      Data directory
```
