Telegram Upload

A GitHub Action to upload one or more files (e.g., .bin, .elf, logs, etc.) to a Telegram chat via a bot token. This helps streamline the distribution of build artifacts or release files to Telegram.

Usage

- uses: PonomarevDA/telegram-upload@v1
  with:
    # Your Telegram bot token.
    # Create a Telegram bot via @BotFather,
    # Go to your repository’s Settings > Secrets > Actions > New repository secret
    # Add TELEGRAM_BOT_TOKEN with the value of the token.
    bot_token: ${{ secrets.TELEGRAM_BOT_TOKEN }}

    # The ID of the Telegram chat/channel/group where files are sent.
    # This legacy input is still supported for existing workflows.
    chat_id: ${{ secrets.TELEGRAM_CHAT_ID }}

    # Optional: use target instead of chat_id to route by build type.
    # The JSON of the following format:
    # {
    #   "channel_id": <channel_id>, // this is a public channel for main/tag builds
    #   "your_github_username": <user_id> // this is your personal chat for dev builds
    #   "your_colleague_github_username": <user_id> // this is your colleague personal chat for dev builds
    # }
    # Use @get_id_bot, https://api.telegram.org/bot<token>/getUpdates to find it.
    # target: ${{ secrets.TARGET }}
    
    build_type: "dev" # one of the following: "dev", "tag", "main". Default: "dev"

    # One or more file paths or glob patterns (e.g. "build/*.bin" "my_firmware.elf")"
    files: build/release/*.bin

    # The caption text for the final file.
    # It’s appended as a caption to the last file in the media group.
    message: "Deployment from GitHub Actions"

    # If "true", automatically appends Git commit info to the message. Like this:
    # VCS commit: 75fdf50
    # Commit date: 2025-03-30
    # Author: author <email>
    # Branch: main
    # Latest Tag: v1.0.0
    # Commit history:
    # - Commit message 1
    # - Commit message 2
    add_git_info: "true"

    # If set, uses this URI for the Telegram API. Default: https://api.telegram.org
    # This can be used to increase upload file size linit from 50 MB to 2 GB.
    api_uri: "true"

    # Number of commits to include in the commit history. Default: 3
    commit_history: 3

Notes & Limitations

• Telegram’s sendMediaGroup only supports up to 10 files in a single request. If more than 10 files match, the action currently logs an error and exits.
• Telegram bot can sends file with 50 MB size limit. You can increase this limit up to 2GB if you use custom API URL.