devbx / telegram

v10.3 2026-09-29 17:10 UTC

Requires

• php: >=8.0

MIT

• Kubeev Ruslan

Published on Packagist.org on 2026-09-29 17:22 UTC

README

This PHP library provides a convenient and easy-to-use interface for interacting with the Telegram Bot API. It is designed to be used with the Bitrix CMS or the GuzzleHTTP client.

Features

• Easy Integration: Seamlessly integrates with Bitrix CMS and GuzzleHTTP client.

• Full API Coverage: Supports all Telegram Bot API 10.3 methods.

• Customizable: Easily extendable and customizable to fit your specific needs.

• Typed: PHPStan level 7 clean; method parameters are documented as array shapes, fields as typed properties.

• AI-ready: llms.txt (usage guide) and llms-full.txt (every method and type with PHP types) are shipped with the package — point Claude Code or another coding agent to vendor/devbx/telegram/llms.txt.

Installation

You can install the package via Composer:

composer require devbx/telegram

Usage

Bitrix CMS

use DevBX\Telegram;

$client = new Telegram\BitrixClient([
    'token' => '1234567890:zzz', //API token obtained from @BotFather
    'client_options' => [ // Bitrix client options
        'disableSslVerification' => false
    ]
]);

$result = $client->sendPhoto([
    'chat_id' => 1234567890,
    'photo' => [
        'filename' => 'media.jpg',
        'resource' => fopen('media.jpg', 'r'),
        'contentType' => 'image/jpeg',
    ],
]);

echo $result->messageId."\n";

foreach ($result->photo as $photo) {
    echo "File ID - {$photo->fileId}\nWidth - {$photo->width}\nHeight - {$photo->height}\nFile size - {$photo->fileSize}\n\n";
}

Guzzle Http

use DevBX\Telegram;

$client = new \DevBX\Telegram\GuzzleClient([
    'token' => '1234567890:zzz', //API token obtained from @BotFather
    'client_options' => [ // Guzzle client options
        'verify' => false
    ]
]);

$result = $client->sendPhoto([
    'chat_id' => 1234567890,
    'photo' => [
        'filename' => 'media.jpg',
        'resource' => fopen('media.jpg', 'r'),
        'contentType' => 'image/jpeg',
    ],
]);

echo $result->messageId."\n";

foreach ($result->photo as $photo) {
    echo "File ID - {$photo->fileId}\nWidth - {$photo->width}\nHeight - {$photo->height}\nFile size - {$photo->fileSize}\n\n";
}

Using a Local Bot API Server

https://core.telegram.org/bots/api#using-a-local-bot-api-server

Bitrix

use DevBX\Telegram;

$client = new Telegram\BitrixClient([
    'token' => '1234567890:zzz', //API token obtained from @BotFather
    'api_url' => 'http://localhost:8081/bot'
]);

$client->sendMessage([
    'chat_id' => '1234567890',
    'text' => 'message from Local Bot API Server'
]);

Guzzle Http

use DevBX\Telegram;

$client = new Telegram\GuzzleClient([
    'token' => '1234567890:zzz', //API token obtained from @BotFather
    'api_url' => 'http://localhost:8081/bot'
]);

$client->sendMessage([
    'chat_id' => '1234567890',
    'text' => 'message from Local Bot API Server'
]);

Getting updates from WebHook

use DevBX\Telegram;

$result = Telegram\Api::getWebhookUpdate();

foreach ($result as $updateType => $update) {
    if (!is_object($update))
        continue;

    switch ($updateType)
    {
        case 'message':
            /* @var Telegram\Types\Message $update */
            
            echo "Message from: {$update->from->id}\nText: {$update->text}\n";
            
            break;
    }
}