Class Chat

constructor

• new Chat(peer): Chat

• Parameters

  • peer: TypeUser | TypeChat

  Returns Chat

Optional Readonlydistance

Readonlypeer

Readonlytype

adminRights

• get adminRights(): null | RawChatAdminRights

• Admin rights of the current user in this chat. null for PMs and non-administered chats

  Returns null | RawChatAdminRights

boostsLevel

• get boostsLevel(): number

• Boosts level this chat has (0 if none or is not a channel)

  Returns number

chatType

• get chatType(): ChatType

• Type of chat

  Returns ChatType

color

• get color(): ChatColors

• Color that should be used when rendering replies to the messages and web previews sent by this chat, as well as to render the chat title

  Returns ChatColors

dcId

• get dcId(): null | number

• User's or bot's assigned DC (data center). Available only in case the user has set a public profile photo.

  Note: this information is approximate; it is based on where Telegram stores the current chat photo. It is accurate only in case the owner has set the chat photo, otherwise it will be the DC assigned to the administrator who set the current profile photo.

  Returns null | number

defaultPermissions

• get defaultPermissions(): null | ChatPermissions

• Default chat member permissions, for groups and supergroups.

  Returns null | ChatPermissions

displayName

• get displayName(): string

• Get the display name of the chat.

  Title for groups and channels, name (and last name if available) for users

  Returns string

emojiStatus

• get emojiStatus(): null | EmojiStatus

• Chat's emoji status, if any.

  Returns null | EmojiStatus

firstName

• get firstName(): null | string

• First name of the other party in a private chat, for private chats and bots

  Returns null | string

hasContentProtection

• get hasContentProtection(): boolean

• Whether this group has content protection (i.e. disabled forwards)

  Returns boolean

hasJoinRequests

• get hasJoinRequests(): boolean

• Whether this group is a channel/supergroup with join requests enabled

  Returns boolean

hasJoinToSend

• get hasJoinToSend(): boolean

• Whether this group is a supergroup with join-to-send rule enabled

  Returns boolean

hasProfileSignatures

• get hasProfileSignatures(): boolean

• Whether this channel has profile signatures (i.e. "Super Channel")

  Returns boolean

id

• get id(): number

• Marked ID of this chat

  Returns number

inputPeer

• get inputPeer(): TypeInputPeer

• Chat's input peer for advanced use-cases.

  Note: for min chats, this method will return mtcute.dummyInputPeerMin*, which are actually not a valid input peer, These are used to indicate that the user is incomplete, and a message reference is needed to resolve the peer.

  Such objects are handled by TelegramClient.resolvePeer method, so prefer using it whenever you need an input peer.

  Returns TypeInputPeer

isAdmin

• get isAdmin(): boolean

• Whether current user has admin rights in this chat. Supergroups, channels and groups only.

  Returns boolean

isContact

• get isContact(): boolean

• Whether this peer is your contact

  Returns boolean

isCreator

• get isCreator(): boolean

• Whether this chat is owned by the current user. Supergroups, channels and groups only

  Returns boolean

isFake

• get isFake(): boolean

• Whether this chat has been flagged for impersonation

  Returns boolean

isForum

• get isForum(): boolean

• Whether this peer is a forum supergroup

  Returns boolean

isGroup

• get isGroup(): boolean

• Whether this chat is a group chat (i.e. not a channel and not PM)

  Returns boolean

isMember

• get isMember(): boolean

• Whether the current user is a member of the chat.

  For users, this is always true.

  Returns boolean

isMin

• get isMin(): boolean

• Whether this chat's information is incomplete.

  This usually only happens in large chats, where the server sometimes sends only a part of the chat's information. Basic info like name and profile photo are always available, but other fields may be omitted despite being available.

  For a rough list of fields that may be missing, see the official docs for channel and user.

  This currently only ever happens for non-bot users, so if you are building a normal bot, you can safely ignore this field.

  To fetch the "complete" user information, use one of these methods:

  • TelegramClient.getChat
  • TelegramClient.getFullChat.

  Learn more: Incomplete peers

  Returns boolean

isRestricted

• get isRestricted(): boolean

• Whether this chat has been restricted. See restrictions for details

  Returns boolean

isScam

• get isScam(): boolean

• Whether this chat has been flagged for scam

  Returns boolean

isSelf

• get isSelf(): boolean

• Whether this chat is chat with yourself (i.e. Saved Messages)

  Returns boolean

isSupport

• get isSupport(): boolean

• Whether this chat is part of the Telegram support team. Users and bots only

  Returns boolean

isUnavailable

• get isUnavailable(): boolean

• Whether the chat is not available (e.g. because the user was banned from there)

  Returns boolean

isVerified

• get isVerified(): boolean

• Whether this chat has been verified by Telegram. Supergroups, channels and groups only

  Returns boolean

lastName

• get lastName(): null | string

• Last name of the other party in a private chat, for private chats

  Returns null | string

permissions

• get permissions(): null | ChatPermissions

• Current user's permissions, for supergroups.

  Returns null | ChatPermissions

photo

• get photo(): null | ChatPhoto

• Chat photo, if any. Suitable for downloads only.

  If full chat information is available, prefer FullChat#fullPhoto instead.

  Returns null | ChatPhoto

profileColors

• get profileColors(): ChatColors

• Color that should be used when rendering the header of the user's profile

  If null, a generic header should be used instead

  Returns ChatColors

restrictions

• get restrictions(): null | readonly RawRestrictionReason[]

• The list of reasons why this chat might be unavailable to some users. This field is available only in case isRestricted is true

  Returns null | readonly RawRestrictionReason[]

storiesHidden

• get storiesHidden(): boolean

• Whether you have hidden (arhived) this chat's stories

  Returns boolean

storiesMaxId

• get storiesMaxId(): number

• Maximum ID of stories this chat has (or 0 if none)

  Returns number

storiesUnavailable

• get storiesUnavailable(): boolean

• Returns boolean

subscriptionUntilDate

• get subscriptionUntilDate(): null | Date

• If a subscription to this channel was bought using Telegram Stars, this field will contain the date when the subscription will expire.

  Returns null | Date

title

• get title(): null | string

• Title, for supergroups, channels and groups

  Returns null | string

user

• get user(): null | User

• Get a User from this chat.

  Returns null if this is not a chat with user

  Returns null | User

username

• get username(): null | string

• Username, for private chats, bots, supergroups and channels if available

  Returns null | string

usernames

• get usernames(): null | readonly RawUsername[]

• Usernames (inclufing collectibles), for private chats, bots, supergroups and channels if available

  Returns null | readonly RawUsername[]

mention

• mention(text?): string | MessageEntity

• Create a mention for the chat.

  If this is a user, works just like User.mention. Otherwise, if the chat has a username, a @username is created (or text link, if text is passed). If it does not, chat title is simply returned without additional formatting.

  When available and text is omitted, this method will return @username. Otherwise, text mention is created for the given (or default) parse mode

  Use null as text (first parameter) to force create a text mention with display name, even if there is a username.

  Note: This method doesn't format anything on its own. Instead, it returns a MessageEntity that can later be used with html or md template tags, or unparse method directly.

  Parameters

  • Optionaltext: null | string

    Text of the mention.

  Returns string | MessageEntity

  Example

  msg.replyText(html`Hello, ${msg.chat.mention()`)
  Copy