GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Follow on X
  • Home
  • FAQ
  • Apps
  • API
  • Protocol
  • Schema
  • user

This view

  • Original page
  • New address

GeezerVison is showing core.telegram.org — user

  • Follow on X
  • Home
  • FAQ
  • Apps
  • API
  • Protocol
  • Schema

Machine-readable version of this page: /constructor/user.md.

  • API
  • TL-schema
  • user

user

Indicates info about a certain user.

Unless specified otherwise, when updating the local peer database, all fields from the newly received constructor take priority over the old constructor cached locally (including by removing fields that aren't set in the new constructor).

See here » for an implementation of the logic to use when updating the local user peer database.

  • Layer 225
    • 1 – Base layer
    • 2 – New userpic notifications
    • 3 – Send message can trigger link change
    • 4 – Check-in chats
    • 5 – Localized SMS, localized notifications
    • 6 – Foursquare integration
    • 7 – Added wallPaperSolid
    • 8 – Added end-to-end encryption
    • 9 – Improved big files upload perfomance
    • 10 – Improved chat participants updates
    • 11 – Improved secret chats
    • 12 – New dynamic support
    • 13 – Audio, video MIME; contacts import retry; new secret actions
    • 14 – Notify settings sync, blacklist sync
    • 15 – Modified getHistory offset behaviour
    • 16 – Split sendCode into 2 parts
    • 17 – Added custom typing, introduced message flags
    • 18 – Added usernames
    • 23 – Stickers for secret chats
    • 105 – Scheduled messages, Cloud themes
    • 108 – Login with QR code
    • 109 – Polls v2
    • 110 – People Nearby 2.0, Bank card entity
    • 111 – Folders, Broadcast Stats
    • 112 – Old featured stickers, generic dice, poll timer, poll solution
    • 113 – PSA
    • 114 – Video thumbs for GIFs
    • 115 – Peek Channel Invite
    • 116 – Group Stats, Profile Videos
    • 117 – WebRTC Phone Calls
    • 118 – Callback with 2FA, Countries list
    • 119 – Comments in channels, Threads, Anonymous Admins
    • 120 – Multipins, Message Stats, GeoLive v2
    • 121 – SVG-based Outlines for Stickers
    • 122 – Voice Chats
    • 123 – Voice Chat improvements
    • 124 – Expiring Invite links
    • 125 – Voice Chats in Broadcasts
    • 126 – Ban channels in channels
    • 127 – Payments in channels
    • 128 – Microthumbs for User/Chat profile photos
    • 129 – Video Chats
    • 130 – Custom placeholder for bot reply keyboards
    • 131 – Reset 2FA Password after a week
    • 132 – Chat themes
    • 133 – 64-bit IDs for User/Chat
    • 134 – Chat Requests, Shared Media Calendar
    • 135 – Send Message As a Channel
    • 136 – Reactions
    • 137 – Translations
    • 138 – GIF Sticker Packs
    • 139 – RTMP streaming
    • 140 – WebApps, Cloud Ringtones
    • 142 – TCP Reflectors
    • 143 – Premium Subscription, Cloud Invoices
    • 144 – Premium as a Gift, Custom Emoji
    • 145 – Custom Reactions, Statuses, Sign In with email
    • 147 – Keywords for stickers and emojis
    • 148 – Forums, collectible usernames
    • 150 – Pinned forum topics, general topic
    • 151 – Media spoilers, suggested profile photos
    • 152 – Real-time translations, Firebase SMS authentication
    • 153 – Modify created stickersets
    • 155 – Dates for reactions
    • 158 – Shared folders, per-chat wallpapers
    • 159 – Anonymous votes
    • 160 – Stories
    • 164 – Stories in Channels
    • 166 – Giveaways in channels
    • 167 – Similar channels
    • 168 – Channel colors
    • 169 – Multiselection of chats for bots
    • 170 – Saved Messages 2.0
    • 171 – Saved Messages 2.0
    • 174 – Group boosts
    • 176 – Business
    • 177 – Business Bots, Birthdays
    • 178 – Saved Personal channel, Reactions notifications
    • 179 – Channel revenue stats, phrases in SMS
    • 180 – Message Effects, Hashtags
    • 181 – Stars
    • 182 – Stars Revenue
    • 183 – Paid posts
    • 184 – Stars Refunds
    • 185 – MiniApp Store, Star Gifts
    • 186 – Channel Subscriptions for Stars
    • 187 – Stars Giveaways
    • 189 – Stars Gifts
    • 192 – Video Qualities, Ads in bots
    • 194 – Stars Subscription for Bots
    • 195 – Affiliate Programs for Bots
    • 196 – Collectible gifts
    • 197 – Similar Bots
    • 198 – Collectibles as emoji statuses
    • 200 – Paid Messages
    • 202 – Conference calls
    • 203 – Resell collectible gifts
    • 204 – Monoforums
    • 205 – TODO lists
    • 207 – Suggested channel posts
    • 210 – Star gift collections, rating
    • 211 – Story Albums
    • 212 – Prepaid gift upgrades
    • 213 – Music in profile
    • 214 – Chat Themes with collectible gifts
    • 215 – Chat Gift Themes
    • 216 – Threaded view for Bots
    • 217 – Live Stories
    • 218 – Gift Auctions
    • 219 – Passkeys
    • 220 – Gift Offers
    • 222 – Gift Crafts
    • 223 – User tags in groups
    • 224 – AI Editor, Live photos
    • 225 – Guest mode, Custom AI compose tones
    • More...
user#31774388 flags:# self:flags.10?true contact:flags.11?true mutual_contact:flags.12?true deleted:flags.13?true bot:flags.14?true bot_chat_history:flags.15?true bot_nochats:flags.16?true verified:flags.17?true restricted:flags.18?true min:flags.20?true bot_inline_geo:flags.21?true support:flags.23?true scam:flags.24?true apply_min_photo:flags.25?true fake:flags.26?true bot_attach_menu:flags.27?true premium:flags.28?true attach_menu_enabled:flags.29?true flags2:# bot_can_edit:flags2.1?true close_friend:flags2.2?true stories_hidden:flags2.3?true stories_unavailable:flags2.4?true contact_require_premium:flags2.10?true bot_business:flags2.11?true bot_has_main_app:flags2.13?true bot_forum_view:flags2.16?true bot_forum_can_manage_topics:flags2.17?true bot_can_manage_bots:flags2.18?true bot_guestchat:flags2.19?true id:long access_hash:flags.0?long first_name:flags.1?string last_name:flags.2?string username:flags.3?string phone:flags.4?string photo:flags.5?UserProfilePhoto status:flags.6?UserStatus bot_info_version:flags.14?int restriction_reason:flags.18?Vector<RestrictionReason> bot_inline_placeholder:flags.19?string lang_code:flags.22?string emoji_status:flags.30?EmojiStatus usernames:flags2.0?Vector<Username> stories_max_id:flags2.5?RecentStory color:flags2.8?PeerColor profile_color:flags2.9?PeerColor bot_active_users:flags2.12?int bot_verification_icon:flags2.14?long send_paid_messages_stars:flags2.15?long = User;

Parameters

Name Type Description
flags # Flags, see TL conditional fields
self flags.10?true Whether this user indicates the currently logged in user
contact flags.11?true Whether this user is a contact
When updating the local peer database, do not apply changes to this field if the min flag is set.
mutual_contact flags.12?true Whether this user is a mutual contact.
When updating the local peer database, do not apply changes to this field if the min flag is set.
deleted flags.13?true Whether the account of this user was deleted.
Changes to this flag should invalidate the local userFull cache for this user ID, see here » for more info.
bot flags.14?true Is this user a bot?
Changes to this flag should invalidate the local userFull cache for this user ID, see here » for more info.
bot_chat_history flags.15?true Can the bot see all messages in groups?
bot_nochats flags.16?true Can the bot be added to groups?
verified flags.17?true Whether this user is verified
restricted flags.18?true Access to this user must be restricted for the reason specified in restriction_reason
min flags.20?true See min
bot_inline_geo flags.21?true Whether the bot can request our geolocation in inline mode
support flags.23?true Whether this is an official support user
scam flags.24?true This may be a scam user
apply_min_photo flags.25?true If set and min is set, the value of photo can be used to update the local database, see the documentation of that flag for more info.
fake flags.26?true If set, this user was reported by many users as a fake or scam user: be careful when interacting with them.
bot_attach_menu flags.27?true Whether this bot offers an attachment menu web app
premium flags.28?true Whether this user is a Telegram Premium user
Changes to this flag should invalidate the local userFull cache for this user ID, see here » for more info.
Changes to this flag if the self flag is set should also trigger the following calls, to refresh the respective caches:
- The help.getConfig cache
- The messages.getTopReactions cache if the bot flag is not set
attach_menu_enabled flags.29?true Whether we installed the attachment menu web app offered by this bot.
When updating the local peer database, do not apply changes to this field if the min flag is set.
flags2 # Flags, see TL conditional fields
bot_can_edit flags2.1?true Whether we can edit the profile picture, name, about text and description of this bot because we own it.
When updating the local peer database, do not apply changes to this field if the min flag is set.
Changes to this flag (if min is not set) should invalidate the local userFull cache for this user ID.
close_friend flags2.2?true Whether we marked this user as a close friend, see here » for more info.
When updating the local peer database, do not apply changes to this field if the min flag is set.
stories_hidden flags2.3?true Whether we have hidden » all active stories of this user.
When updating the local peer database, do not apply changes to this field if the min flag is set.
stories_unavailable flags2.4?true No stories from this user are visible.
contact_require_premium flags2.10?true See here for more info on this flag ».
bot_business flags2.11?true Whether this bot can be connected to a user as specified here ».
bot_has_main_app flags2.13?true If set, this bot has configured a Main Mini App ».
bot_forum_view flags2.16?true If set, this bot supports bot forum topics ».
bot_forum_can_manage_topics flags2.17?true If set, this bot supports bot forum topics », and users (not just the bot!) are allowed to create and manage bot forum topics in their private chat with the bot.
bot_can_manage_bots flags2.18?true If set, this bot is a manager bot that can create and manage managed bots » on behalf of the user.
bot_guestchat flags2.19?true If set, this bot can be invoked as a guest in chats ».
id long ID of the user, see here » for more info and the available ID range.
access_hash flags.0?long Access hash of the user, see here » for more info.
If this flag is set, when updating the local peer database, generate a virtual flag called min_access_hash, which is:
- Set to true if min is set AND
-- The phone flag is not set OR
-- The phone flag is set and the associated phone number string is non-empty
- Set to false otherwise.

Then, apply both access_hash and min_access_hash to the local database if:
- min_access_hash is false OR
- min_access_hash is true AND
-- There is no locally cached object for this user OR
-- There is no access_hash in the local cache OR
-- The cached object's min_access_hash is also true

If the final merged object stored to the database has the min_access_hash field set to true, the related access_hash is only suitable to use in inputPeerPhotoFileLocation », to directly download the profile pictures of users, everywhere else a inputPeer*FromMessage constructor will have to be generated as specified here ».
Bots can also use min access hashes in some conditions, by passing 0 instead of the min access hash.
first_name flags.1?string First name.
When updating the local peer database, apply changes to this field only if:
- The min flag is not set OR
- The min flag is set AND
-- The min flag of the locally cached user entry is set.
last_name flags.2?string Last name.
When updating the local peer database, apply changes to this field only if:
- The min flag is not set OR
- The min flag is set AND
-- The min flag of the locally cached user entry is set.
username flags.3?string Main active username.
When updating the local peer database, apply changes to this field only if:
- The min flag is not set OR
- The min flag is set AND
-- The min flag of the locally cached user entry is set.
Changes to this flag should invalidate the local userFull cache for this user ID if the above conditions are respected and the bot_can_edit flag is also set.
phone flags.4?string Phone number.
When updating the local peer database, apply changes to this field only if:
- The min flag is not set OR
- The min flag is set AND
-- The min flag of the locally cached user entry is set.
photo flags.5?UserProfilePhoto Profile picture of user.
When updating the local peer database, apply changes to this field only if:
- The min flag is not set OR
- The min flag is set AND
-- The apply_min_photo flag is set OR
-- The min flag of the locally cached user entry is set.
status flags.6?UserStatus Online status of user.
When updating the local peer database, apply changes to this field only if:
- The min flag is not set OR
- The min flag is set AND
-- The min flag of the locally cached user entry is set OR
-- The locally cached user entry is equal to userStatusEmpty.
bot_info_version flags.14?int Version of the bot_info field in userFull, incremented every time it changes.
Changes to this flag should invalidate the local userFull cache for this user ID, see here » for more info.
restriction_reason flags.18?Vector<RestrictionReason> Contains the reason why access to this user must be restricted.
bot_inline_placeholder flags.19?string Inline placeholder for this inline bot
lang_code flags.22?string Language code of the user
emoji_status flags.30?EmojiStatus Emoji status
usernames flags2.0?Vector<Username> Additional usernames.
When updating the local peer database, apply changes to this field only if:
- The min flag is not set OR
- The min flag is set AND
-- The min flag of the locally cached user entry is set.
Changes to this flag (if the above conditions are respected) should invalidate the local userFull cache for this user ID.
stories_max_id flags2.5?RecentStory Summary of the user's active stories ».
When updating the local peer database, do not apply changes to this field if the min flag of the incoming constructor is set.
color flags2.8?PeerColor The user's accent color.
profile_color flags2.9?PeerColor The user's profile color.
bot_active_users flags2.12?int Monthly Active Users (MAU) of this bot (may be absent for small bots).
bot_verification_icon flags2.14?long Describes a bot verification icon ».
send_paid_messages_stars flags2.15?long If set, the user has enabled paid messages », we might need to pay the specified amount of Stars to send them messages, depending on the configured exceptions: check userFull.send_paid_messages_stars or users.getRequirementsToContact to see if the currently logged in user actually has to pay or not, see here » for the full flow.

Type

User

Related pages

Peer database

Many constructors in the API need to be stored in a local database upon reception and should only ever be updated reactively (passively) when received via updates or by other means (as specified in the documentation), to avoid overloading the server by continuously requesting changes for the same unchanged information.

userFull

Extended user info

When updating the local peer database », all fields from the newly received constructor take priority over the old constructor cached locally (including by removing fields that aren't set in the new constructor).

Min constructors

In some situations user and channel constructors have reduced set of fields present (although id is always there) and min flag set.

Bot attachment menu and side menu entries

Bots can install attachment menu and side menu entries, offering conveniently accessible, versatile web apps.

help.getConfig

Returns current configuration, including data center configuration.

messages.getTopReactions

Got popular message reactions

Privacy settings

Telegram allows users to specify granular privacy settings, choosing which users can or can't interact with them in certain ways.

Telegram Stories

Telegram users and channels can easily post and view stories through the API.

Connected business bots

Users can connect Telegram bots that will process and answer messages on their behalf. This allows them to seamlessly integrate any existing tools and workflows, or add AI assistants that manage their chats.

Mini Apps on Telegram

Bots can offer users interactive HTML5 web apps to completely replace any website.

Forum topics

Telegram allows creating forums with multiple distinct topics.

Managed bots

Users can create managed bots (which are controlled by a specific manager bot) directly through the MTProto API, without interacting with @BotFather.

Guest mode for bots

Guest bots can be queried by username from any non-secret private chat, group and supergroup (except for groups/supergroups with content protection » enabled), posting their results directly into the chat, even if they're not a member.

inputPeerPhotoFileLocation

Location of profile photo of channel/group/supergroup/user

Uploading and Downloading Files

How to transfer large data batches correctly.

userStatusEmpty

User status has not been set yet.

Emoji status

Telegram allows users to set an emoticon or a custom emoji as status, to show next to their name in chats and profiles.

Accent colors

Telegram users and channels can change the accent color and background pattern of their profile page and their messages!

Third-party verification

To further improve transparency on Telegram, official third-party services are able to assign extra verification icons to user accounts and chats — in order to prevent scams and reduce misinformation.

Paid messages

Telegram Stars can be used to pay for sending messages to users, supergroups and channels that have configured paid messages, requiring a payment for every message sent to them.

Telegram Stars

Telegram Stars are virtual items that allow users to purchase digital goods and services from bots and mini apps inside the Telegram ecosystem, send gifts to content creators on the Telegram platform, and more.

users.getRequirementsToContact

Check whether we can write to the specified users, used to implement bulk checks for Premium-only messages » and paid messages ».

For each input user, returns a RequirementToContact constructor (at the same offset in the vector) containing requirements to contact them.

Telegram
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.
About
  • FAQ
  • Privacy
  • Press
Mobile Apps
  • iPhone/iPad
  • Android
  • Mobile Web
Desktop Apps
  • PC/Mac/Linux
  • macOS
  • Web-browser
Platform
  • API
  • Translations
  • Instant View
About
Blog
Press
Safety
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.