Тип данных ChatFullInfo

Объект ChatFullInfo содержит полную информацию о чате, включая его тип, настройки, участников и дополнительные параметры.

Описание

Этот объект содержит полную информацию о чате.

Поле Тип Описание
id Integer Уникальный идентификатор этого чата. Это число может иметь более 32 значащих битов, и некоторые языки программирования могут испытывать трудности/скрытые дефекты при его интерпретации. Но оно имеет не более 52 значащих битов, поэтому для хранения этого идентификатора безопасно использовать знаковое 64-битное целое число или число двойной точности с плавающей запятой.
type String Тип чата: может быть «private», «group», «supergroup» или «channel»
title String Необязательное. Название для супергрупп, каналов и групповых чатов
username String Необязательное. Имя пользователя для приватных чатов, супергрупп и каналов, если доступно
first_name String Необязательное. Имя собеседника в приватном чате
last_name String Необязательное. Фамилия собеседника в приватном чате
is_forum True Необязательное. True, если супергруппа является форумом (включены темы)
is_direct_messages True Необязательное. True, если чат является чатом прямых сообщений канала
accent_color_id Integer Идентификатор акцентного цвета для имени чата и фонов фотографии чата, заголовка ответа и превью ссылки. Подробнее см. акцентные цвета.
max_reaction_count Integer Максимальное количество реакций, которое можно установить на сообщение в чате
photo ChatPhoto Необязательное. Фотография чата
active_usernames Array of String Необязательное. Если не пусто, список всех активных имён пользователей чата; для приватных чатов, супергрупп и каналов
birthdate Birthdate Необязательное. Для приватных чатов — дата рождения пользователя
business_intro BusinessIntro Необязательное. Для приватных чатов с бизнес-аккаунтами — введение о бизнесе
business_location BusinessLocation Необязательное. Для приватных чатов с бизнес-аккаунтами — местоположение бизнеса
business_opening_hours BusinessOpeningHours Необязательное. Для приватных чатов с бизнес-аккаунтами — часы работы бизнеса
personal_chat Chat Необязательное. Для приватных чатов — личный канал пользователя
parent_chat Chat Необязательное. Информация о соответствующем канале; только для чатов прямых сообщений
available_reactions Array of ReactionType Необязательное. Список доступных реакций, разрешённых в чате. Если опущено, то разрешены все ReactionTypeEmoji.
background_custom_emoji_id String Необязательное. Идентификатор пользовательского эмодзи, выбранного чатом для фона заголовка ответа и превью ссылки
profile_accent_color_id Integer Необязательное. Идентификатор акцентного цвета для фона профиля чата. Подробнее см. акцентные цвета профиля.
profile_background_custom_emoji_id String Необязательное. Идентификатор пользовательского эмодзи, выбранного чатом для фона своего профиля
emoji_status_custom_emoji_id String Необязательное. Идентификатор пользовательского эмодзи для статуса эмодзи чата или собеседника в приватном чате
emoji_status_expiration_date Integer Необязательное. Дата истечения срока действия статуса эмодзи чата или собеседника в приватном чате, в Unix-времени, если есть
bio String Необязательное. Биография собеседника в приватном чате
has_private_forwards True Необязательное. True, если настройки конфиденциальности собеседника в приватном чате разрешают использовать ссылки tg://user?id= только в чатах с этим пользователем
has_restricted_voice_and_video_messages True Необязательное. True, если настройки конфиденциальности собеседника ограничивают отправку голосовых и видеосообщений в приватном чате
join_to_send_messages True Необязательное. True, если пользователям необходимо присоединиться к супергруппе, прежде чем они смогут отправлять сообщения
join_by_request True Необязательное. True, если все пользователи, присоединяющиеся к супергруппе напрямую без использования пригласительной ссылки, должны быть одобрены администраторами супергруппы
description String Необязательное. Описание для групп, супергрупп и каналов
invite_link String Необязательное. Основная пригласительная ссылка для групп, супергрупп и каналов
pinned_message Message Необязательное. Самое последнее закреплённое сообщение (по дате отправки)
permissions ChatPermissions Необязательное. Права участников чата по умолчанию для групп и супергрупп
accepted_gift_types AcceptedGiftTypes Информация о типах подарков, которые принимаются чатом или соответствующим пользователем для приватных чатов
can_send_paid_media True Необязательное. True, если платные медиасообщения могут быть отправлены или пересланы в чат канала. Поле доступно только для чатов каналов.
slow_mode_delay Integer Необязательное. Для супергрупп — минимально допустимая задержка между последовательными сообщениями, отправляемыми каждым непривилегированным пользователем; в секундах
unrestrict_boost_count Integer Необязательное. Для супергрупп — минимальное количество бустов, которое непривилегированному пользователю необходимо добавить, чтобы игнорировать медленный режим и права чата
message_auto_delete_time Integer Необязательное. Время, после которого все сообщения, отправленные в чат, будут автоматически удалены; в секундах
has_aggressive_anti_spam_enabled True Необязательное. True, если в супергруппе включены агрессивные антиспам-проверки. Поле доступно только администраторам чата.
has_hidden_members True Необязательное. True, если непривилегированные пользователи могут видеть только список ботов и администраторов в чате
has_protected_content True Необязательное. True, если сообщения из чата нельзя пересылать в другие чаты
has_visible_history True Необязательное. True, если новые участники чата будут иметь доступ к старым сообщениям; доступно только администраторам чата
sticker_set_name String Необязательное. Для супергрупп — название набора стикеров группы
can_set_sticker_set True Необязательное. True, если бот может изменить набор стикеров группы
custom_emoji_sticker_set_name String Необязательное. Для супергрупп — название набора пользовательских эмодзи-стикеров группы. Пользовательские эмодзи из этого набора могут использоваться всеми пользователями и ботами в группе.
linked_chat_id Integer Необязательное. Уникальный идентификатор связанного чата, т.е. идентификатор группы обсуждения для канала и наоборот; для супергрупп и каналов. Этот идентификатор может быть больше 32 битов, и некоторые языки программирования могут испытывать трудности/скрытые дефекты при его интерпретации. Но он меньше 52 битов, поэтому для хранения этого идентификатора безопасно использовать знаковое 64-битное целое число или число двойной точности с плавающей запятой.
location ChatLocation Необязательное. Для супергрупп — местоположение, к которому привязана супергруппа

