Telegram Notifications

What this solution does

The module sends Telegram notifications about website events, including new and paid orders, status changes, user registrations, content publishing, web form submissions, and system events. Configuration is performed via the administrative panel without requiring programming.

The system includes a ready catalog of events for online stores, users, information blocks, web forms, and system processes. Separate recipients can be assigned for each event category and for each site in a multisite configuration. User-defined recipient lists can be applied to multiple categories simultaneously. Filtering by information blocks and web forms ensures notifications are sent only for relevant entities. If necessary, traffic can be separated by using distinct bots for different event categories.

Message delivery is handled through a database queue with priority support, ensuring orders are processed before standard notifications. The system implements retry attempts with exponential backoff and jitter. An optional circuit breaker feature is available to protect the system.

The Telegram notification module ensures reliable message delivery while respecting platform constraints. Send frequency is limited at both the bot and chat levels, applying to both web processes and CLI. Long messages are automatically split to comply with the 4096-character limit. Before sending, the system validates HTML and Markdown markup; if errors are detected, the content falls back to plain text. Inline buttons are available in the admin interface to link directly to relevant entities.

Recipient Management

A registry of known chats is maintained, supporting search, renaming, status verification, and enabling or disabling. The registry can be populated via three methods: a settings button, a webhook, or a CLI command. New chats require manual confirmation or can be approved automatically. Recipients are automatically disabled if persistent Telegram errors occur, such as bot blocking, removal from the chat, or insufficient permissions. Import and export of recipients are supported in CSV and JSON formats, with a preview step before saving.

Template Configuration

Message templates are editable and support variable substitution with a live preview feature. Three formatting modes are available: MarkdownV2, HTML, and plain text. Telegram-specific parameters allow disabling sound, blocking message forwarding, disabling link previews, and applying supergroup themes.

Diagnostics and Operations

The delivery log records key details for each event: event type, site, bot, recipient, HTTP status, error code, request duration, and values for retry_after and message_id.

The module provides detailed analytics on delivery success, including statistics for bots, HTTP status codes, and a top errors report. Problematic notifications can be returned to the queue individually or in batches. An administrative action log is maintained.

A module diagnostics page allows checking the state of tables, settings, the queue, and webhooks, and supports exporting reports in JSON and support bundles without secrets. Retention periods for all logs are configurable.

Security and Privacy

The bot token is stored encrypted or retrieved from an environment variable. Webhook secret rotation occurs without downtime: the previous value remains valid for a specified duration. The system includes protection against reprocessing identical update_ids. Personal data is automatically masked in logs and exports. User access rights can be restricted.

Admin Panel Interfaces

Section "Services → Telegram Notifications".

Section "Settings → Product Settings → Module Settings → Telegram Notifications".

General iT can install and configure this module and check how it works on your website.