README

Простой и типобезопасный PHP-клиент для работы с Max Bot API. Позволяет легко отправлять сообщения, обрабатывать обновления и работать с вложениями через объекты.

✨ Особенности

• Объектно-ориентированный интерфейс для сообщений, вложений и кнопок
• Поддержка фабрик: Attachment::image(...), Link::reply(...)
• Поддержка:
  • Текстовых сообщений с форматированием (markdown, html).
  • Кнопок: callback, link, request_contact и др.
  • Вложений: фото, видео, файлы, геолокация, контакты
  • Ответов на сообщения (reply) и пересылки (forward)
• Совместимость с Laravel

📦 Установка

В .env файле добавьте:

MAX_BOT_TOKEN="Токен бота"

В папке вашего проекта выполните установку:

composer require maxkhim/laravel-max-messenger-api-client

Выполнить проверку корректности установки:

php artisan max-bot:check

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

Отправка сообщения

use Maxkhim\MaxMessengerApiClient\Bot\Messages\Message; 
use Maxkhim\MaxMessengerApiClient\Bot\Messages\Attachments\Attachment; 

$message = Message::message('Привет, мир!') 
    ->addAttachment( Attachment::location(64.529183, 40.54926) ) 
    ->addAttachment( 
        Attachment::inlineKeyboard
         [ 
             [ 
                Attachment::callbackButton('Нажми меня', 'btn_1'), 
                Attachment::callbackButton('Нажми меня ещё раз', 'btn_2'), 
             ], 
             [ 
                Attachment::linkButton('Мой GitHub', 'https://github.com/maxkhim'), 
             ]
         ]
    );

2. Обработка входящих обновлений

🧰 Возможности

Кнопки

Вложения

Ответ на сообщение