Skip to content

Chat

Type · TDLib 1.8.67 · d1085f9c

A chat. (Can be a private chat, basic group, supergroup, or secret chat)

Chat(
  id: int53,
  type: ChatType,
  title: string,
  photo: ChatPhotoInfo,
  accent_color_id: int32,
  background_custom_emoji_id: int64,
  upgraded_gift_colors: UpgradedGiftColors,
  profile_accent_color_id: int32,
  profile_background_custom_emoji_id: int64,
  permissions: ChatPermissions,
  last_message: Message,
  positions: list of ChatPosition,
  chat_lists: list of ChatList,
  message_sender_id: MessageSender,
  block_list: BlockList,
  has_protected_content: Bool,
  is_translatable: Bool,
  is_marked_as_unread: Bool,
  view_as_topics: Bool,
  has_scheduled_messages: Bool,
  has_welcome_messages: Bool,
  can_be_deleted_only_for_self: Bool,
  can_be_deleted_for_all_users: Bool,
  can_be_reported: Bool,
  default_disable_notification: Bool,
  unread_count: int32,
  last_read_inbox_message_id: int53,
  last_read_outbox_message_id: int53,
  unread_mention_count: int32,
  unread_reaction_count: int32,
  unread_poll_vote_count: int32,
  notification_settings: ChatNotificationSettings,
  available_reactions: ChatAvailableReactions,
  message_auto_delete_time: int32,
  emoji_status: EmojiStatus,
  background: ChatBackground,
  theme: ChatTheme,
  action_bar: ChatActionBar,
  business_bot_manage_bar: BusinessBotManageBar,
  video_chat: VideoChat,
  pending_join_requests: ChatJoinRequestsInfo,
  reply_markup_message_id: int53,
  draft_message: DraftMessage,
  client_data: string
) → Chat

id

int53

Chat unique identifier

type

ChatType

Type of the chat

title

string

Chat title

photo

ChatPhotoInfo

Chat photo; may be null

accent_color_id

int32

Identifier of the accent color for message sender name, and backgrounds of chat photo, reply header, and link preview

background_custom_emoji_id

int64

Identifier of a custom emoji to be shown on the reply header and link preview background for messages sent by the chat; 0 if none

upgraded_gift_colors

UpgradedGiftColors

Color scheme based on an upgraded gift to be used for the chat instead of accent_color_id and background_custom_emoji_id; may be null if none

profile_accent_color_id

int32

Identifier of the profile accent color for the chat's profile; -1 if none

profile_background_custom_emoji_id

int64

Identifier of a custom emoji to be shown on the background of the chat's profile; 0 if none

permissions

ChatPermissions

Actions that non-administrator chat members are allowed to take in the chat

last_message

Message

Last message in the chat; may be null if none or unknown

positions

list of ChatPosition

Positions of the chat in chat lists

chat_lists

list of ChatList

Chat lists to which the chat belongs. A chat can have a non-zero position in a chat list even if it doesn't belong to the chat list and have no position in a chat list even if it belongs to the chat list

message_sender_id

MessageSender

Identifier of a user or chat that is selected to send messages in the chat; may be null if the user can't change message sender

block_list

BlockList

Block list to which the chat is added; may be null if none

has_protected_content

Bool

True, if chat content can't be saved locally, forwarded, or copied

is_translatable

Bool

True, if translation of all messages in the chat must be suggested to the user

is_marked_as_unread

Bool

True, if the chat is marked as unread

view_as_topics

Bool

True, if the chat is a forum supergroup that must be shown in the "View as topics" mode, or Saved Messages chat that must be shown in the "View as chats"

has_scheduled_messages

Bool

True, if the chat has scheduled messages

has_welcome_messages

Bool

True, if the chat has welcome messages; for chat administrators with can_change_info administrator right only

can_be_deleted_only_for_self

Bool

True, if the chat messages can be deleted only for the current user while other users will continue to see the messages

can_be_deleted_for_all_users

Bool

True, if the chat messages can be deleted for all users

can_be_reported

Bool

True, if the chat can be reported to Telegram moderators through reportChat or reportChatPhoto

default_disable_notification

Bool

Default value of the disable_notification parameter, used when a message is sent to the chat

unread_count

int32

Number of unread messages in the chat

last_read_inbox_message_id

int53

Identifier of the last read incoming message

last_read_outbox_message_id

int53

Identifier of the last read outgoing message

unread_mention_count

int32

Number of unread messages with a mention/reply in the chat

unread_reaction_count

int32

Number of messages with unread reactions in the chat

unread_poll_vote_count

int32

Number of messages with unread poll votes in the chat

notification_settings

ChatNotificationSettings

Notification settings for the chat

available_reactions

ChatAvailableReactions

Types of reaction, available in the chat

message_auto_delete_time

int32

Current message auto-delete or self-destruct timer setting for the chat, in seconds; 0 if disabled. Self-destruct timer in secret chats starts after the message or its content is viewed. Auto-delete timer in other chats starts from the send date

emoji_status

EmojiStatus

Emoji status to be shown along with chat title; may be null

background

ChatBackground

Background set for the chat; may be null if none

theme

ChatTheme

Theme set for the chat; may be null if none

action_bar

ChatActionBar

Information about actions which must be possible to do through the chat action bar; may be null if none

business_bot_manage_bar

BusinessBotManageBar

Information about bar for managing a business bot in the chat; may be null if none

video_chat

VideoChat

Information about video chat of the chat

pending_join_requests

ChatJoinRequestsInfo

Information about pending join requests; may be null if none

reply_markup_message_id

int53

Identifier of the message from which reply markup needs to be used; 0 if there is no reply markup in the chat

draft_message

DraftMessage

A draft of a message in the chat; may be null if none

client_data

string

Application-specific data associated with the chat. (For example, the chat scroll position or local chat notification settings can be stored here.) Persistent if the message database is used