Telegram Bot PHP SDK

Telegram Bot API PHP SDK

Welcome to the Telegram Bot SDK developer hub. You'll find comprehensive guides and documentation to help you start working with Telegram Bot SDK as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Getting Started

This page will help you get started with Telegram Bot SDK. You'll be up and running in a jiffy!

Star the Repo Star the Project Join PHPChat for Support! Latest Version Build Status Total Downloads



Telegram Bot API is an HTTP-based interface created for developers keen on building bots for Telegram.

To learn how to create and set up a bot, please consult the Introduction to Bots and Bot FAQ on official Telegram site.

Telegram Bot API - PHP SDK

This is an Unofficial Telegram Bot API SDK for PHP language. Lets you develop Telegram Bots easily! Supports Laravel out of the box.

Please review the official documentation of Telegram Bot API to understand the usage better.

Key Features of this SDK:

  • No.1 SDK for PHP language.
  • Recommended by Telegram.
  • Multi-Bot Support.
  • Commands Handler System.
  • Easy to Get Started and Use.
  • Helper Methods to Ease Development.
  • Actively Maintained & Developed.
  • Complete API Methods Support.
  • Laravel Support out of the box!
  • Clean, Highly Documented & Industry Standard Code.
  • PSR Standards.
  • Popular & Widely Used.
  • Powered by Laravel Collection API for Response Objects.
  • Events / Plugin Support to Extend Features. (Coming Soon!)
  • Conversational Support. (Coming Soon!)
  • Well-Designed, Tested & Built.
  • Active support from the author as well as the community.
  • Live support in Slack chat.


  • PHP 5.5+
  • Composer
  • Telegram Bot API Access Token - Talk to @BotFather and generate one.
  • Laravel 5 or Lumen Installation (Optional only if you want to use with either of these frameworks).


The recommended way to install the SDK is with Composer. Composer is a dependency management tool for PHP that allows you to declare the dependencies your project needs and installs them into your project.

curl -sS | php

You can add the SDK as a dependency using the composer.phar CLI:

php composer.phar require irazasyed/telegram-bot-sdk ^2.0

Or if you already have composer installed globally, then simply execute:

composer require irazasyed/telegram-bot-sdk ^2.0

Alternatively, you can specify the SDK as a dependency in your project's existing composer.json file:

    "require": {
      "irazasyed/telegram-bot-sdk": "^2.0"

After installing, you need to require Composer's autoloader if you want to use the library standalone:

require 'vendor/autoload.php';

You can find out more on how to install Composer, configure autoloading, and other best-practices for defining dependencies at

Laravel Additional Steps

If you're using Laravel and would like to use the SDK with it, then follow the below instructions. Otherwise, you can skip this part.

Step 1: Add the Service Provider

Open config/app.php and, to your providers array at the bottom, add:


Step 2: Add Facade (Optional)

Optionally add an alias to make it easier to use the library. Open config/app.php and, to your "aliases" array at the bottom, add:

'Telegram'  => Telegram\Bot\Laravel\Facades\Telegram::class

Step 3: Publish Configuration File

Open your terminal window and fire the following command to publish config file to your config directory:

php artisan vendor:publish --provider="Telegram\Bot\Laravel\TelegramServiceProvider"


php artisan vendor:publish

The former command publishes config file for just this package and the latter publishes vendor config files for other packages too. Depending on what you want to do, you can use any (Doesn't really matter).

Are You Using Telegram Bot SDK?

Submit Your Bot!

If you're using this SDK to build your Telegram Bots, We'd love to know and share the bot with the world. Tell us about it - here

Check out the Who's Using Telegram Bot SDK wiki page to know more about what people have been building with this SDK.


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



This project and its author is neither associated nor affiliated with Telegram in any way.

See License section for more details.


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

Additional Information

The library takes advantage of the amazing Laravel Collection API to automatically map the data.

So it's a lot easier to work with the array of data. Supports all the methods listed on the official docs.

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


Shoutout to JetBrains for providing a license for their amazing product PhpStorm to develop and maintain this SDK. Go check their products and buy a license :)

Getting Started

This page will help you get started with Telegram Bot SDK. You'll be up and running in a jiffy!

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.