Skip to content

Commit

Permalink
chore: update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
ethyaan committed Jun 18, 2023
1 parent c56361b commit 0acc352
Showing 1 changed file with 45 additions and 2 deletions.
47 changes: 45 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,45 @@
# tgate-action
A Github action plugin to send notification to telegram
# GitHub Action: Telegram Event Notifier

This GitHub Action sends GitHub events as messages to a Telegram chat or channel or group or a specific topic in a group or thread.

## Usage

To use this GitHub Action, you need to have a Telegram bot token and a chat ID.

1. Create a new Telegram bot by talking to the [BotFather](https://t.me/BotFather) on Telegram and follow the instructions to obtain the bot token.

2. Find out the chat ID where you want to receive the event messages. You can use the [getUpdates](https://core.telegram.org/bots/api#getupdates) API method or search for the bot username in the Telegram app to get the chat ID.

3. In your GitHub repository, create a new workflow file (e.g., `.github/workflows/telegram-event-notifier.yml`) and define the following:

```yaml
name: Telegram Gate

on:
issue_comment:
types: created
issues:
types: [opened, edited, pinned, closed, reopened, assigned, labeled]
pull_request:
types:
[opened, closed, edited, ready_for_review, review_requested, reopened]
pull_request_review_comment:
types: created
push:

jobs:
build:
name: Telegram Gate
runs-on: ubuntu-latest

steps:
- name: Notifier
uses: ethyaan/tgate-action
if: always()
with:
token: ${{ secrets.token }} # savethe bot token at settings/secrets with name: token
to: ${{ secrets.to }} # save your chat id at settings/secrets with name: chat
thread_id: ${{secrets.threadid}} # set this for sending message in thread or group topic
disable_web_page_preview: false # set this to true to disable link previw in telegram
disable_notification: false # set tjis true to send message in silet mode
```

0 comments on commit 0acc352

Please sign in to comment.