README

Laravel package that allows you to process commands from Telegram MiniApp with user verification according to Telegram MiniApp developer documentation, as well as obtaining information about the Telegram user who sent the request

Requirements

Install

Via composer

composer require micromagicman/laravel-telegram-webapp

Publishing

Publish to your Laravel application:

php artisan vendor:publish --provider="Micromagicman\TelegramWebApp\TelegramWebAppServiceProvider"

Configure

All package configuration available in config/telegram-webapp.php file after publish command execution:

Example in code:

View

This package provides a root view for Telegram MiniApp frontend applications. Telegram WebApp script is automatically includes to this view or its inheritors if telegram-webapp.enabled switch is true

Example:

@extends('telegram-webapp::main')

@section('lang', 'CN')

@section('head')
// some scripts, css, meta
@endsection

@section('title', 'My title')

@section('content')
    <div id="app-content">
        // My spa content
    </div>
@endsection

Integration with TelegramBot\Api\BotApi

Our service integrates with TelegramBot\Api\BotApi, allowing you to access all of the methods provided by the Telegram Bot API. This integration is available either through a Facade or directly through the service.

You can find the repository for TelegramBot\Api\BotApi here.

Using the Facade

To use the Telegram Bot API methods, you can leverage the TelegramWebAppFacade facade. This provides a simple and convenient way to interact with the Telegram Bot API.

Example usage with the Facade:

use Micromagicman\TelegramWebApp\Facades\TelegramWebApp;

$response = TelegramWebApp::getMe();

This allows you to call methods like getMe(), sendMessage(), getUpdates(), and any other method from the BotApi class directly through the facade.

Using the Service Directly

You can also interact with the Telegram Bot API directly through the service. Inject the TelegramWebAppService into your components, and call the Bot API methods via the service instance.

Example usage in a controller:

use Micromagicman\TelegramWebApp\Services\TelegramWebAppService;

class MyController extends Controller
{
    protected $telegram;

    public function __construct(TelegramWebAppService $telegram)
    {
        $this->telegram = $telegram;
    }

    public function getBotInfo()
    {
        $response = $this->telegram->getMe();
        return response()->json($response);
    }
}

Both the facade and the service offer full access to the BotApi class methods, allowing you to work seamlessly with the Telegram Bot API in your Laravel application.