Pavlo Popov Logo
Павел Попов Специалист по работе с подсознанием
Laravel Package · v1.3.1 · MIT

Laravel Telegram Bot

Пакет для Laravel, который позволяет создавать Telegram-ботов так же, как сайты: привычные маршруты, контроллеры, middleware и Blade-подобные шаблоны экранов.

Работает в режиме webhook или long-polling. Авторизация через гвард telegram, клавиатуры, медиа и формы с валидацией — из коробки.

GitHub Packagist Установка ↓
🧭
Маршруты
Route::telegram() — экраны бота как страницы
🧩
Blade-шаблоны
Вёрстка ответов тегами <message>, <line>
⌨️
Клавиатуры
Inline и reply, кнопки, эмодзи, web apps
🔐
Авторизация
Гвард telegram и привязка к моделям

Что это

Laravel Telegram Bot — библиотека для удобного создания Telegram-ботов по аналогии с разработкой сайтов на Laravel. Логика бота описывается знакомыми маршрутами и контроллерами, ответы верстаются специальными тегами вместо HTML, а пользователи авторизуются через отдельный гвард. Подходит для ботов любой сложности — от простых меню до многошаговых форм и личных кабинетов.

🧭

Маршрутизация

Экраны бота описываются через Route::telegram() в routes/telegram.php с автоматическим именованием маршрутов.

🧩

Шаблоны ответов

Вёрстка сообщений тегами <message>, <screen>, <line> и форматированием <b>, <i>, <code>, <a>, спойлеры.

🔐

Авторизация

Гвард telegram связывает чаты с вашими моделями через таблицу telegram_users.

⌨️

Клавиатуры

Inline и reply-клавиатуры, стили кнопок (primary/success/danger), эмодзи и web apps.

🖼️

Медиа

Отправка фото, документов, видео и голосовых через src: локальный путь, URL или file_id.

📝

Формы

Многошаговые формы с валидацией — редактирование по одному полю или целиком.

PHP
8.3, 8.4, 8.5+
Laravel
11, 12, 13+
Расширения
ext-dom
Режимы
webhook / long-polling
Установка

Установка

Через Composer, как любой Laravel-пакет

1. Установите пакет и опубликуйте ресурсы:

composer require it-healer/laravel-telegram-bot
php artisan telegram:install
php artisan vendor:publish --tag="telegram-migrations"
php artisan migrate
php artisan vendor:publish --tag="telegram-config"
php artisan vendor:publish --tag="telegram-views"

2. Подключите бота и задайте webhook:

php artisan telegram:new-bot       # подключить нового бота по токену
php artisan telegram:set-webhook   # установить webhook
php artisan telegram:pooling       # либо запустить long-polling (для разработки)

Использование

Описывайте бота так же, как маршруты сайта

Маршруты бота — routes/telegram.php

Route::telegram('/', function (TelegramRequest $request) {
    return '<message><line>You wrote: '.$request->text().'</line></message>';
})->name('home');

Route::telegram('/profile', [\App\Telegram\Controllers\ProfileController::class, 'index'])
    ->middleware('auth:telegram');

Шаблон экрана — теги вместо HTML

<message>
    <line><b>Привет!</b> Это бот на Laravel.</line>
    <line>Выберите действие в меню ниже 👇</line>
</message>

Доступны теги <message>, <screen>, <line>, <lines> и форматирование <b>, <i>, <code>, <a>, <tg-spoiler>.

Исходный код и документация

Полная документация — в репозитории на GitHub. Пакет открыт под лицензией MIT.

GitHub → Packagist
IT Healer
Павел Попов — Целитель. Биодинамист. Специалист по работе с подсознанием
Instagram YouTube TikTok Telegram Facebook WhatsApp Odnoklassniki VKontakte Rutube Viber
© 2023-2026 Все права защищены.
По вопросам обращайтесь info@it-healer.com
Записаться на сеанс