PHPackages                             cslant/laravel-telegram-git-notifier - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail &amp; Notifications](/categories/mail)
4. /
5. cslant/laravel-telegram-git-notifier

ActiveLibrary[Mail &amp; Notifications](/categories/mail)

cslant/laravel-telegram-git-notifier
====================================

Send notification from Gitlab and GitHub events to Telegram

v1.2.0(1y ago)3949.4k↑38%8[11 issues](https://github.com/cslant/laravel-telegram-git-notifier/issues)1MITPHPPHP ^8.1CI passing

Since Nov 3Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/cslant/laravel-telegram-git-notifier)[ Packagist](https://packagist.org/packages/cslant/laravel-telegram-git-notifier)[ Docs](https://github.com/cslant/laravel-telegram-git-notifier)[ GitHub Sponsors](https://github.com/tanhongit)[ RSS](/packages/cslant-laravel-telegram-git-notifier/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (9)Versions (18)Used By (1)

Laravel Telegram GitHub/GitLab Notifier
=======================================

[](#laravel-telegram-githubgitlab-notifier)

 [![Telegram GitHub/GitLab Notifier Laravel](https://github.com/cslant/laravel-telegram-git-notifier/raw/main/resources/images/telegram-git-notifier-laravel.png)](https://github.com/cslant/laravel-telegram-git-notifier/blob/main/resources/images/telegram-git-notifier-laravel.png)

[![License](https://camo.githubusercontent.com/18f09284d5f31215962fe706c23a9f50212e6e2ceaa808a70b93284d2463c56d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f63736c616e742f6c61726176656c2d74656c656772616d2d6769742d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265)](#)[![Latest Version](https://camo.githubusercontent.com/35f0b0bca2adc9fe884330ce69bf30b744addbc67989dcb318785564b2930fce/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f63736c616e742f6c61726176656c2d74656c656772616d2d6769742d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265)](https://github.com/cslant/laravel-telegram-git-notifier/releases)[![Total Downloads](https://camo.githubusercontent.com/9ad0166dfe5ece86f1bc1be130f1358d48e5524ff53ff6ce6b1f39caa00584fc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f63736c616e742f6c61726176656c2d74656c656772616d2d6769742d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cslant/laravel-telegram-git-notifier)[![Test Status](https://camo.githubusercontent.com/b588b84ef8b0484ecc106f7b32f1bfd36771eb9d55ca03c1ff6b45cd14abfeb5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f63736c616e742f6c61726176656c2d74656c656772616d2d6769742d6e6f7469666965722f73657475705f746573742e796d6c3f6c6162656c3d7465737473266272616e63683d6d61696e)](https://github.com/cslant/laravel-telegram-git-notifier/actions/workflows/setup_test.yml)[![Code Style Status](https://camo.githubusercontent.com/aee6a2a83db25e4394c6e6ff7dab7fa481c0703443bf7250d5e66e41b6095bd9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f63736c616e742f6c61726176656c2d74656c656772616d2d6769742d6e6f7469666965722f7068702d63732d66697865722e796d6c3f6c6162656c3d636f64652532307374796c65266272616e63683d6d61696e)](https://github.com/cslant/laravel-telegram-git-notifier/actions/workflows/php-cs-fixer.yml)[![Quality Score](https://camo.githubusercontent.com/0264b59371b91cc97385661ad9abca64e2ba3db451c402c9ab81407c9e596c39/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f63736c616e742f6c61726176656c2d74656c656772616d2d6769742d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/cslant/laravel-telegram-git-notifier)

📝 Introduction
--------------

[](#-introduction)

Laravel Telegram Git Notifier is a Laravel package that allows you to create a Telegram bot to receive notifications from GitHub or GitLab events and manage customization through messages and buttons on Telegram.

- Send notifications of your GitHub/GitLab repositories to Telegram Bots, Groups, Super Groups (Multiple Topics), and Channels.
- The bot must be created using the [BotFather](https://core.telegram.org/bots#6-botfather)

📋 Requirements
--------------

[](#-requirements)

- PHP ^8.4|^8.5
- Laravel ^11.0|^12.0
- [Composer](https://getcomposer.org/)
- Core: [Telegram Git Notifier](https://github.com/cslant/telegram-git-notifier.git)

🔧 Installation
--------------

[](#-installation)

You can install this package via Composer:

```
composer require cslant/laravel-telegram-git-notifier
```

✨ What's New in v2.0
--------------------

[](#-whats-new-in-v20)

### New Features

[](#new-features)

- **Webhook Security**: `VerifyWebhookSecret` middleware with timing-safe `hash_equals()` comparison
- **Webhook Status Command**: Check webhook status via `php artisan tg-notifier:webhook:status`
- **Deferrable Provider**: Lazy-loaded service provider with singleton bindings for better performance
- **API Retry Logic**: Exponential backoff for Telegram API rate limits (HTTP 429)
- **In-Memory Caching**: Config files cached in memory with dirty flag
- **Clean Template Format**: Simplified emoji usage (single emoji per event type)

### Improvements

[](#improvements)

- PHP 8.4+ support with `readonly` classes and properties
- Full type safety with explicit return types and nullable params
- `match` expressions instead of `switch` for cleaner code
- PSR-3 `LoggerInterface` support

### Available Artisan Commands

[](#available-artisan-commands)

CommandDescription`tg-notifier:webhook:set`Set the webhook URL for your Telegram bot`tg-notifier:webhook:status`Check the current webhook status`tg-notifier:owner:config`Change owner for config JSON files🚀 Usage
-------

[](#-usage)

See the [Usage - Telegram git notifier Documentation](https://docs.cslant.com/telegram-git-notifier/usage/first_test)for a list of usage.

Please check and update some configurations in the documentation.

📖 Official Documentation
------------------------

[](#-official-documentation)

Please see the [Telegram Git Notifier Documentation](https://docs.cslant.com/telegram-git-notifier) for more information.

✨ Supported events
------------------

[](#-supported-events)

### GitHub Events Available

[](#github-events-available)

- Push
- Issues
- Issue Comment
- Pull Request
- Pull Request Review
- Fork
- Commit Comment
- Deployment
- Deployment Status
- Fork
- Workflow
- Watch

    ... and more events can be seen in the [all GitHub events available](https://docs.cslant.com/telegram-git-notifier/prologue/event-availability/github)

### GitLab Events Available

[](#gitlab-events-available)

- Push
- Tag Push
- Issue
- Merge Request
- Note
- Pipeline
- Wiki Page
- Build
- Deployment
- Release

    ... and more events can be seen in the [all GitLab events available](https://docs.cslant.com/telegram-git-notifier/prologue/event-availability/gitlab)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

📦 Changelog
-----------

[](#-changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance58

Moderate activity, may be stable

Popularity42

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 73.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~70 days

Recently: every ~187 days

Total

13

Last Release

78d ago

Major Versions

v0.0.2 → v1.0.02023-11-23

v1.2.0 → v2.0.x-dev2026-03-02

PHP version history (2 changes)v0.0.1PHP ^8.1

v2.0.x-devPHP ^8.4|^8.5

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/35853002?v=4)[Tan Nguyen](/maintainers/tanhongit)[@tanhongit](https://github.com/tanhongit)

---

Top Contributors

[![tanhongit](https://avatars.githubusercontent.com/u/35853002?v=4)](https://github.com/tanhongit "tanhongit (320 commits)")[![pxthinh](https://avatars.githubusercontent.com/u/105281722?v=4)](https://github.com/pxthinh "pxthinh (48 commits)")[![hokhacminhtri](https://avatars.githubusercontent.com/u/57437836?v=4)](https://github.com/hokhacminhtri "hokhacminhtri (13 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (12 commits)")[![LuongTienThinh](https://avatars.githubusercontent.com/u/91936861?v=4)](https://github.com/LuongTienThinh "LuongTienThinh (9 commits)")[![kenautomus](https://avatars.githubusercontent.com/u/69226680?v=4)](https://github.com/kenautomus "kenautomus (7 commits)")[![tongthanhphu](https://avatars.githubusercontent.com/u/80811290?v=4)](https://github.com/tongthanhphu "tongthanhphu (6 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (6 commits)")[![phutong99](https://avatars.githubusercontent.com/u/129131459?v=4)](https://github.com/phutong99 "phutong99 (6 commits)")[![avaelo](https://avatars.githubusercontent.com/u/127422332?v=4)](https://github.com/avaelo "avaelo (4 commits)")[![mytruong-z](https://avatars.githubusercontent.com/u/41782955?v=4)](https://github.com/mytruong-z "mytruong-z (2 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)")[![cslant-dev](https://avatars.githubusercontent.com/u/175740988?v=4)](https://github.com/cslant-dev "cslant-dev (1 commits)")

---

Tags

cslantcslant-packagegithub-eventsgithub-notificationsgithub-telegramgithub-telegram-botgitlab-notifiergitlab-telegramlaravel-telegram-notificationnotification-bottelegramtelegram-bottelegram-bot-apptelegram-github-repotelegram-notificationstelegram-notifiertelegram botnotifygit-webhooktelegram-notifiergithub-notifiergithub-telegram-botgitlab-notifiergitlab-telegram-bottelegram-bot-github-notifytelegram-bot-gitlab-notifytelegram-git-notifiercslant

###  Code Quality

TestsPest

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/cslant-laravel-telegram-git-notifier/health.svg)

```
[![Health](https://phpackages.com/badges/cslant-laravel-telegram-git-notifier/health.svg)](https://phpackages.com/packages/cslant-laravel-telegram-git-notifier)
```

###  Alternatives

[cslant/telegram-git-notifier-app

The PHP app to send notification from Gitlab and Github events to Telegram

2927.7k](/packages/cslant-telegram-git-notifier-app)[cslant/telegram-git-notifier

Send notification from Gitlab and Github events to Telegram

2384.5k6](/packages/cslant-telegram-git-notifier)[spatie/laravel-failed-job-monitor

Get notified when a queued job fails

1.0k2.6M4](/packages/spatie-laravel-failed-job-monitor)[mouse0270/bootstrap-growl

This is a simple pluging that turns standard Bootstrap alerts into "Growl-like" notifications.

2.2k119.1k](/packages/mouse0270-bootstrap-growl)[guanguans/notify

Push notification SDK(AnPush、Bark、Chanify、DingTalk、Discord、Gitter、GoogleChat、IGot、Lark、Mattermost、MicrosoftTeams、NowPush、Ntfy、Push、Pushback、PushBullet、PushDeer、PushMe、Pushover、PushPlus、QQ、RocketChat、ServerChan、ShowdocPush、SimplePush、Slack、Telegram、WeWork、WPush、XiZhi、YiFengChuanHua、ZohoCliq、ZohoCliqWebHook、Zulip).

682104.9k7](/packages/guanguans-notify)[machour/yii2-notifications

Notifications for your Yii2 app

9135.7k](/packages/machour-yii2-notifications)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
