Skip to main content
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

# 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

Telegram

Bot API integration with Markdown formatting. Best for individual developers and personal servers.

Slack

Block Kit rich formatting with channel routing. Best for teams and organizations.

Email & Webhook

SMTP HTML emails and custom webhook payloads with mTLS. Best for compliance and automation.

User Roles

3 roles with tailored notification formats: boss, developer, IT admin.

​
Notification Types

Chat sends the following notification types, each triggered by different Guard events:
TypeTriggerFrequency
Threat AlertGuard detects a threatReal-time
Auto-Response NoticeGuard executes a response actionReal-time
Confirmation RequestConfidence 70—90%, needs human approvalReal-time
Daily SummaryScheduled digestOnce daily
Learning ProgressDuring learning modeOnce daily
Score ChangeSignificant security score movementReal-time

​
3 User Roles

The same security event is presented differently depending on your configured role:
RoleTarget AudienceFocus
bossNon-technical executivesImpact summary, business risk, action status
developerEngineers, DevOpsRaw technical data, IPs, PIDs, rules, timelines
it_adminIT administratorsStep-by-step remediation instructions
See User Roles for example outputs.

​
Bilingual Support

All notification templates are available in English and Traditional Chinese: 
# 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