PHPackages                             andrew-gos/telegram-bot - 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. [API Development](/categories/api)
4. /
5. andrew-gos/telegram-bot

ActiveLibrary[API Development](/categories/api)

andrew-gos/telegram-bot
=======================

Advanced strictly typed Telegram Bot Library

4.4.2(2mo ago)21771MITPHPPHP &gt;=8.2

Since May 5Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/CiBeRHeMuL/TelegramBot)[ Packagist](https://packagist.org/packages/andrew-gos/telegram-bot)[ Docs](https://github.com/CiBeRHeMuL/TelegramBot)[ RSS](/packages/andrew-gos-telegram-bot/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (24)Versions (25)Used By (1)

Telegram Bot API Library
========================

[](#telegram-bot-api-library)

[![Latest Stable Version](https://camo.githubusercontent.com/0332e97c43769e9b3ae86c08ecebe4326511fba8f53202bf0b9856cf9a3f2f64/68747470733a2f2f706f7365722e707567782e6f72672f616e647265772d676f732f74656c656772616d2d626f742f762f737461626c65)](https://packagist.org/packages/andrew-gos/telegram-bot)[![License](https://camo.githubusercontent.com/1d3bba8932f2c7197b8b8b9a7ef2e255489e44b50388fd41fe4726279c7dc3dc/68747470733a2f2f706f7365722e707567782e6f72672f616e647265772d676f732f74656c656772616d2d626f742f6c6963656e7365)](https://packagist.org/packages/andrew-gos/telegram-bot)[![PHP Version Require](https://camo.githubusercontent.com/b9c486d3b6c9efc04dab77062050ee26e2d534845f318e365fac7254e9f85c75/687474703a2f2f706f7365722e707567782e6f72672f616e647265772d676f732f74656c656772616d2d626f742f726571756972652f706870)](https://packagist.org/packages/andrew-gos/telegram-bot)

### 🌟 Overview

[](#-overview)

This is a powerful, strictly-typed PHP library for building Telegram bots. It fully leverages the capabilities of **PHP 8.2+** and modern programming standards to make your development process fast, reliable, and enjoyable.

The library provides a complete toolset for interacting with the **Telegram Bot API**, allowing you to focus on your bot's logic rather than on low-level implementation details. At its core is a flexible update processing kernel built on `HandlerGroup`, `Checker`, and `Middleware`, ensuring exceptional modularity and extensibility.

### ✨ Key Features

[](#-key-features)

- **💯 Full API Coverage:** Supports all methods and types of the Telegram Bot API (currently version **9.4**).
- **🔒 Strict Typing:** Maximum code reliability and excellent IDE support.
- **🧩 Modern Architecture:** A flexible update handling system using `HandlerGroup`, `Checker`, and `Middleware`.
- **🔌 Extensibility:** Easily integrate your own logic through plugins and middleware.
- **🤝 PSR Compliant:** Effortless integration with any modern framework.
- **🧪 Thoroughly Tested:** High test coverage ensures stability and reliability.

### 📦 Installation

[](#-installation)

To install the library, use Composer:

```
composer require andrew-gos/telegram-bot
```

### 📚 Documentation

[](#-documentation)

To get started and explore the library's features in-depth, please refer to the following sections:

SectionDescription🚀 **[Basic Usage (BASIC.md)](README/BASIC.md)****Start here.** A step-by-step guide to creating your first bot and handling commands.⚙️ **[Advanced Usage (ADVANCED.md)](README/ADVANCED.md)**Learn about Middleware, Plugins, custom `Checkers`, and other powerful tools.🧩 **Framework Integration**• **[Symfony (SYMFONY.md)](README/SYMFONY.md)**A guide to setting up the library as a service in Symfony applications.• **[Yii2 (YII2.md)](README/YII2.md)**A guide for integrating with the Yii2 framework's DI container.### 🤝 Contributing

[](#-contributing)

Contributions are welcome and greatly appreciated! This project follows the standard GitHub fork &amp; pull request workflow.

**Reporting Bugs and Requesting Features**

- Please use the [GitHub Issues](https://github.com/CiBeRHeMuL/TelegramBot/issues) tracker to report bugs or request new features.
- When reporting a bug, please provide a clear description, steps to reproduce it, and your environment details (PHP version, library version).
- For feature requests, describe the problem you're trying to solve and your proposed solution.

**Submitting Code Changes**

1. **Fork the repository** on GitHub.
2. **Create a new branch** for your changes (e.g. `fix/message-parsing-error`).
3. **Make your changes.** Ensure your code adheres to the project's coding style.
4. **Run the code style fixer.** This project uses `php-cs-fixer`. You can apply the style rules by running: ```
    composer php-cs-fix
    ```
5. **Add or update tests.** Your pull request should include tests that cover your changes.
6. **Submit a Pull Request** to the `master` branch with a clear description of your changes.

### 📜 License

[](#-license)

This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance84

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

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 ~13 days

Total

24

Last Release

60d ago

Major Versions

2.2.1 → 3.0.02025-08-25

3.1.0 → v4.x-dev2025-09-14

### Community

Maintainers

![](https://www.gravatar.com/avatar/4b8138927f33d6978608e73d01f2c42ef975bacd471c0b3235420beffcd21c90?d=identicon)[Andrew\_gos](/maintainers/Andrew_gos)

---

Tags

phpapibottelegramtelegram botandrew-gos

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/andrew-gos-telegram-bot/health.svg)

```
[![Health](https://phpackages.com/badges/andrew-gos-telegram-bot/health.svg)](https://phpackages.com/packages/andrew-gos-telegram-bot)
```

###  Alternatives

[cakephp/cakephp

The CakePHP framework

8.8k18.5M1.6k](/packages/cakephp-cakephp)[windwalker/framework

The next generation PHP framework.

25639.1k1](/packages/windwalker-framework)[thecodingmachine/graphqlite

Write your GraphQL queries in simple to write controllers (using webonyx/graphql-php).

5723.1M30](/packages/thecodingmachine-graphqlite)[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.5k311.5k5](/packages/theodo-group-llphant)[neos/flow

Flow Application Framework

862.0M451](/packages/neos-flow)[neos/flow-development-collection

Flow packages in a joined repository for pull requests.

144179.3k3](/packages/neos-flow-development-collection)

PHPackages © 2026

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