letrams/telegram-helper

A laravel facade to interact with Telegram Bots

dev-master 2023-04-17 18:42 UTC

Requires

• php: ^8.0
• illuminate/contracts: ^8.37 || ^9.0 || ^10.0
• illuminate/http: ^8.37 || ^9.0 || ^10.0
• spatie/laravel-package-tools: ^1.9.2

Requires (Dev)

• friendsofphp/php-cs-fixer: ^v3.1
• guzzlehttp/guzzle: ^7.4
• nunomaduro/collision: ^5.10|^v6.1
• orchestra/testbench: ^6.22|^v7.1
• spatie/laravel-ray: ^1.26
• spatie/pest-plugin-snapshots: ^1.1
• spatie/x-ray: dev-main

MIT

• Mikhailo Topol

• laravel
• telegram
• letrams

README

laravel-helper создан как легкий плагин по работе с Telegram

use Letrams\TelegramHelper\Facades\Telegram;

Telegram::chat(USER_ID)
    ->html('test')
    ->send()

->setBot(TELEGRAM_TOKEN) //Задать бота в класе

Пример, как вместо отправки запроса получить массив

Telegram::chat('169473819')->html('test')->toArray();

Пример с клавиатурой

Telegram::message('hello')
    ->keyboard(Keyboard::make()->buttons([
            Button::make('Delete')->action('update')->param('id', '13'),
            Button::make('open')->url('https://laravel.test'),
    ]))->send();

Описание методов

->html('test') //вид сообщение - html
->markdown('test') // вид сообщение - markdown

->send() // отправить в ТГ
->keyboard() // создание inline клавиатуры
->toArray() // вместо отправки в тг вернуть массив
->params(["reply_markup" => ['keyboard' => [['q']]]]) // внедрение дополнительных параметров в запросов

->reply() // Ответить на сообщение
->protected() // Запретить пересылку
->silent() // Отправить без звука
->withoutPreview() // без превью

->deleteMessage() // Удалить сообщение
->edit() // Редактировать

Installation

Т.к. пакет еще не готов, а значит не подключен к packagist, поэтому установка без композера

You can install the package without composer:

Скопировать код в папку проекта

packages/telegram-helper

в composer.phar добавить

"require": {
        "letrams/laravel-helper": "*"
    },

    "repositories": [
        {
            "type": "path",
            "url": "./packages/telegram-helper"
        }
    ],

Запустить публикацию конфига в проект:

php artisan vendor:publish --tag="telegram-config"