GitHub

Send GitHub repository events to Telegram.

Add the webhook

In your repository open Settings → Webhooks → Add webhook and fill the form:

Field Value
Payload URL https://thook.altr.dev/hooks/github/{unique_path}
Content type application/json
Secret The secret key from the bot
Events Let me select individual events, then pick the ones below

Save, then open the webhook and check Recent deliveries: a 202 means it works.

Supported events

  • Push
  • Check runs and check suites
  • Pages (page build)
  • Stars and watches
  • Forks
  • Branch or tag creation and deletion
  • Repository vulnerability alerts
  • Pull requests

Coming soon: issues and sponsorships. Other events, including the initial ping, are accepted and ignored.

What you get

Each notification has the same shape: the event and the service as the title, then a quote with the repository and the branch, what happened and who did it, and a button under the message that opens the event on GitHub. Texts written by a person, like an error or a description, are in italics.

📣 Push · GitHub

altrdev/thook · main
3 commits
• Fix the start message
• Add tests
• Update docs

👤 alice

[ View push ]
🟣 Pull request merged · GitHub

altrdev/thook
#31 Add rate limiting
feat/rate-limit → main

👤 alice

[ Open PR ]
🔴 Check failed · GitHub

altrdev/thook · main
build · GitHub Actions · 42s

👤 alice

[ View check ]

The button opens the push, the pull request or the check on GitHub.

Troubleshooting

  • 401 in Recent deliveries: the Secret is different from the one in the bot message.
  • Redeliver: use the Redeliver button on a past delivery to test again without a new commit.