Skip to main content
๐Ÿค– Git Notifications via Telegram

Documentation For Telegram Git Notifier

With this package, you can create a Telegram bot to receive notifications from GitHub or GitLab events. You can use this package with Laravel or any PHP application.

TelegramGitHubGitLabBotLaravelPHP
๐Ÿ“„
0
Doc pages
๐Ÿ“ก
0
Supported event types
๐Ÿ›ฐ๏ธ
0
Platforms: GitHub + GitLab
๐Ÿš€
0
Releases shipped

โšก Key Features

Stay connected with your repositories through powerful Telegram notifications.

โšก

Real-Time Notifications

Stay informed about your project's activity without the need to constantly monitor your repository's events.

๐Ÿ”

Advanced Event Filtering

Reach 39 supported event types across GitHub (28) and GitLab (11) โ€” tailor notifications so only what matters reaches you.

๐Ÿ—จ๏ธ

Channels & Topics

Send notifications to channels, supergroup topics and multiple targets at once โ€” perfect for teams that organize by thread.

๐Ÿ”˜

Custom Commands & Buttons

Support for Telegram bot commands and inline buttons, so your bot can do more than just notify.

๐Ÿ˜

PHP 8.4+ & Laravel-ready

Works with Laravel or any plain PHP application โ€” platform enum and typed DTOs keep the API safe and easy to consume.

๐Ÿ›ก๏ธ

Resilient Delivery

Exponential backoff and retry logic handle Telegram API rate limits (HTTP 429) automatically, with optional PSR-3 logging.

Get Started in Four Steps

From installing the package to receiving your first git notification.

1

Install via Composer

The package works with Laravel or any plain PHP application.
composer require cslant/telegram-git-notifier
2

Run the installer script

Generate the configuration and credential files without navigating complex install steps.
bash vendor/cslant/telegram-git-notifier/install.sh
3

Configure your bot

Set your Telegram bot token, chat target and the event types you want to receive.
4

Set up the webhook

Register the webhook URL on your GitHub or GitLab project and let the notifications flow.

Release Timeline

How Telegram Git Notifier evolved from its first release to today.

v2.0.0 ยท 2026

PHP 8.4+ & modern architecture

Platform enum, ChatTarget DTO with thread support, in-memory config caching, PSR-3 logging and API retry logic for HTTP 429.

PHP 8.4+Type-safe
v1.5.0 ยท 2024

GitLab actions & team features

Updated GitLab event configuration and new team collaboration capabilities.

GitLab
v1.3.0 ยท 2023

Enhanced features & optimizations

install.sh integration, codebase refactoring, comprehensive tests across multiple PHP versions and chatIDs parameter for Notifier.

InstallerRefactorTests
v1.2.0 ยท 2023

Topics & bot commands

Send notifications to supergroup topics (threads), support for Telegram bot commands and custom buttons.

TopicsCommands
v1.0.0 ยท 2023

Initial release

First public release with webhook action support for GitHub and GitLab.

Webhooks

Frequently Asked Questions

Answers to the questions most often asked about Telegram Git Notifier.

Which platforms are supported?
GitHub and GitLab. The package maps 28 GitHub event types and 11 GitLab event types, configurable through typed JSON event files.
Can I use it without Laravel?
Yes. The package works with Laravel or any plain PHP application โ€” it is framework-agnostic by design.
What happens if Telegram enforces rate limits?
The package implements exponential backoff and retry logic for HTTP 429 responses, plus optional PSR-3 logging through the validator.
Do my servers need to be publicly reachable?
Yes โ€” GitHub and GitLab push webhook payloads to your endpoint, so the app must expose the webhook route publicly.
Where are event mappings defined?
Event-to-payload mappings live in the package config under config/jsons (github-events.json and gitlab-events.json) and can be customized.

Never miss a git event again

Wire your GitHub or GitLab activity straight into Telegram in minutes.