Описание
Этот объект содержит полную информацию о чате.
| Поле | Тип | Описание |
|---|---|---|
| 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 - Объект, описывающий географическое местоположение, связанное с чатом, включая координаты и адрес.