mirror of
https://github.com/appleboy/telegram-action.git
synced 2026-05-14 02:42:44 +00:00
Bo-Yi Wu
160 lines
4.0 KiB
Markdown
160 lines
4.0 KiB
Markdown
# 🚀 Telegram for GitHub Actions
|
|
|
|
[GitHub Action](https://github.com/features/actions) for sending a Telegram notification message.
|
|
|
|
|
|
|
|
[](https://github.com/appleboy/facebook-action/actions)
|
|
|
|
## Usage
|
|
|
|
Send custom message and see the custom variable as blow.
|
|
|
|
```yml
|
|
name: telegram message
|
|
on: [push]
|
|
jobs:
|
|
|
|
build:
|
|
name: Build
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- uses: actions/checkout@master
|
|
- name: send custom message with args
|
|
uses: appleboy/telegram-action@master
|
|
env:
|
|
TELEGRAM_TOKEN: ${{ secrets.TELEGRAM_TOKEN }}
|
|
TELEGRAM_TO: ${{ secrets.TELEGRAM_TO }}
|
|
with:
|
|
args: The ${{ github.event_name }} event triggered first step.
|
|
```
|
|
|
|
Remove `args` to send the default message.
|
|
|
|
```yml
|
|
- name: send default message
|
|
uses: appleboy/telegram-action@master
|
|
env:
|
|
TELEGRAM_TOKEN: ${{ secrets.TELEGRAM_TOKEN }}
|
|
TELEGRAM_TO: ${{ secrets.TELEGRAM_TO }}
|
|
```
|
|
|
|
|
|
|
|
## Input variables
|
|
|
|
* 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`
|
|
|
|
### Example
|
|
|
|
send photo message:
|
|
|
|
```yml
|
|
- uses: actions/checkout@master
|
|
- name: send photo message
|
|
uses: appleboy/telegram-action@master
|
|
with:
|
|
message: send photo message
|
|
photo: tests/github.png
|
|
document: tests/gophercolor.png
|
|
env:
|
|
TELEGRAM_TOKEN: ${{ secrets.TELEGRAM_TOKEN }}
|
|
TELEGRAM_TO: ${{ secrets.TELEGRAM_TO }}
|
|
```
|
|
|
|
send location message:
|
|
|
|
```yml
|
|
- name: send location message
|
|
uses: appleboy/telegram-action@master
|
|
with:
|
|
location: '24.9163213 121.1424972'
|
|
venue: '35.661777 139.704051 竹北體育館 新竹縣竹北市'
|
|
env:
|
|
TELEGRAM_TOKEN: ${{ secrets.TELEGRAM_TOKEN }}
|
|
TELEGRAM_TO: ${{ secrets.TELEGRAM_TO }}
|
|
```
|
|
|
|
send custom message:
|
|
|
|
```yml
|
|
- name: send custom message
|
|
uses: appleboy/telegram-action@master
|
|
env:
|
|
TELEGRAM_TOKEN: ${{ secrets.TELEGRAM_TOKEN }}
|
|
TELEGRAM_TO: ${{ secrets.TELEGRAM_TO }}
|
|
with:
|
|
message: |
|
|
The ${{ github.event_name }} event triggered final step.
|
|
echo This event is a pull request that had an assignee removed.
|
|
```
|
|
|
|
## Secrets
|
|
|
|
Getting started with [Telegram Bot API](https://core.telegram.org/bots/api).
|
|
|
|
* `TELEGRAM_TOKEN`: Telegram authorization token.
|
|
* `TELEGRAM_TO`: Unique identifier for this chat.
|
|
|
|
How to get unique identifier from telegram api:
|
|
|
|
```bash
|
|
curl https://api.telegram.org/bot<token>/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 |
|