Scheduled Reports
Building a Report
Configure metrics, time window, schedule, and message format
Open the Reports tab inside a Telegram integration and step through the form.
Name and target
Name the report and pick the Device to summarize.
Metrics
Add one or more metrics. Each metric is:
- Source: a device field, or fleet status
- Field: the telemetry field name
- Aggregation: Total (sum), Average, Minimum, Maximum, Latest value, or Count
- Optional label, prefix, unit, and decimal places for formatting
Time window
The period each report covers:
- Last 24 hours / 7 days / 30 days / 90 days
- Previous calendar month
- Current month (to date)
Schedule
- Frequency: Daily, Weekly, Monthly, or On demand only
- For Weekly: choose the day of week; for Monthly: the day of month
- Hour of day and Timezone - reports are generated and timestamped in this timezone
Message format
| Format | Description |
|---|---|
| Simple | Auto-formatted summary |
| Template | Your own layout using tokens such as {device_name}, {report_name}, {report_period}, {generated_at}, plus one token per metric |
| Custom (JSON) | Raw JSON payload |
A live preview shows the rendered message as you edit, so you can confirm the layout before saving.