Document

Raw MD
This object represents a general file (as opposed to photos, voice messages and audio files)

This object represents a general file (as opposed to photos, voice messages and audio files).

Fields

FieldTypeRequiredDescription
file_idStringAlwaysIdentifier for this file, which can be used to download or reuse the file
file_unique_idStringAlwaysUnique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
thumbnailPhotoSizeOptionalDocument thumbnail as defined by the sender
file_nameStringOptionalOriginal filename as defined by the sender
mime_typeStringOptionalMIME type of the file as defined by the sender
file_sizeIntegerOptionalFile size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.
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.