PHPackages                             telegram-bot-sdk/telegram-bot-sdk - 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. telegram-bot-sdk/telegram-bot-sdk

ActiveLibrary[API Development](/categories/api)

telegram-bot-sdk/telegram-bot-sdk
=================================

The Telegram Bot API PHP SDK

v3.1.0(6y ago)32480.5k↓22.9%41[8 issues](https://github.com/telegram-bot-sdk/telegram-bot-sdk/issues)[1 PRs](https://github.com/telegram-bot-sdk/telegram-bot-sdk/pulls)BSD-3-ClausePHPPHP ^7.2CI failing

Since Jun 30Pushed 2mo ago16 watchersCompare

[ Source](https://github.com/telegram-bot-sdk/telegram-bot-sdk)[ Packagist](https://packagist.org/packages/telegram-bot-sdk/telegram-bot-sdk)[ Docs](https://github.com/irazasyed/telegram-bot-sdk)[ RSS](/packages/telegram-bot-sdk-telegram-bot-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (5)Versions (19)Used By (0)

[![Telegram Bot SDK](https://user-images.githubusercontent.com/1915268/75023827-7879f780-54be-11ea-98c1-436a14e7e633.png)](https://github.com/telegram-bot-sdk/telegram-bot-sdk)

[![Join PHP Chat](https://camo.githubusercontent.com/76c0bc03501852383181f4653670530cc4c382321d1653c684b7330114c6949e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f536c61636b2d504850253230436861742d3563366161612e7376673f6c6f676f3d736c61636b266c6162656c436f6c6f723d344131353442267374796c653d666f722d7468652d6261646765)](https://phpchat.co)[![Chat on Telegram](https://camo.githubusercontent.com/d58747d0cb915aa20266c3dff6b73bc6a1194b0b33d0da2c0585160dc3dee9b1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436861742d6f6e25323054656c656772616d2d3243413545302e7376673f6c6f676f3d74656c656772616d267374796c653d666f722d7468652d6261646765)](https://t.me/PHPChatCo)[![Build Status](https://camo.githubusercontent.com/535214035af6c03771be6b595bbf896c4fed48564d0a025705bc2a58722e1a59/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f74656c656772616d2d626f742d73646b2f74656c656772616d2d626f742d73646b2f63692e796d6c3f7374796c653d666f722d7468652d6261646765)](https://github.com/telegram-bot-sdk/telegram-bot-sdk/actions)[![Latest Version](https://camo.githubusercontent.com/9d55f032136d28f78af999bf1f5ad4ae8e2c27696ae08e271d3b444d07f3ccb4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f74656c656772616d2d626f742d73646b2f74656c656772616d2d626f742d73646b2e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/telegram-bot-sdk/telegram-bot-sdk/releases)[![Total Downloads](https://camo.githubusercontent.com/0cbca8afdc482e5f1bd7a56c1817718f259e857d59cdeaee826d1cf5e6c8b2c5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f74656c656772616d2d626f742d73646b2f74656c656772616d2d626f742d73646b2e7376673f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/telegram-bot-sdk/telegram-bot-sdk)

Telegram Bot API - PHP SDK
==========================

[](#telegram-bot-api---php-sdk)

> [Telegram Bot SDK](https://telegram-bot-sdk.com) lets you develop Telegram Bots in PHP easily! Supports [Laravel](https://github.com/telegram-bot-sdk/laravel) framework and comes with addons to enhance your bot development experience.
>
> [Telegram Bot API](https://core.telegram.org/bots) is an HTTP-based interface created for developers keen on building bots for Telegram.
>
> To learn more about the Telegram Bot API, please consult the [Introduction to Bots](https://core.telegram.org/bots) and [Bot FAQ](https://core.telegram.org/bots/faq) on Telegram's official site.
>
> To get started writing your bots using **[Telegram Bot SDK](https://telegram-bot-sdk.com)**, please refer the [SDK Documentation](https://telegram-bot-sdk.com/docs/).
>
> **NOTE:** SDK has been migrated from the original repo [irazasyed/telegram-bot-sdk](https://github.com/irazasyed/telegram-bot-sdk) since **4.x**.

Usage
-----

[](#usage)

Documentation for the SDK can be found on the [website](https://telegram-bot-sdk.com/docs/).

Upgrade from version <4.x
----------------------------

[](#upgrade-from-version-4x)

Starting from version 4.x, the project has been renamed from `irazasyed/telegram-bot-sdk` to `telegram-bot-sdk/telegram-bot-sdk`.

In order to receive the new version and future updates, **you need to rename it in your composer.json**:

```
"require": {
-    "irazasyed/telegram-bot-sdk": "(version you use)",
+    "telegram-bot-sdk/telegram-bot-sdk": "(version you use)",
}
```

### Laravel

[](#laravel)

Laravel service provider in addition to various other Laravel specific features have been moved to its own package.

```
"require": {
-    "irazasyed/telegram-bot-sdk": "(version you use)",
+    "telegram-bot-sdk/laravel": "^4.0",
}
```

and run `composer update`.

Are You Using Telegram Bot SDK?
-------------------------------

[](#are-you-using-telegram-bot-sdk)

If you're using this SDK to build your Telegram Bots or have a project that's relevant to this SDK, We'd love to know and share it with the world.

Head over to [Awesome Telegram Bots](https://github.com/telegram-bot-sdk/awesome-telegram-bots) to share, discover, and learn more.

Contributing
------------

[](#contributing)

Thank you for considering contributing to the project. Please read [the contributing guide](https://telegram-bot-sdk.com/community/contributing) before creating an issue or sending in a pull request.

Code of Conduct
---------------

[](#code-of-conduct)

Please read our [Code of Conduct](https://telegram-bot-sdk.com/community/code-of-conduct) before contributing or engaging in discussions.

Security
--------

[](#security)

If you discover a security vulnerability within this project, please email Syed at `security at telegram-bot-sdk.com`. All security vulnerabilities will be promptly addressed. You may view our full security policy [here](https://github.com/telegram-bot-sdk/telegram-bot-sdk/security/policy).

Credits
-------

[](#credits)

- [Irfaq Syed](https://github.com/irazasyed)
- [SDK Team](https://github.com/orgs/telegram-bot-sdk/people)
- [All Contributors](https://github.com/telegram-bot-sdk/telegram-bot-sdk/contributors)

Disclaimer
----------

[](#disclaimer)

The Telegram Bot SDK is a third-party library and is not associated with, endorsed by, or affiliated with Telegram or its products. For more details, please read the [Disclaimer](https://telegram-bot-sdk.com/license/#disclaimer)

License
-------

[](#license)

This project is open-sourced software licensed under the [BSD 3-Clause](https://github.com/telegram-bot-sdk/telegram-bot-sdk/blob/master/LICENSE.md) license.

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance55

Moderate activity, may be stable

Popularity49

Moderate usage in the ecosystem

Community30

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 74.5% 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 ~188 days

Recently: every ~520 days

Total

17

Last Release

960d ago

Major Versions

v0.2.6 → v1.0.02015-09-07

v1.0.0 → v2.0.02015-12-27

v2.2.0 → v3.0.02018-01-19

v2.3.0 → v3.1.02020-04-11

2.x-dev → 3.x-dev2023-10-01

PHP version history (4 changes)v0.1.0PHP >=5.5.0

v3.0.0PHP ^7.0

v2.3.0PHP >=5.6.0

v3.1.0PHP ^7.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1915268?v=4)[Irfaq Syed](/maintainers/irazasyed)[@irazasyed](https://github.com/irazasyed)

---

Top Contributors

[![irazasyed](https://avatars.githubusercontent.com/u/1915268?v=4)](https://github.com/irazasyed "irazasyed (631 commits)")[![jonnywilliamson](https://avatars.githubusercontent.com/u/2513663?v=4)](https://github.com/jonnywilliamson "jonnywilliamson (168 commits)")[![ihoru](https://avatars.githubusercontent.com/u/361908?v=4)](https://github.com/ihoru "ihoru (8 commits)")[![imanghafoori1](https://avatars.githubusercontent.com/u/6961695?v=4)](https://github.com/imanghafoori1 "imanghafoori1 (4 commits)")[![filipekiss](https://avatars.githubusercontent.com/u/48519?v=4)](https://github.com/filipekiss "filipekiss (4 commits)")[![alies-dev](https://avatars.githubusercontent.com/u/5278175?v=4)](https://github.com/alies-dev "alies-dev (4 commits)")[![halaei](https://avatars.githubusercontent.com/u/7089140?v=4)](https://github.com/halaei "halaei (3 commits)")[![autowp](https://avatars.githubusercontent.com/u/2299280?v=4)](https://github.com/autowp "autowp (2 commits)")[![e4se](https://avatars.githubusercontent.com/u/20152014?v=4)](https://github.com/e4se "e4se (2 commits)")[![sloothword](https://avatars.githubusercontent.com/u/7378822?v=4)](https://github.com/sloothword "sloothword (2 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (2 commits)")[![lptn](https://avatars.githubusercontent.com/u/150333538?v=4)](https://github.com/lptn "lptn (1 commits)")[![rkhitin](https://avatars.githubusercontent.com/u/1931291?v=4)](https://github.com/rkhitin "rkhitin (1 commits)")[![setnemo](https://avatars.githubusercontent.com/u/7947055?v=4)](https://github.com/setnemo "setnemo (1 commits)")[![shkoliar](https://avatars.githubusercontent.com/u/7448756?v=4)](https://github.com/shkoliar "shkoliar (1 commits)")[![trckster](https://avatars.githubusercontent.com/u/22098050?v=4)](https://github.com/trckster "trckster (1 commits)")[![alexsoft](https://avatars.githubusercontent.com/u/1451894?v=4)](https://github.com/alexsoft "alexsoft (1 commits)")[![vokamut](https://avatars.githubusercontent.com/u/4266448?v=4)](https://github.com/vokamut "vokamut (1 commits)")[![aliraghebi](https://avatars.githubusercontent.com/u/21082113?v=4)](https://github.com/aliraghebi "aliraghebi (1 commits)")[![alr2413](https://avatars.githubusercontent.com/u/10116275?v=4)](https://github.com/alr2413 "alr2413 (1 commits)")

---

Tags

botchatbotchatbot-telegramchatbotscomposer-packagehacktoberfestlaravelphpphp-libraryphp-sdktelegramtelegram-bottelegram-bot-apitelegram-bot-frameworktelegram-bot-sdktelegram-botstelegram-phplaraveltelegramtelegram bottelegram bot apitelegram sdktelegram phplaravel telegram

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[irazasyed/telegram-bot-sdk

The Unofficial Telegram Bot API PHP SDK

3.3k4.5M84](/packages/irazasyed-telegram-bot-sdk)[exileed/telegram-bot-api

The Telegram Bot API PHP

1514.1k](/packages/exileed-telegram-bot-api)

PHPackages © 2026

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