https://github.com/appleboy/telegram-action

GitHub Action that sends a Telegram message.
https://github.com/appleboy/telegram-action

github-actions telegram telegram-bot

Last synced: 21 days ago
JSON representation

GitHub Action that sends a Telegram message.

• Host: GitHub
• URL: https://github.com/appleboy/telegram-action
• Owner: appleboy
• License: mit
• Created: 2019-02-16T15:23:57.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-10-24T11:26:29.000Z (about 2 years ago)
• Last Synced: 2024-05-21T07:35:00.495Z (6 months ago)
• Topics: github-actions, telegram, telegram-bot
• Language: Dockerfile
• Homepage: https://github.com/marketplace/actions/telegram-message-notify
• Size: 2 MB
• Stars: 781
• Watchers: 7
• Forks: 104
• Open Issues: 26
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-actions - Send a Telegram Message
• fucking-awesome-actions - Send a Telegram Message
• awesome-workflows - Send a Telegram Message

README

        
# 🚀 Telegram for GitHub Actions

[GitHub Action](https://github.com/features/actions) for sending a Telegram notification message.

![notification](./images/telegram-notification.png)

[![Actions Status](https://github.com/appleboy/telegram-action/workflows/telegram%20message/badge.svg)](https://github.com/appleboy/telegram-action/actions)

## Usage

**NOTE**: If you are getting "Error: Chat not found", then you need to look at this stackoverflow's answer [here](https://stackoverflow.com/a/41291666).

Send custom message and see the custom variable as below.

```yml

name: telegram message

on: [push]

jobs:

  build:

    name: Build

    runs-on: ubuntu-latest

    steps:

      - name: send telegram message on push

        uses: appleboy/telegram-action@master

        with:

          to: ${{ secrets.TELEGRAM_TO }}

          token: ${{ secrets.TELEGRAM_TOKEN }}

          message: |

            ${{ github.actor }} created commit:

            Commit message: ${{ github.event.commits[0].message }}

            

            Repository: ${{ github.repository }}

            

            See changes: https://github.com/${{ github.repository }}/commit/${{github.sha}}

```

Remove `args` to send the default message.

```yml

- name: send default message

  uses: appleboy/telegram-action@master

  with:

    to: ${{ secrets.TELEGRAM_TO }}

    token: ${{ secrets.TELEGRAM_TOKEN }}

```

![workflow](./images/telegram-workflow.png)

## Input variables

* socks5 - optional. support socks5 proxy URL

* photo - optional. photo message

* document - optional. document message

* sticker - optional. sticker message

* audio - optional. audio message

* voice - optional. voice message

* location - optional. location message

* venue - optional. venue message

* video - optional. video message

* debug - optional. enable debug mode

* format - optional. `markdown` or `html`. See [MarkdownV2 style](https://core.telegram.org/bots/api#markdownv2-style)

* message - optional. custom message

* message_file - optional. overwrite the default message template with the contents of the specified file.

* disable_web_page_preview - optional. disables link previews for links in this message. default is `false`.

* disable_notification - optional. disables notifications for this message, supports sending a message without notification. default is `false`.

## Example

send photo message:

```yml

- uses: actions/checkout@master

- name: send photo message

  uses: appleboy/telegram-action@master

  with:

    to: ${{ secrets.TELEGRAM_TO }}

    token: ${{ secrets.TELEGRAM_TOKEN }}

    message: send photo message

    photo: tests/github.png

    document: tests/gophercolor.png

```

send location message:

```yml

- name: send location message

  uses: appleboy/telegram-action@master

  with:

    to: ${{ secrets.TELEGRAM_TO }}

    token: ${{ secrets.TELEGRAM_TOKEN }}

    location: '24.9163213 121.1424972'

    venue: '35.661777 139.704051 竹北體育館 新竹縣竹北市'

```

send message using custom proxy (support `http`, `https`, and `socks5`) like `socks5://127.0.0.1:1080` or `http://222.124.154.19:23500`

```yml

- name: send message using socks5 proxy URL

  uses: appleboy/telegram-action@master

  with:

    to: ${{ secrets.TELEGRAM_TO }}

    token: ${{ secrets.TELEGRAM_TOKEN }}

    socks5: "http://222.124.154.19:23500"

    message: Send message from socks5 proxy URL.

```

## Secrets

Getting started with [Telegram Bot API](https://core.telegram.org/bots/api).

* `token`: Telegram authorization token.

* `to`: Unique identifier for this chat.

How to get unique identifier from telegram api:

```bash

curl https://api.telegram.org/bot/getUpdates

```

See the result: (get chat id like `65382999`)

```json

{

  "ok": true,

  "result": [

    {

      "update_id": 664568113,

      "message": {

        "message_id": 8423,

        "from": {

          "id": 65382999,

          "is_bot": false,

          "first_name": "Bo-Yi",

          "last_name": "Wu (appleboy)",

          "username": "appleboy46",

          "language_code": "en"

        },

        "chat": {

          "id": 65382999,

          "first_name": "Bo-Yi",

          "last_name": "Wu (appleboy)",

          "username": "appleboy46",

          "type": "private"

        },

        "date": 1550333434,

        "text": "?"

      }

    }

  ]

}

```

## Template variable

| Github Variable   | Telegram Template Variable |

|-------------------|----------------------------|

| GITHUB_REPOSITORY | repo                       |

| GITHUB_ACTOR      | repo.namespace             |

| GITHUB_SHA        | commit.sha                 |

| GITHUB_REF        | commit.ref                 |

| GITHUB_WORKFLOW   | github.workflow            |

| GITHUB_ACTION     | github.action              |

| GITHUB_EVENT_NAME | github.event.name          |

| GITHUB_EVENT_PATH | github.event.path          |

| GITHUB_WORKSPACE  | github.workspace           |