Skip to main content
Panguard Chat delivers security alerts to the channels your team already uses. This guide covers setting up each of the 5 supported notification channels and configuring user roles to control who receives what.
1

Initialize Chat configuration

Run the interactive setup wizard:
panguard chat setup
The wizard walks you through channel selection and credential entry. You can also configure channels individually using the flags shown below.
2

Configure your channels

Set up one or more notification channels:
  1. Message @BotFather on Telegram and create a new bot
  2. Copy the bot token
  3. Start a chat with your bot and send any message
  4. Get your chat ID from the Telegram API or use @userinfobot
panguard chat setup --channel telegram \
  --telegram-token "123456:ABC-DEF..." \
  --telegram-chat-id "-1001234567890"
For group notifications, add the bot to a Telegram group and use the group chat ID (starts with -100).
3

Configure user roles

Panguard supports 3 user roles that control notification verbosity:
RoleReceivesBest for
developerAll severity levels with full technical detailsEngineers, DevOps
bossCRITICAL and HIGH only, plain-language summariesExecutives, managers
it_adminAll severity levels, medium detail, action itemsIT operations
Set the role for each channel:
panguard chat setup --channel telegram --role developer
panguard chat setup --channel email --role boss
panguard chat setup --channel slack --role it_admin
You can configure the same channel type multiple times with different roles. For example, send developer-level alerts to #security-engineering and boss-level summaries to #security-executive.
4

Test your configuration

Send a test notification to all configured channels:
panguard chat test

  PANGUARD AI - Chat Test

  Sending test notification...

  Telegram   ... sent
  Slack      ... sent
  Email      ... sent

  All channels verified.
Test a specific channel:
panguard chat test --channel slack
5

Verify active channels

List all configured notification channels and their status:
panguard chat status

  PANGUARD AI - Chat Status

  -- Channels -------------------------------

  Telegram   Active   role: developer   last sent: 2m ago
  Slack      Active   role: it_admin    last sent: 15m ago
  Email      Active   role: boss        last sent: 1h ago

  3 channels configured, 3 active.

​
What to do next

Set up real-time protection

Notifications require Guard to be running. Start continuous monitoring first.

Chat product reference

Full documentation for the Chat notification system.

User roles deep dive

Detailed breakdown of what each role receives and message formatting.

Troubleshoot notifications

Common issues with channel configuration and delivery.