MessageEntity

Raw MD
This object represents one special entity in a text message

This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

Fields

FieldTypeRequiredDescription
typeStringAlwaysType of the entity. Currently, can be "mention" (@username), "hashtag" (#hashtag or #hashtag@chatusername), "cashtag" ($USD or $USD@chatusername), "bot_command" (/start@jobs_bot), "url" (https://telegram.org), "email" ([email protected]), "phone_number" (+1-212-555-0123), "bold" (bold text), "italic" (italic text), "underline" (underlined text), "strikethrough" (strikethrough text), "spoiler" (spoiler message), "blockquote" (block quotation), "expandable_blockquote" (collapsed-by-default block quotation), "code" (monowidth string), "pre" (monowidth block), "text_link" (for clickable text URLs), "text_mention" (for users without usernames), "custom_emoji" (for inline custom emoji stickers), or "date_time" (for formatted date and time).
offsetIntegerAlwaysOffset in UTF-16 code units to the start of the entity
lengthIntegerAlwaysLength of the entity in UTF-16 code units
urlStringOptionalFor "text_link" only, URL that will be opened after user taps on the text
userUserOptionalFor "text_mention" only, the mentioned user
languageStringOptionalFor "pre" only, the programming language of the entity text
custom_emoji_idStringOptionalFor "custom_emoji" only, unique identifier of the custom emoji. Use getCustomEmojiStickers to get full information about the sticker.
unix_timeIntegerOptionalFor "date_time" only, the Unix time associated with the entity
date_time_formatStringOptionalFor "date_time" only, the string that defines the formatting of the date and time. See date-time entity formatting for more details.
Botlify Cloud Runtime
Credentials are auto-injected in .env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.