Google Chat
The Google Chat notification channel allows you to send alerts to Google Chat spaces when detections are triggered.
How It Works
The Google Chat notification channel uses webhook URLs to send messages to Google Chat spaces:
- Webhook Integration: Uses Google Chat’s incoming webhook feature
- Message Format: Sends formatted messages with detection details
- Threading: Uses notification history ID as thread key for message grouping
- Template System: Uses Handlebars templates for message formatting
Setup Instructions
Step 1: Create a Google Chat Webhook
- Open Google Chat in your browser
- Navigate to the space where you want to receive notifications
- Click the space name at the top
- Select “Apps & integrations”
- Click “Add webhooks”
- Enter a name for your webhook (e.g., “RunReveal Alerts”)
- Click “Save”
- Copy the webhook URL (starts with
https://hooks.gchat.com/services/...
)
Step 2: Configure in RunReveal
- Go to Notification Channels
- Click “Add Notification Channel”
- Select “Google Chat”
- Fill in the form:
- Display Name: Security Alerts (or your preferred name)
- Name: security-alerts (internal identifier)
- Google Chat Webhook URL: Paste the webhook URL from Step 1
- Click “Test Notification” to verify the connection
- Click “Create Notification” to save
Step 3: Add Notification Channels to Detections
Add notification channels to detections on individual notifications, within sigma rules, or mass subscribe via the detection query library tab of the detections page in RunReveal.
Message Format
Google Chat notifications use Handlebars templates to format messages with detection details including:
- Detection name and description
- Risk score and severity
- Detection results and context
- Links back to RunReveal for detailed analysis
You can create custom message templates by going to Notification Templates.
Best Practices
- Use descriptive webhook names for easy identification
- Test notifications before deploying to production
- Consider using different webhooks for different severity levels
- Monitor notification delivery through RunReveal’s alert history