Media & Files

This section covers all media and file-related methods available in the Telegram Bot API.

File Upload Methods

In Bots Limited (BLP), you can send media in three different ways:

By URL: Provide a direct HTTP/HTTPS URL. Telegram will download and send the file.
By File ID: If the file is already on Telegram’s servers, use its file_id.
By InputFile (Raw Bytes): Use the User.getDataFile() or similar export methods to upload raw files dynamically from your backend.

Sending Media

sendPhoto

Use this method to send photos.

BLP Example

Bot.sendPhoto(
    chat_id=u,
    photo="https://example.com/image.jpg",
    caption="Here is a **beautiful** photo!",
    parse_mode="MarkdownV2"
)

BLP Example

Bot.sendPhoto(
    chat_id=u,
    photo="AgACAgIAAxkBAAMrZN...",
    caption="Here is a photo from a file ID."
)

sendAudio

Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format.

BLP Example

Bot.sendAudio(
    chat_id=u,
    audio="https://example.com/song.mp3",
    caption="Listen to this song!",
    performer="Artist Name",
    title="Song Title"
)

sendDocument

Use this method to send general files.

BLP Example

Bot.sendDocument(
    chat_id=u,
    document="https://example.com/file.pdf",
    caption="Here is the PDF file."
)

Uploading a raw generated file using InputFile:

BLP Example

file = User.getAllDataOfUser(u, output_format="json")
Bot.sendDocument(
    chat_id=u,
    document=file,
    caption="Here is your requested data export!"
)

sendVideo

Use this method to send video files, Telegram clients support MP4 videos.

BLP Example

Bot.sendVideo(
    chat_id=u,
    video="https://example.com/video.mp4",
    caption="Check out this video!",
    supports_streaming=True
)

sendAnimation

Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound).

BLP Example

Bot.sendAnimation(
    chat_id=u,
    animation="https://example.com/animation.gif",
    caption="Funny GIF!"
)

sendVoice

Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. The audio must be in an .OGG file encoded with OPUS.

BLP Example

Bot.sendVoice(
    chat_id=u,
    voice="https://example.com/voice.ogg",
    caption="Voice message"
)

sendVideoNote

Use this method to send video messages. Telegram clients display these as rounded, square-cropped videos of up to 1 minute long.

BLP Example

Bot.sendVideoNote(
    chat_id=u,
    video_note="https://example.com/video_note.mp4",
    length=360,
    duration=60
)

sendMediaGroup

Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type.

BLP Example

media_group = [
    {"type": "photo", "media": "https://example.com/photo1.jpg"},
    {"type": "photo", "media": "https://example.com/photo2.jpg", "caption": "Album caption"}
]

Bot.sendMediaGroup(
    chat_id=u,
    media=jsondumps(media_group)
)

Editing Media

editMessageMedia

Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise.

BLP Example

new_media = {
    "type": "photo",
    "media": "https://example.com/new_photo.jpg",
    "caption": "Updated photo!"
}

Bot.editMessageMedia(
    chat_id=u,
    message_id=message.message_id,
    media=jsondumps(new_media)
)

Getting Started

Language Reference

Telegram API Methods

Core Libraries (Libs)

File Upload Methods

Sending Media

sendPhoto

sendAudio

sendDocument

sendVideo

sendAnimation

sendVoice

sendVideoNote

sendMediaGroup

Editing Media

editMessageMedia

​File Upload Methods

​Sending Media

​sendPhoto

​sendAudio

​sendDocument

​sendVideo

​sendAnimation

​sendVoice

​sendVideoNote

​sendMediaGroup

​Editing Media

​editMessageMedia

File Upload Methods

Sending Media

sendPhoto

sendAudio

sendDocument

sendVideo

sendAnimation

sendVoice

sendVideoNote

sendMediaGroup

Editing Media

editMessageMedia