Learning Centre
Master Telegram Bot App with comprehensive guides, tutorials, and documentation

How to Check Whether a Telegram User Is a Spammer

Link to this section

Open the free User Intelligence page, enter the person's numeric Telegram user ID, and press Analyze. The report shows a spam rating from 0.0 to 1.0 (displayed as a percentage), a risk level, the user's group activity, and their moderation history in groups protected by Telegram Bot App. The rating is a probabilistic signal, not a verdict, so use it to check Telegram user spam risk and then judge the evidence yourself.

This guide covers what the Telegram user intelligence report contains, how to read the number, what the lookup cannot tell you, and what to do when someone looks risky. For group statistics, the live punishment feed and the admin-panel search, see User Intelligence and Group Analytics.

What does the User Intelligence lookup report?

Link to this section

The page generates a report from one input: a Telegram user ID. Per the page's own text, it analyses the user's message history, group activity and past violations with what it calls 7 AI detection engines. The report has these parts:

Card on the pageWhat it shows
User ProfileName, handle, a flag for the profile picture, Last Seen, Profile Last Updated
Spam Risk AssessmentSpam Rating, Risk Level, and a scale from 0% (Safe) to 100% (Spam)
Group ActivityGroups, Total Messages, Admin Rights, Messages per Group, Admin Ratio
Violations & PunishmentsTotal Punishments, Total Duration, and the Latest Violations list (up to 10)
Violation StatisticsTotal Offences, Avg Confidence, Median Confidence, 95th Percentile, High Confidence, Common Type, Most Common Reason

A message activity chart with a time-range selector sits between Group Activity and Violations & Punishments.

How do I check a Telegram user's spam rating?

Link to this section
  1. Get the numeric user ID. The field accepts numbers only, not an @username. The page suggests a bot such as userinfobot: start a chat and forward a message from the user, or share their contact. Group admins using Telegram Bot App can also see user IDs in moderation logs, and clicking a user in the Live Punishments tab opens their report directly.
  2. Open the page. Go to /user-intelligence and stay on the User Intelligence tab.
  3. Enter the ID and press Analyze. The field is labelled Telegram User ID. The address bar then holds a link containing that ID, so sharing the link shares the lookup.
  4. Read the Spam Risk Assessment first. Note the Risk Level and the Spam Rating, then read the sentence under the scale.
  5. Check the Violations & Punishments card. Look at how many punishments there are, and read each entry in Latest Violations: the type, the reason, the confidence percentage and the timestamp.
  6. Read Violation Statistics. Many offences at high confidence say more than one offence at low confidence.
  7. Look at Group Activity. The page shows how many groups the user is in and how many messages they have sent.

If the page shows "No report available yet", it has no data for that ID. The page says this usually means the account has not appeared in monitored groups or has no moderation history.

How do I read a spam rating without overclaiming?

Link to this section

The rating runs from 0.0 (legitimate user) to 1.0 (almost certainly spam). The page converts it to a risk level using fixed cut-offs at 0.2, 0.4, 0.6 and 0.8:

RatingRisk levelThe page's wording
Below 0.2Very LowAppears to be a legitimate user
0.2 to below 0.4LowMinimal concerning activity
0.4 to below 0.6MediumSome concerning activity detected
0.6 to below 0.8HighMultiple violations or concerning patterns detected
0.8 and aboveVery HighVery strong indicators of spam behavior

Treat these as the page's labels, not as a decision rule. The page itself carries this disclaimer: "Spam ratings are probabilistic indicators and should be used as one factor among many when evaluating users."

Two habits keep you honest:

  • Read the evidence behind the number. A rating built on several high-confidence violations is stronger than one built on a single low-confidence flag. The FAQ calls violations above 80% confidence typically very accurate and lower scores possibly borderline cases.
  • Do not treat a rating as a guarantee. The FAQ says false positives can occur.
  • Keep your own rule separate. The page gives no action threshold. Separately, when a group turns on AI Spam Intelligence, the bot acts automatically on users whose rating is above 0.75. That value is fixed in the bot's code. The dashboard has a switch for the feature but no control for this threshold. See the AI Spam Intelligence guide.

What can the lookup not tell you?

