README

Telegram adapter for the laravel-bootdesk multi-platform messaging framework.

Install

composer require bootdesk/chat-sdk-adapter-telegram

Requires a PSR-18 HTTP client (guzzlehttp/guzzle, symfony/http-client, etc.) and a PSR-17 factory (nyholm/psr7 bundled).

Configuration

Variable	Description	Example
`bot_token`	Telegram Bot Token (from @BotFather)	`123456:ABC-DEF...`
`http_client`	PSR-18 HTTP client instance	`new GuzzleHttp\Client`
`secret_token`	Webhook secret token	`my-secret...`

use BootDesk\ChatSDK\Telegram\TelegramAdapter;

$adapter = new TelegramAdapter(
    botToken: env('TELEGRAM_BOT_TOKEN'),
    httpClient: new \GuzzleHttp\Client,
    secretToken: env('TELEGRAM_SECRET_TOKEN'),
);

Laravel

The ChatServiceProvider auto-binds Psr\Http\Client\ClientInterface to GuzzleHttp\Client. Add to config/chat.php:

'telegram' => [
    'bot_token'    => env('TELEGRAM_BOT_TOKEN'),
    'secret_token' => env('TELEGRAM_SECRET_TOKEN'),
],

Quick Example

// Post a message to a chat
$adapter->postMessage('telegram:123456789', 'Hello from laravel-bootdesk!');

// Post in a topic forum
$adapter->postMessage('telegram:-100123456789:42', 'Topic message');

Thread ID Format

Format	Description
`telegram:{chatId}`	Direct message or group chat
`telegram:{chatId}:{messageThreadId}`	Topic within a forum

Webhook

Telegram sends updates via webhook. Verify requests using the secret_token parameter set during webhook registration.

Feature Matrix

Feature	Supported
Post messages	✓
Edit messages	✓
Delete messages	✓
Reactions	✓
Typing indicator	✓
Fetch messages	✓
Fetch thread info	✓
Fetch channel info	✓
Get user	✓
Open DM	✓
Stream	✓

Notes

Supports inline keyboards, bot commands, group chats, and topic forums.

License

MIT

bootdesk / chat-sdk-adapter-telegram

Maintainers

Package info

Statistics

Security