PHPackages appto-team/telegram-bot - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. appto-team/telegram-bot ActiveLibrary appto-team/telegram-bot ======================= Multi-bot Telegram framework for Laravel — dialogs, command/callback routing, webhook & long-polling delivery v0.1.2(today)03↑2900%MITPHPPHP ^8.3CI passing Since Aug 28Pushed todayCompare [ Source](https://github.com/appto-dev/telegram-bot)[ Packagist](https://packagist.org/packages/appto-team/telegram-bot)[ Docs](https://github.com/appto-dev/telegram-bot)[ Fund](https://github.com/appto-dev/telegram-bot#поддержать-проект)[ RSS](/packages/appto-team-telegram-bot/feed)WikiDiscussions main Synced today READMEChangelog (3)Dependencies (12)Versions (4)Used By (0) Appto Telegram Bot ================== [](#appto-telegram-bot) [![Cover](docs/cover.png)](docs/cover.png) [![Tests](https://github.com/appto-dev/telegram-bot/actions/workflows/tests.yml/badge.svg)](https://github.com/appto-dev/telegram-bot/actions/workflows/tests.yml)[![Laravel 12+](https://camo.githubusercontent.com/1d1f48db50881038108ec1af5787d092760dcf0e69d913b5513c7afe486f2cba/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322532422d4646324432303f6c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://laravel.com)[![License: MIT](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) 🇷🇺 Русский · [🇬🇧 English](#english) Мульти-бот фреймворк для Telegram на Laravel: декларативная маршрутизация (команды, callback-паттерны, текстовые триггеры, произвольные типы апдейтов), движок пошаговых диалогов, встроенная авторизация и `/help`, доставка апдейтов через webhook или long polling — из коробки. 📖 **Полная документация:** [Русский](docs/ru/01-introduction.md) · [English](docs/en/01-introduction.md) Требования ---------- [](#требования) - 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 подробно расписаны в [документации на русском](docs/ru/01-introduction.md), начиная с [4. Быстрого старта](docs/ru/04-quick-start.md). Поддержать проект ----------------- [](#поддержать-проект) Если пакет оказался полезен — можно поддержать разработку в крипте: ВалютаАдресUSDT (TRC-20)`TWpVojBJ97h1X3JcZwAQRNEQjx7u1E3uZs`BTC`bc1qu592r93ch2yhwj6tw5ttctx3fg39ydem43ch3t`ETH`0x406F46D4c42ff77f74047Fc5672fc3Bc32ADB9d0`TON`UQCeqwcvE9DAjHKHPHw2MHVD-FworhAYEs8BEy56lJhfX9nr`Лицензия -------- [](#лицензия) MIT --- English ------- [](#english) [⬆ Русский](#appto-telegram-bot) · 🇬🇧 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](docs/en/01-introduction.md) · [Русский](docs/ru/01-introduction.md) ### Requirements [](#requirements) - PHP 8.3+ - Laravel 12+ ### Installation [](#installation) ``` composer require appto-team/telegram-bot php artisan vendor:publish --tag=telegram-bot-config php artisan migrate ``` ### Quick start [](#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](docs/en/01-introduction.md), starting with [4. Quick start](docs/en/04-quick-start.md). ### Support the project [](#support-the-project) If this package has been useful, you can support development with crypto: CurrencyAddressUSDT (TRC-20)`TWpVojBJ97h1X3JcZwAQRNEQjx7u1E3uZs`BTC`bc1qu592r93ch2yhwj6tw5ttctx3fg39ydem43ch3t`ETH`0x406F46D4c42ff77f74047Fc5672fc3Bc32ADB9d0`TON`UQCeqwcvE9DAjHKHPHw2MHVD-FworhAYEs8BEy56lJhfX9nr`### License [](#license) MIT ### Health Score 39 — LowBetter than 84% of packages Maintenance100 Actively maintained with recent releases Popularity4 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 3 Last Release 0d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/16529443?v=4)[makhlenko](/maintainers/makhlenko)[@Makhlenko](https://github.com/Makhlenko) --- Top Contributors [![mahlenko](https://avatars.githubusercontent.com/u/45919904?v=4)](https://github.com/mahlenko "mahlenko (9 commits)") --- Tags botbot-frameworkbotkitdialogdialog-systemframeworklaravellaravel-packagesphpphp-sdksdksdk-phptelegramtelegram-bottelegram-bot-apitelegram-bot-frameworklaravellaravel-packagewebhooktelegrambot apitelegram botchatbotlong-pollingdialogsbot framework ### Code Quality TestsPHPUnit Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/appto-team-telegram-bot/health.svg) ``` [![Health](https://phpackages.com/badges/appto-team-telegram-bot/health.svg)](https://phpackages.com/packages/appto-team-telegram-bot) ``` ### Alternatives [roots/acorn Framework for Roots WordPress projects built with Laravel components. 9922.4M148](/packages/roots-acorn)[mike-bronner/laravel-model-caching Automatic caching for Eloquent models. 2.4k161.4k2](/packages/mike-bronner-laravel-model-caching)[laravel/ai The official AI SDK for Laravel. 1.1k4.6M343](/packages/laravel-ai)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k16.3M160](/packages/laravel-pulse)[psalm/plugin-laravel Psalm plugin for Laravel 3345.4M354](/packages/psalm-plugin-laravel)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 265.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)