mirror of
https://github.com/appleboy/telegram-action.git
synced 2026-05-14 02:42:44 +00:00
Compare commits
40 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 65a4c9fc42 | |||
| ee6f548104 | |||
| 62444e6582 | |||
| 406cbeb82a | |||
| a5e94a4245 | |||
| 40cbdc99a4 | |||
| ac4245365c | |||
| 06cc7371ce | |||
| b535a89bc8 | |||
| 696643cdf6 | |||
| bd65e6f3ea | |||
| 040616c1f8 | |||
| a10dfd2766 | |||
| c83985c531 | |||
| 2b5a500551 | |||
| fdf386abfa | |||
| 4e83d473fc | |||
| a14c43a7be | |||
| 82f08879c5 | |||
| f622f39b03 | |||
| 89073d4db2 | |||
| 7952082356 | |||
| 4dbe08d34a | |||
| ffc52f02f2 | |||
| 8920bdffe3 | |||
| d1f5f0e4e9 | |||
| cba7edda6f | |||
| 868c74871e | |||
| 3fb31034d1 | |||
| d753c01b96 | |||
| 6399a5ed49 | |||
| 0e92df9a00 | |||
| 2df95b048f | |||
| bd94f12bb6 | |||
| 827b11092f | |||
| dcd986dc36 | |||
| 27dde9c826 | |||
| cc178efb9f | |||
| 8b27ddeb0a | |||
| 1274de63b5 |
@@ -1,38 +0,0 @@
|
||||
workflow "Send Notification" {
|
||||
on = "push"
|
||||
resolves = [
|
||||
"Send Custom Message",
|
||||
"Send Default Message",
|
||||
"Send Photo Message",
|
||||
]
|
||||
}
|
||||
|
||||
action "Send Custom Message" {
|
||||
uses = "appleboy/telegram-action@master"
|
||||
secrets = [
|
||||
"TELEGRAM_TOKEN",
|
||||
"TELEGRAM_TO",
|
||||
]
|
||||
args = "A new commit has been pushed."
|
||||
}
|
||||
|
||||
action "Send Default Message" {
|
||||
uses = "appleboy/telegram-action@master"
|
||||
secrets = [
|
||||
"TELEGRAM_TOKEN",
|
||||
"TELEGRAM_TO",
|
||||
]
|
||||
}
|
||||
|
||||
action "Send Photo Message" {
|
||||
uses = "appleboy/telegram-action@master"
|
||||
env = {
|
||||
PHOTO = "tests/github.png"
|
||||
DOCUMENT = "tests/gophercolor.png"
|
||||
}
|
||||
secrets = [
|
||||
"TELEGRAM_TOKEN",
|
||||
"TELEGRAM_TO",
|
||||
]
|
||||
args = "send photo message."
|
||||
}
|
||||
@@ -0,0 +1,61 @@
|
||||
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
|
||||
with:
|
||||
to: ${{ secrets.TELEGRAM_TO }}
|
||||
token: ${{ secrets.TELEGRAM_TOKEN }}
|
||||
args: The ${{ github.event_name }} event triggered first step.
|
||||
|
||||
- name: send message useing with
|
||||
uses: appleboy/telegram-action@master
|
||||
with:
|
||||
to: ${{ secrets.TELEGRAM_TO }}
|
||||
token: ${{ secrets.TELEGRAM_TOKEN }}
|
||||
message: The ${{ github.event_name }} event triggered second step.
|
||||
|
||||
- name: send default message
|
||||
uses: appleboy/telegram-action@master
|
||||
with:
|
||||
to: ${{ secrets.TELEGRAM_TO }}
|
||||
token: ${{ secrets.TELEGRAM_TOKEN }}
|
||||
|
||||
- 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'
|
||||
|
||||
- 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 竹北體育館 新竹縣竹北市'
|
||||
|
||||
- name: send custom message
|
||||
uses: appleboy/telegram-action@master
|
||||
with:
|
||||
to: ${{ secrets.TELEGRAM_TO }}
|
||||
token: ${{ secrets.TELEGRAM_TOKEN }}
|
||||
message: |
|
||||
The ${{ github.event_name }} event triggered final step.
|
||||
echo This event is a pull request that had an assignee removed.
|
||||
|
||||
- name: send message file
|
||||
uses: appleboy/telegram-action@master
|
||||
with:
|
||||
to: ${{ secrets.TELEGRAM_TO }}
|
||||
token: ${{ secrets.TELEGRAM_TOKEN }}
|
||||
message_file: tests/message.txt
|
||||
+4
-12
@@ -1,16 +1,8 @@
|
||||
FROM appleboy/drone-telegram:1.4.2-linux-amd64
|
||||
|
||||
# Github labels
|
||||
LABEL "com.github.actions.name"="Telegram Notify"
|
||||
LABEL "com.github.actions.description"="Sending a Telegram message"
|
||||
LABEL "com.github.actions.icon"="message-square"
|
||||
LABEL "com.github.actions.color"="blue"
|
||||
|
||||
LABEL "repository"="https://github.com/appleboy/telegram-action"
|
||||
LABEL "homepage"="https://github.com/appleboy"
|
||||
LABEL "maintainer"="Bo-Yi Wu <appleboy.tw@gmail.com>"
|
||||
LABEL "version"="0.0.2"
|
||||
FROM appleboy/drone-telegram:1.3.4-linux-amd64
|
||||
|
||||
ADD entrypoint.sh /entrypoint.sh
|
||||
RUN chmod +x /entrypoint.sh
|
||||
|
||||
WORKDIR /github/workspace
|
||||
|
||||
ENTRYPOINT ["/entrypoint.sh"]
|
||||
|
||||
@@ -1,64 +1,102 @@
|
||||
# 🚀 Telegram for GitHub Actions
|
||||
|
||||
[GitHub Action](https://developer.github.com/actions/) for sending a Telegram notification message.
|
||||
[GitHub Action](https://github.com/features/actions) for sending a Telegram notification message.
|
||||
|
||||
<img src="./images/telegram-notification.png">
|
||||

|
||||
|
||||
[](https://github.com/appleboy/telegram-action/actions)
|
||||
|
||||
## Usage
|
||||
|
||||
Send custom message as blow
|
||||
Send custom message and see the custom variable as blow.
|
||||
|
||||
```
|
||||
action "Send Custom Message" {
|
||||
uses = "appleboy/telegram-action@master"
|
||||
secrets = [
|
||||
"TELEGRAM_TOKEN",
|
||||
"TELEGRAM_TO",
|
||||
]
|
||||
args = "A new commit has been pushed."
|
||||
}
|
||||
```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.
|
||||
|
||||
```
|
||||
action "Send Default Message" {
|
||||
uses = "appleboy/telegram-action@master"
|
||||
secrets = [
|
||||
"TELEGRAM_TOKEN",
|
||||
"TELEGRAM_TO",
|
||||
]
|
||||
}
|
||||
```yml
|
||||
- name: send default message
|
||||
uses: appleboy/telegram-action@master
|
||||
env:
|
||||
TELEGRAM_TOKEN: ${{ secrets.TELEGRAM_TOKEN }}
|
||||
TELEGRAM_TO: ${{ secrets.TELEGRAM_TO }}
|
||||
```
|
||||
|
||||
<img src="images/telegram-workflow.png">
|
||||

|
||||
|
||||
## Environment variables
|
||||
## 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
|
||||
* 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`
|
||||
* message_file - optional. overwrite the default message template with the contents of the specified file.
|
||||
|
||||
### 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 }}
|
||||
```
|
||||
action "Send photo message" {
|
||||
uses = "appleboy/telegram-action@master"
|
||||
secrets = [
|
||||
"TELEGRAM_TOKEN",
|
||||
"TELEGRAM_TO",
|
||||
]
|
||||
env = {
|
||||
PHOTO = "tests/github.png"
|
||||
}
|
||||
args = "A new commit has been pushed."
|
||||
}
|
||||
|
||||
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
|
||||
@@ -70,8 +108,8 @@ Getting started with [Telegram Bot API](https://core.telegram.org/bots/api).
|
||||
|
||||
How to get unique identifier from telegram api:
|
||||
|
||||
```
|
||||
$ curl https://api.telegram.org/bot<token>/getUpdates
|
||||
```bash
|
||||
curl https://api.telegram.org/bot<token>/getUpdates
|
||||
```
|
||||
|
||||
See the result: (get chat id like `65382999`)
|
||||
@@ -106,3 +144,17 @@ See the result: (get chat id like `65382999`)
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 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 |
|
||||
|
||||
+39
@@ -0,0 +1,39 @@
|
||||
name: 'Telegram Message Notify'
|
||||
description: 'Sending a Telegram message'
|
||||
author: 'Bo-Yi Wu'
|
||||
inputs:
|
||||
to:
|
||||
description: 'telegram user'
|
||||
token:
|
||||
description: 'telegram token'
|
||||
message:
|
||||
description: 'telegram message'
|
||||
message_file:
|
||||
description: 'overwrite the default message template with the contents of the specified file'
|
||||
photo:
|
||||
description: 'send the photo message.'
|
||||
document:
|
||||
description: 'send the document message.'
|
||||
sticker:
|
||||
description: 'send the sticker message.'
|
||||
audio:
|
||||
description: 'send the audio message.'
|
||||
voice:
|
||||
description: 'send the voice message.'
|
||||
location:
|
||||
description: 'send the location message.'
|
||||
venue:
|
||||
description: 'send the venue message.'
|
||||
video:
|
||||
description: 'send the video message.'
|
||||
debug:
|
||||
description: 'enable debug mode.'
|
||||
format:
|
||||
description: 'message format: markdown or html'
|
||||
runs:
|
||||
using: 'docker'
|
||||
image: 'Dockerfile'
|
||||
|
||||
branding:
|
||||
icon: 'message-square'
|
||||
color: 'blue'
|
||||
@@ -0,0 +1,3 @@
|
||||
Sample message loaded from file.
|
||||
|
||||
Commit msg: {{commit.message}}
|
||||
Reference in New Issue
Block a user