Article summary
Interpret Telegram Activity fields including offline time, active days, User ID, username, and frozen status without claiming online presence or reply intent.
“Active Telegram user” is not a permanent label that can be separated from time and field definition. AppShai TG Activity supports phone, Telegram User ID, username, offline time, active days, first name, last name, Telegram Premium/VIP status, and frozen status. Each is a point-in-time task result—not proof that someone is online now, has read a message, or wants to reply.
This guide is for operations and data teams importing TG activity signals into CRM. It builds a reviewable field dictionary, segmentation rule, and recheck policy instead of a simplistic active-versus-zombie label.
Core definition: A Telegram activity check is a dated field snapshot. Offline time and active days must be interpreted with checked-at time, blank state, and task version.
Registration, Activity, and online-now are different states
TG Registration returns phone and registration status. TG Activity adds User ID, username, offline time, active days, names, Premium/VIP, and frozen status. It still cannot confirm that a user is looking at a screen now or has read your message.
| Question | Correct evidence | Wrong substitute |
|---|---|---|
| Registration signal? | TG Registration and date | Active days |
| Which activity fields returned? | TG Activity Excel | App screenshot |
| Read a specific message? | Actual conversation evidence | Offline time |
| May we contact? | Permission and opt-out | Registration/activity |
| Will they reply? | Observed interaction | VIP or username |
How to interpret offline time
Offline time is not the same as last interaction with your business and does not promise a precise public online history. Preserve the raw task value with checked_at and task ID instead of renaming it last login and losing its definition.
| Returned state | Stored status | Next action |
|---|---|---|
| Parseable time | Preserve value, timezone, check date | Segment under one window |
| Blank | unknown | Do not default to long-term offline |
| Invalid format | invalid_format | Review Excel and task definition |
| Changes between batches | Keep history | Compare same definition |
Build a repeatable active-days segment
Choose a window from the business cycle before looking for the most attractive distribution. Support follow-up may use a shorter window than long-term customer maintenance. A threshold is an internal rule, not an official Telegram customer-value class.
| Example segment | Internal rule | Allowed use | Must not claim |
|---|---|---|---|
| Recent | Falls in predefined short window | Schedule permissioned service follow-up | Online now |
| Mid-term | Falls in middle window | Adjust contact cadence | Intent declined |
| Long-term/unknown | Outside long window or blank | Review channel and permission | Zombie or invalid person |
Version the rule and keep it consistent across markets and batches before comparing results.
User ID, username, names, and VIP fields
These can support joining, deduplication, or manual review, but they are not automatic identity verification. Usernames change, names may be custom, Premium/VIP does not mean purchasing power, and frozen status must remain dated rather than a permanent label.
| Field | Appropriate use | Do not infer |
|---|---|---|
| TG User ID | Controlled join/deduplication | Legal identity |
| Username | Manual platform review | Permanent contact address |
| First/Last Name | Display and match aid | Verified real name |
| TG VIP/Premium | Store task result | Wealth or buying power |
| Frozen status | Risk/exception queue | Permanently unusable |
TXT-to-activity-snapshot workflow
- Extract phones from a list with documented source and purpose.
- Normalize by country rules and deduplicate after normalization.
- Export UTF-8 TXT with one phone per line.
- Select TG Activity on the AppShai Telegram (TG) Number Checker.
- Validate fields and blanks on a sample.
- Preserve the raw Excel after production.
- Import into dedicated TG fields through CRM ID and normalized phone.
- Record checked-at date, rule version, and recheck condition.
Excel is the export, not the upload. Check results must not overwrite permission, last response, sales stage, or account owner.
A three-layer activity, permission, and interaction model
| Layer | Source | Question | Update |
|---|---|---|---|
| Activity signal | TG Activity | What did the task return? | Recheck when justified |
| Contact eligibility | CRM permission, purpose, opt-out | May we contact? | Event-driven |
| Observed interaction | Messages, replies, orders, tickets | What happened? | Business-system log |
A contact can have an activity signal and still be ineligible for marketing, or retain permission while the channel state requires review.
Activity-data acceptance and exception matrix
| Check | Pass condition | Failure action |
|---|---|---|
| Rows | Input, accepted, result, exception reconcile | Stop import |
| Fields | Match current TG Activity definition | Review task |
| Time | Offline and checked_at types explicit | Fix timezone |
| Blanks | Unknown with reason | Never fill zero |
| Mapping | Sample returns to raw phone and CRM ID | Repair map |
| History | Batches preserved separately | Do not overwrite single field |
When should activity be rechecked?
Use a business event or an internal freshness window instead of rerunning every day. A new permissioned service process, a restarted long-cycle project, an expired result, or a repaired task exception can justify a recheck.
| Trigger | Recheck? | Reason |
|---|---|---|
| Refresh dashboard only | Usually no | No new business question |
| Result exceeds usage window | Consider | Freshness is insufficient |
| Customer updates phone | Yes | Key input changed |
| Task exception repaired | Yes | Verify the fix |
| Customer opted out | No | Suppress instead of recheck |
Frequently asked questions
Do fewer active days guarantee a reply?
No. Activity fields differ from interest in your brand, content, and permission. Reply propensity must be measured through real, compliant interaction.
Does blank offline time mean inactive?
No. Keep it unknown. It may be not returned, not applicable, malformed, or a processing exception; review the task and exception log first.
Can TG Activity prevent an account ban?
No. Telegram’s official spam guidance says unwanted stranger messages may be reported and accounts can be limited. Activity checking does not replace permission, content, frequency, opt-out, or complaint handling.
A mature activity segment does not promise to find people who will certainly reply. It preserves fields, time, and business rules so every inference remains visible and testable.
