README

🇷🇺 Русский · 🇬🇧 English

Мульти-бот фреймворк для Telegram на Laravel: декларативная маршрутизация (команды, callback-паттерны, текстовые триггеры, произвольные типы апдейтов), движок пошаговых диалогов, встроенная авторизация и /help, доставка апдейтов через webhook или long polling — из коробки.

📖 Полная документация: Русский · English

Требования

PHP 8.3+
Laravel 12+

Установка

composer require appto-team/telegram-bot
php artisan vendor:publish --tag=telegram-bot-config
php artisan migrate

Быстрый старт

// app/GreetBot/GreetBot.php
final class GreetBot extends Bot
{
    protected function boot(): void
    {
        $this->onCommand('start', StartCommand::class);
    }
}

// app/GreetBot/Commands/StartCommand.php
final class StartCommand implements CommandHandler
{
    public function handle(UpdateContext $context): void
    {
        $context->reply('Привет! Я на связи 👋');
    }
}

// config/telegram-bot.php
'bots' => [
    'greet' => [
        'token' => env('TELEGRAM_BOT_TOKEN'),
        'webhook_secret' => env('TELEGRAM_BOT_WEBHOOK_SECRET'),
        'handler' => \App\GreetBot\GreetBot::class,
    ],
],

php artisan telegram:poll greet

Отправьте боту /start — должен прийти ответ. Дальше — команды, кнопки, клавиатуры, диалоги, права доступа и деплой через webhook подробно расписаны в документации на русском, начиная с 4. Быстрого старта.

Поддержать проект

Если пакет оказался полезен — можно поддержать разработку в крипте:

Валюта	Адрес
USDT (TRC-20)	`TWpVojBJ97h1X3JcZwAQRNEQjx7u1E3uZs`
BTC	`bc1qu592r93ch2yhwj6tw5ttctx3fg39ydem43ch3t`
ETH	`0x406F46D4c42ff77f74047Fc5672fc3Bc32ADB9d0`
TON	`UQCeqwcvE9DAjHKHPHw2MHVD-FworhAYEs8BEy56lJhfX9nr`

Лицензия

MIT

English

⬆ Русский · 🇬🇧 English

Multi-bot Telegram framework for Laravel: declarative routing (commands, callback patterns, text triggers, arbitrary update types), a step-by-step dialog engine, built-in authorization and /help, webhook and long-polling delivery — out of the box.

📖 Full documentation: English · Русский

Requirements

PHP 8.3+
Laravel 12+

Installation

composer require appto-team/telegram-bot
php artisan vendor:publish --tag=telegram-bot-config
php artisan migrate

Quick start

// app/GreetBot/GreetBot.php
final class GreetBot extends Bot
{
    protected function boot(): void
    {
        $this->onCommand('start', StartCommand::class);
    }
}

// app/GreetBot/Commands/StartCommand.php
final class StartCommand implements CommandHandler
{
    public function handle(UpdateContext $context): void
    {
        $context->reply('Hi! I\'m here 👋');
    }
}

// config/telegram-bot.php
'bots' => [
    'greet' => [
        'token' => env('TELEGRAM_BOT_TOKEN'),
        'webhook_secret' => env('TELEGRAM_BOT_WEBHOOK_SECRET'),
        'handler' => \App\GreetBot\GreetBot::class,
    ],
],

php artisan telegram:poll greet

Send /start to the bot — you should get a reply. Commands, buttons, keyboards, dialogs, permissions and webhook deployment are covered in full in the English documentation, starting with 4. Quick start.

Support the project

If this package has been useful, you can support development with crypto:

Currency	Address
USDT (TRC-20)	`TWpVojBJ97h1X3JcZwAQRNEQjx7u1E3uZs`
BTC	`bc1qu592r93ch2yhwj6tw5ttctx3fg39ydem43ch3t`
ETH	`0x406F46D4c42ff77f74047Fc5672fc3Bc32ADB9d0`
TON	`UQCeqwcvE9DAjHKHPHw2MHVD-FworhAYEs8BEy56lJhfX9nr`

License

MIT

appto-team / telegram-bot

Maintainers

Package info

Fund package maintenance!

Statistics

Security