Link to this section
  • Who the person is, or what they intend. It reports patterns in recorded activity, nothing about identity.
  • What they wrote. The page shows violation type, reason, confidence and time. It does not show message text, and the FAQ says private messages, chat content and personal contact information are never exposed.
  • What happened outside monitored groups. Data comes only from groups protected by Telegram Bot App. An empty report means "no data", which is not the same as "safe".
  • Very recent activity on a brand-new account. A new account with few messages has little history to score. (inferred from the empty-report messages and the existing analytics guide, which says new spammers with few violations will not have high ratings yet.)
  • Fresh profile details. Violations appear within seconds, per the FAQ. Name, username and photo are refreshed every 24 hours or when the profile is accessed, so check Profile Last Updated.

What should I do in my group when someone looks risky?

Link to this section

Start with the evidence, not the number. Then use the tools your group already has:

  1. Warn first if the evidence is mixed. With warnings enabled, admins use /warn; at the warning limit (default 3) the member is banned automatically. See Warnings, Reports, and the Moderation Log.
  2. Let members report. When member reports are on, anyone can reply to a message with /report. A report punishes no one; it tells admins which message to look at.
  3. Restrict or remove the account yourself if the evidence is strong. Use Telegram's own admin tools. In Telegram's permission names, restricting or banning a member is the can_restrict_members right ("restrict, ban or unban chat members"), and deleting messages is can_delete_messages. A bot can ban only if it is an administrator with the appropriate rights (banChatMember, ChatMemberAdministrator). For a ban set by a bot, an until_date more than 366 days away, or less than 30 seconds, makes the ban permanent. In practice, a human admin usually does this from the group's member list (group profile, Members, the member); Telegram documents no in-app steps for it.
  4. Turn on the automatic layers. These dashboard settings exist:
SettingWhat it doesPlan
Spam Finder (Pattern-based)Detects spam using pattern analysis, with an adjustable thresholdFree
Kick known abusersBans members already flagged as abusers by the network intelligence when they joinFree
CAPTCHA, profile picture and bio scanningScreen new members at the doorFree
AI Spam IntelligencePer-user behavioural risk scoring, the same kind of score this lookup showsGold and above

See Profile scanning and behavioral databases for how joiners are checked, Automated Punishment System for what happens after a violation, and pricing for plans.

What data does the lookup use, and is there an API?

Link to this section

Per the FAQ, the report is built from a user's message history, group activity and past violations. It shows profile information (name, username), group membership counts, punishment statistics and anonymised violation types.

The privacy policy adds detail. Telegram Bot App receives the Telegram user ID, display name, username, group membership and admin status. Messages that no filter flags are analysed as they arrive and are not retained. A message that a filter flags is retained as part of its violation record. Violation records (type, reason, confidence score and timestamp) are kept, and the policy says they are retained indefinitely. Profile pictures are analysed and not stored; only a yes-or-no NSFW flag is kept. The policy gives users the right to request erasure, including violation history and spam ratings, and says requests get a response within 30 days.

The same lookup is available as a public API: free, no authentication, no rate limits at present. The FAQ asks users to cache results where appropriate and to contact Telegram Bot App before high-volume use (over 10,000 requests per day), and says tiered pricing or rate limits may come later for very high-volume commercial users. The API Documentation tab on the page has the endpoint and examples.

Common questions

Link to this section

Q: What is User Intelligence and how does it work? A: It is an analysis tool that evaluates Telegram user behavior using 7 AI detection engines. It analyses a user's message history, group activity and past violations to produce a spam rating from 0.0 (legitimate user) to 1.0 (almost certainly spam).

Q: How accurate are the spam ratings? A: Ratings are probabilistic indicators and should be one factor among many. The FAQ says false positives can occur.

Q: How do I find a user's Telegram ID? A: The page suggests a bot such as userinfobot: start a chat with it and forward a message from the user, or share their contact. You can also click a user in the Live Punishments feed, and group admins using Telegram Bot App can see user IDs in moderation logs.

Q: Is user intelligence data public? A: Yes, the lookup is a public tool that requires no authentication. It does not expose private messages, chat content or personal contact information.

Q: Can a user dispute their spam rating? A: Yes. They contact support with their Telegram user ID and the reason they think the rating is wrong, and the team reviews the flagged violations manually and adjusts ratings if warranted. The FAQ notes that false positives can occur, especially for users who are in many communities.

Q: How often is the data updated? A: Violations are reflected in a report within seconds of a punishment, according to the FAQ. Profile information is refreshed every 24 hours or when accessed.

Last updated: 2026-11-13

Written by the Telegram Bot App team · Last updated