telegram-bot-sdk is a free, open source ai interaction & interfaces project written in PHP and released under BSD-3-Clause. It has 3,298 GitHub stars, 675 forks and 29 open issues, and was last pushed 2 months ago. On this registry it ranks #84 of 156 tracked projects in AI Interaction & Interfaces, with 5 head-to-head comparisons available.

What is telegram-bot-sdk?

Telegram Bot SDK is a PHP library for building Telegram bots against the HTTP-based Telegram Bot API, with Laravel support available out of the box.

What it is

Telegram Bot SDK is a PHP SDK distributed through Composer that wraps the Telegram Bot API, the HTTP-based interface Telegram provides for building bots. It targets PHP applications and ships with first-class integration for the Laravel framework, reflected in its package topics covering laravel, laravel-package and laravel-telegram. The project is released under the BSD 3-Clause licence, credits Irfaq Syed as author alongside its contributors, and states plainly that it is neither associated nor affiliated with Telegram itself. Documentation lives on its own site at telegram-bot-sdk.com, and the README points developers at the official Telegram bot introduction and Bot FAQ for API background.

The concrete problem it solves is the raw plumbing of talking to the Bot API. Without an SDK, a PHP developer writes HTTP calls, assembles request payloads by hand, and wires all of that into the framework's own conventions. This SDK replaces that manual layer with PHP-native building blocks, and the Laravel integration means a Laravel project does not need bespoke glue code to get started. It is the PHP-and-Laravel answer to the same job other bot frameworks do in other languages, and the topic list marks it as part of the Composer package ecosystem rather than a standalone binary or hosted service.

Key capabilities

  • Build Telegram bots in PHP against the HTTP-based Telegram Bot API.
  • Laravel support out of the box, tagged with laravel, laravel-package and laravel-telegram.
  • Installed and versioned as a Composer package, following the conventions of that ecosystem.
  • Version 3.x is the current supported release; 2.x is marked unsupported but retains full documentation.
  • Version 4.x is in development in a separate repository, telegram-bot-sdk/telegram-bot-sdk.
  • Backward-incompatible changes are rarely made, to keep upgrades manageable for existing users.
  • Public issue tracker on GitHub for issues, feedback, suggestions and questions.

Who uses it and how

  • PHP developers who need to author Telegram bots without hand-writing Bot API HTTP calls.
  • Laravel teams that want bot functionality inside an existing Laravel application rather than as a separate service.
  • Bot authors already running 3.x, who are expected to track only the latest released version because older releases are not supported.
  • Projects still on 2.x, which must plan an upgrade path since that line is unsupported but fully documented.
  • Contributors submitting pull requests, who are directed to review the project's CONTRIBUTING guidelines first.
  • Teams wanting visibility for their bot work, invited to list projects on the companion Awesome Telegram Bots repository.

The registry record shows 3,302 stars, 677 forks and 29 open issues, which indicates an active but not enormous user base relative to larger framework projects, with a single credited maintainer at the core.

Getting started

Installation is through Composer, and the README directs developers to the documentation at telegram-bot-sdk.com to begin writing bots; the same site hosts versioned docs, with 2.x documentation complete and 3.x documentation still in progress.

How it compares

The facts provided do not name any paid products this project replaces, and no competing PHP SDK is named either, so within this registry it stands alone as the PHP and Laravel SDK for the Telegram Bot API, with botkit appearing only as a topic tag rather than as a documented alternative. Its differentiators from generic bot frameworks are therefore the language and framework fit rather than a licensing contrast, since it is BSD-3-Clause rather than commercial.

When to use it โ€” and when not to

Pick it when the bot is a PHP or Laravel project and the current 3.x line is acceptable. Avoid it if you need stable, complete documentation for the version you are installing, since the 3.x docs are still marked in progress, or if you depend on the 2.x line, which is explicitly unsupported. Note also that 4.x has no documentation yet and lives in a separate repository, so it is not a production choice today.

project readme (upstream, from github) โ€” read inline

Telegram Bot API PHP SDK

Join PHP Chat Chat on Telegram Build Status Latest Version Total Downloads

Telegram Bot API - PHP SDK

Telegram Bot PHP SDK lets you develop Telegram Bots in PHP easily! Supports Laravel out of the box.

Telegram Bot API 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 and Bot FAQ on official Telegram site.

To get started writing your bots using this SDK, Please refer the documentation.

Supported Versions

Only the latest released version of the SDK is supported. To facilitate upgrades, we rarely make backward-incompatible changes.

Version Supported Documentation
2.x โŒ โœ… docs
3.x โœ… (current) ๐Ÿšง docs
4.x โœ… (in development) โŒ

Documentation

Documentation for the SDK can be found on the website.

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 to share, discover, and learn more.

Additional information

Any issues, feedback, suggestions or questions please use issue tracker here.

Contributing

Thank you for considering contributing to the project. Please review the CONTRIBUTING guidelines before submitting any pull requests.

Credits

Thanks

Thanks to these companies for providing access to their products that have been very useful in developing this SDK. Please go check them out!

1Password

Disclaimer

This project and its author are neither associated nor affiliated with Telegram in any way. Please see the License for more details.

License

This project is released under the BSD 3-Clause License.

Frequently asked questions

Is telegram-bot-sdk free to use?

telegram-bot-sdk is open source under the BSD-3-Clause licence. There is no licence fee and no seat count โ€” you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does telegram-bot-sdk do?

๐Ÿค– Telegram Bot API PHP SDK. Lets you build Telegram Bots easily! Supports Laravel out of the box.

What is telegram-bot-sdk written in?

telegram-bot-sdk is primarily written in PHP. Its source is publicly available at https://github.com/irazasyed/telegram-bot-sdk, and it has 3,298 GitHub stars.