Примеры

json

{
  "id": 1234567890,
  "type": "supergroup",
  "title": "Supergroup Chat",
  "username": "supergroup_username",
  "accent_color_id": 5,
  "max_reaction_count": 10,
  "photo": {
    "small_file_id": "AQADBAADAbAABgI",
    "small_file_unique_id": "small_unique",
    "big_file_id": "AQADBAADAbAABwI",
    "big_file_unique_id": "big_unique"
  },
  "active_usernames": ["supergroup_username", "alternative_username"],
  "available_reactions": [
    {"type": "emoji", "emoji": "👍"},
    {"type": "emoji", "emoji": "❤️"},
    {"type": "custom_emoji", "custom_emoji_id": "custom_emoji_id_123"}
  ],
  "profile_accent_color_id": 7,
  "profile_background_custom_emoji_id": "profile_bg_emoji_456",
  "emoji_status_custom_emoji_id": "status_emoji_789",
  "emoji_status_expiration_date": 1698765432,
  "description": "This is a supergroup for testing purposes",
  "invite_link": "https://t.me/joinchat/AAAAA_example",
  "permissions": {
    "can_send_messages": true,
    "can_send_audios": true,
    "can_send_documents": true,
    "can_send_photos": true,
    "can_send_videos": true,
    "can_send_video_notes": true,
    "can_send_voice_notes": true,
    "can_send_polls": true,
    "can_send_other_messages": true,
    "can_add_web_page_previews": true,
    "can_change_info": false,
    "can_invite_users": true,
    "can_pin_messages": false,
    "can_manage_topics": true
  },
  "accepted_gift_types": {
    "accepts_gifts": true,
    "accepts_gifts_from_users": true,
    "accepts_gifts_from_bots": false
  },
  "slow_mode_delay": 30,
  "unrestrict_boost_count": 5,
  "message_auto_delete_time": 86400,
  "has_aggressive_anti_spam_enabled": true,
  "has_hidden_members": false,
  "has_protected_content": true,
  "has_visible_history": true,
  "sticker_set_name": "SupergroupStickers",
  "can_set_sticker_set": true,
  "custom_emoji_sticker_set_name": "SupergroupCustomEmoji",
  "linked_chat_id": -1009876543210,
  "location": {
    "location": {
      "longitude": 37.6173,
      "latitude": 55.7558
    },
    "address": "Moscow, Russia"
  },
  "is_forum": true,
  "join_to_send_messages": false,
  "join_by_request": true,
  "has_private_forwards": false,
  "has_restricted_voice_and_video_messages": false,
  "can_send_paid_media": true
}

История изменений

  • API 7.3. Добавлен объект ChatFullInfo
  • API 7.3. Обновлен объект ChatFullInfo: Добавлено поле max_reaction_count
  • API 8.3. Обновлен объект ChatFullInfo: Добавлено поле can_send_gift
  • API 9.2. Обновлен объект ChatFullInfo: Добавлены поля is_direct_messages и parent_chat
  • API 9.3. Обновлен объект ChatFullInfo: Добавлено поле rating (класс UserRating). Добавлено поле paid_message_star_count. Добавлено поле unique_gift_colors.

Дополнительно

  • ChatPhoto - Объект, содержащий информацию о фотографии чата, включая идентификаторы файлов для маленького и большого размеров.
  • Birthdate - Объект, описывающий дату рождения пользователя с указанием дня, месяца и необязательного года.
  • BusinessIntro - Объект содержит настройки приветственной страницы для Telegram Business аккаунта.
  • BusinessLocation - Объект содержит информацию о местоположении бизнес-аккаунта Telegram, включая адрес и географические координаты.
  • BusinessOpeningHours - Объект описывает график работы бизнеса с указанием часового пояса и интервалов времени.
  • Chat - Объект, представляющий чат в Telegram с его основными характеристиками и типом.
  • ReactionType - Объект, описывающий тип реакции в Telegram, который может быть эмодзи, кастомным эмодзи или платной реакцией.
  • ReactionTypeEmoji - Тип реакции, который использует эмодзи для выражения эмоций в сообщении.
  • Message - Это основной объект, представляющий сообщение в Telegram, который содержит информацию об отправителе, чате, контенте (текст, медиа, служебные данные) и различные метаданные.
  • ChatPermissions - Объект, описывающий разрешения для обычных пользователей в чате, включая отправку различных типов сообщений и другие действия.
  • AcceptedGiftTypes - Объект описывает типы подарков, которые можно отправлять пользователям или чатам в Telegram.
  • ChatLocation - Объект, описывающий географическое местоположение, связанное с чатом, включая координаты и адрес.
Комментарии