Описание
Этот объект представляет собой одну специальную сущность в текстовом сообщении. Например, хэштеги, имена пользователей, URL-адреса и т.д.
| Поле | Тип | Описание |
|---|---|---|
| type | String | Тип сущности. В настоящее время может быть "mention" (@username), "hashtag" (#hashtag или #hashtag@chatusername), "cashtag" ($USD или $USD@chatusername), "bot_command" (/start@jobs_bot), "url" (https://telegram.org), "email" (do-not-reply@telegram.org), "phone_number" (+1-212-555-0123), "bold" (жирный текст), "italic" (курсивный текст), "underline" (подчёркнутый текст), "strikethrough" (зачёркнутый текст), "spoiler" (спойлер), "blockquote" (блочная цитата), "expandable_blockquote" (свёрнутая по умолчанию блочная цитата), "code" (строка моноширинного шрифта), "pre" (блок моноширинного шрифта), "text_link" (для кликабельных текстовых URL-адресов), "text_mention" (для пользователей без имён пользователей), "custom_emoji" (для встроенных пользовательских эмодзи-стикеров) |
| offset | Integer | Смещение в UTF-16 кодовых единицах до начала сущности |
| length | Integer | Длина сущности в UTF-16 кодовых единицах |
| url | String | Необязательный. Только для "text_link", URL-адрес, который откроется после нажатия пользователем на текст |
| user | User | Необязательный. Только для "text_mention", упомянутый пользователь |
| language | String | Необязательный. Только для "pre", язык программирования текста сущности |
| custom_emoji_id | String | Необязательный. Только для "custom_emoji", уникальный идентификатор пользовательского эмодзи. Используйте getCustomEmojiStickers для получения полной информации о стикере |
Примеры
json
{
"type": "text_link",
"offset": 10,
"length": 8,
"url": "https://telegram.org"
}История изменений
- API 2.0. Добавлен объект MessageEntity
- API 2.1.. Обновлен объект MessageEntity: Добавлено поле user и новое значение text_mention для поля type
- API 4.0. Обновлен объект MessageEntity: Добавлены новые типы cashtag и phone_number
- API 4.5. Обновлен объект MessageEntity: Добавлены два новых типа: underline и strikethrough. Добавлена поддержка вложенных объектов MessageEntity
- API 4.6. Обновлен объект MessageEntity: Добавлено опциональное поле language
- API 5.6. Обновлен объект MessageEntity: Добавлен новый тип "spoiler"
- API 6.2. Обновлен объект MessageEntity: Добавлен новый тип 'custom_emoji' и поле custom_emoji_id
- API 7.11. Обновлен объект MessageEntity: Добавлена поддержка хэштегов и кэштегов с указанным именем чата
Дополнительно
- User - Объект, представляющий пользователя или бота Telegram с основной информацией и настройками.
- getCustomEmojiStickers - Метод для получения информации о пользовательских эмодзи-стикерах по их идентификаторам.