Telegram
Overview
The Telegram module enables alarm notifications via Telegram Bot API. It integrates seamlessly with Ignition's alarm notification system, allowing operators to receive alarm alerts directly in their Telegram chats with optional interactive acknowledgment.
Features
- Telegram Bot Integration - Send notifications via any Telegram bot
- Individual and Group Chats - Support for personal messages and group notifications
- Interactive Acknowledgment - One-click alarm acknowledgment via inline buttons
- Dynamic Message Templates - Expression-based message content with access to alarm variables
- Per-Alarm Custom Messages - Override notification message at the alarm level via extended configuration
- Throttling Support - Different message templates for single vs. multiple alarm events
- Test Mode - Validate configuration without sending actual messages
- Audit Integration - Log all notifications to Ignition's audit system
- HTML Formatting - Rich text formatting in notification messages
- Secure Token Storage - Bot tokens stored encrypted via Ignition's secret management
Technical Specifications
| Specification | Value |
|---|---|
| Module ID | com.operametrix.ignition.telegram |
| Module Name | Telegram Alarm Notification |
| Current Version | 2.0.0 |
| Minimum Ignition Version | 8.3.0 |
| Required Module | Alarm Notification |
| Scope | Gateway |
Architecture
The module registers a custom Telegram Notification profile type in Ignition's Alarm Notification system. When an alarm triggers a notification block using this profile:
- The alarm event is received by the notification profile
- Contact information (Telegram Chat IDs) is extracted from the roster
- Message expressions are evaluated with alarm context variables
- An inline acknowledgment button is added (if enabled)
- The notification is sent via Telegram Bot API
- A background poller handles acknowledgment button clicks