September 15, 2020
Telegram log
This article describes how to use and manage the Telegram log, providing details for all available parameters and metrics.
Things to know before starting
- Template data for previewing is unavailable for messages with "failed" statuses.
- Template preview data in the Telegram Log is retained for three days.
- Telegram Log analytics are retained for 3 months.
- Telegram Log reports are generated and aggregated in real-time.
- Log parameters are displayed based on the account's designated time zone.
Telegram log management
Step-by-step instructions
Navigate to the "Analytics" section.
Click the "Message Logs" button.
Choose the “Telegram” tab.
Application of filters followed by clicking the “Search” button to refresh data.
Export data to XLSX or PDF using the “Create Export Task” button; exported data is aligned with the account's time zone.
Use of the “Telegram preview” button to inspect how the template was displayed on the recipient’s device.
Access to sending details via the “Info” button.
Direct access to contact profiles by clicking identifiers (available only for contacts in the Default Contact List).
Telegram log parameters and metrics
-
Filters
- Domain - the domain name from which the Telegram message was sent; allows filtering reports by a specific domain if multiple are active.
- Contact - the contact's identifier (email, phone number, or system-specific User ID) used for investigation.
- Origin - a filter to generate reports based on up to 5 items from categories like Campaigns, Automations, A/B tests, or registered Tags (searchable by name or ID).
- Date range - a selector for a specific time period to generate reports containing data only from the defined dates.
-
Parameters
- Status - the delivery state of the message: New (queued/not yet sent), Delivered (successful), or Failed (delivery was unsuccessful).
- Template - the title of the Telegram message, accompanied by the sending date and time according to the account's time zone.
- To - recipient identifiers, including their email address, phone number, and internal system User ID.
- Opens - tracking data used to measure engagement by showing the total number of opens and the specific dates they occurred.
- Clicks - statistics on link interactions, indicating which contacts clicked and the total frequency of those clicks.
-
Details
- Message ID - the unique identifier for each sent message.
- Status - the current delivery state (delivered, failed, or new).
- Template / Automation / Campaign / A/B test - the specific name and ID of the resource used for the mailing.
- Variant - the name of the A/B test version and its status (e.g., "Winner") if already determined.
- Iteration - the sequence number for recurring or replayed campaigns.
- Telegram bot - the name of the specific bot used to send the message.
- Tags - custom or system labels (Workflow names, API tags, or "testing" tags) used for reporting and categorization.
