README

Telegram Bot API for PHP

The package provides a simple and convenient way to interact with the Telegram Bot API.

✔️ Telegram Bot API 10.2 (July 14, 2026) is fully supported.

♻️ Zero dependencies — no third-party libraries, only native PHP.

Important

This project is developed and maintained by Sergei Predvoditelev. Community support helps keep the project actively developed and well maintained. You can support the project using the following services:

• Boosty
• CloudTips

Thank you for your support ❤️

Requirements

• PHP (64-bit) 8.2 - 8.5.

Installation

The package can be installed with Composer:

composer require phptg/bot-api

General usage

To make requests to the Telegram Bot API, you need to create an instance of the TelegramBotApi class.

use Phptg\BotApi\TelegramBotApi;

// API
$api = new TelegramBotApi(
    // Telegram bot authentication token
    '110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw',
);

Now you can use the $api instance to interact with the Telegram Bot API. Method names are the same as in the Telegram Bot API documentation. For example:

use Phptg\BotApi\Type\InputFile

// Specify a URL for outgoing webhook
$api->setWebhook('https://example.com/webhook');

// Send text message
$api->sendMessage(
    chatId: 22351, 
    text: 'Hello, world!',
);

// Send local photo
$api->sendPhoto(
    chatId: 22351, 
    photo: new InputFile('/path/to/photo.jpg'),
);

The result will be either a FailResult instance (occurring on an error) or an object of the corresponding type (occurring on success). For example:

// Result is an array of `Phptg\BotApi\Update\Update` objects
$updates = $api->getUpdates();

Documentation

TelegramBotApi

TelegramBotApi constructor parameters:

• $token (required) — Telegram bot authentication token;
• $baseUrl — the base URL for Telegram Bot API requests (default https://api.telegram.org).
• $transport — the transport to make requests to Telegram Bot API (cURL or native transport will be used by default).
• $logger — the PSR-3 compatible logger to log requests to Telegram Bot API and response handling errors. See logging for more information.

Method names are the same as in the Telegram Bot API documentation.

Files

File URL

Use TelegramBotApi::makeFileUrl() method to make a URL for downloading a file from the Telegram server. For example:

/**
 * @var \Phptg\BotApi\TelegramBotApi $api
 * @var \Phptg\BotApi\Type\File $file 
 */
 
// By `File` instance
$url = $api->makeFileUrl($file);

// By file path is taken from the Telegram response
$url = $api->makeFileUrl('photos/file_2');

File downloading

Use TelegramBotApi::downloadFile() method to download a file from the Telegram server. The method returns a DownloadedFile instance with getStream(), getBody() and saveTo() methods. For example:

/**
 * @var \Phptg\BotApi\TelegramBotApi $api
 * @var \Phptg\BotApi\Type\File $file
 */

// Get file content as string
$content = $api->downloadFile($file)->getBody();

// Get file content as stream
$stream = $api->downloadFile('photos/file_2')->getStream();

// Download and save file
$api->downloadFile($file)->saveTo('/local/path/to/file.jpg');

Guides

• Transport
• Logging
• Webhook handling
• Custom requests
• Internals

If you have any questions or problems with this package, use author telegram chat for communication.

License

The phptg/bot-api is free software. It is released under the terms of the BSD License. Please see LICENSE for more information.

Credits

The package is inspired by Botasis code originally created by Viktor Babanov.