{"id":29340887,"url":"https://github.com/bushlanovdev/max-bot-api-client-php","last_synced_at":"2026-05-20T16:40:36.179Z","repository":{"id":303261241,"uuid":"1014885616","full_name":"BushlanovDev/max-bot-api-client-php","owner":"BushlanovDev","description":"🤖💬 Max Bot API Client library for PHP","archived":false,"fork":false,"pushed_at":"2026-04-17T17:22:33.000Z","size":341,"stargazers_count":41,"open_issues_count":1,"forks_count":11,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-04-17T19:26:22.563Z","etag":null,"topics":["api","bot","laravel","laravel-package","library","max-bot","max-messenger","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BushlanovDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-06T15:45:53.000Z","updated_at":"2026-04-17T17:22:06.000Z","dependencies_parsed_at":"2025-07-06T17:38:19.633Z","dependency_job_id":"d8d9d227-4f1e-47db-a7a3-e688f59ab434","html_url":"https://github.com/BushlanovDev/max-bot-api-client-php","commit_stats":null,"previous_names":["bushlanovdev/max-bot-api-client-php"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/BushlanovDev/max-bot-api-client-php","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BushlanovDev%2Fmax-bot-api-client-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BushlanovDev%2Fmax-bot-api-client-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BushlanovDev%2Fmax-bot-api-client-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BushlanovDev%2Fmax-bot-api-client-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BushlanovDev","download_url":"https://codeload.github.com/BushlanovDev/max-bot-api-client-php/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BushlanovDev%2Fmax-bot-api-client-php/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33267134,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-20T15:12:43.734Z","status":"ssl_error","status_checked_at":"2026-05-20T15:12:42.300Z","response_time":356,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","bot","laravel","laravel-package","library","max-bot","max-messenger","php"],"created_at":"2025-07-08T08:12:20.213Z","updated_at":"2026-05-20T16:40:36.174Z","avatar_url":"https://github.com/BushlanovDev.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Max Messenger Bot API Client library for PHP\n\n[![Actions status](https://github.com/BushlanovDev/max-bot-api-client-php/actions/workflows/ci.yml/badge.svg?style=flat-square)](https://github.com/BushlanovDev/max-bot-api-client-php/actions)\n[![Coverage](https://raw.githubusercontent.com/BushlanovDev/max-bot-api-client-php/refs/heads/master/.github/badge-coverage.svg?v=2)](https://github.com/BushlanovDev/max-bot-api-client-php/actions)\n[![Packagist Version](https://img.shields.io/packagist/v/bushlanov-dev/max-bot-api-client-php.svg?style=flat-square)](https://packagist.org/packages/bushlanov-dev/max-bot-api-client-php)\n[![PHP version](https://img.shields.io/badge/php-%3E%3D%208.3-8892BF.svg?style=flat-square)](https://github.com/BushlanovDev/max-bot-api-client-php)\n[![Laravel](https://img.shields.io/badge/%20Laravel%20Package-available-success?logo=laravel\u0026style=flat-square)](https://github.com/BushlanovDev/max-bot-api-client-php)\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE)\n\n\u003e [!CAUTION]  \n\u003e На мой взгляд `Max Messenger` является ни чем иным как малварью, созданной для слежки за гражданами РФ. Настоятельно\n\u003e не рекомендую использовать его на реальных устройствах, с настоящим номером телефона, и для личной переписки.  \n\u003e Обязательно к прочтению - [Месседжер MAX следит за пользователями VPN](https://habr.com/ru/articles/1006666/)\n\n## Быстрый старт\n\n\u003e Если вы новичок, то можете прочитать [официальную документацию](https://dev.max.ru/), написанную разработчиками Max.\n\n### Получение токена\n\nОткройте диалог с [MasterBot](https://max.ru/MasterBot), следуйте инструкциям и создайте нового бота. После создания\nбота MasterBot отправит вам токен.\n\n### Установка библиотеки\n\n```bash\ncomposer require bushlanov-dev/max-bot-api-client-php\n```\n\nПользователи Laravel могут зарегистрировать сервис провайдер и фасад в `config/app.php`:\n\n```php\n'providers' =\u003e [\n    // ...\n    BushlanovDev\\MaxMessengerBot\\Laravel\\MaxBotServiceProvider::class,\n],\n// ...\n'aliases' =\u003e [\n    // ...\n    'MaxBot' =\u003e BushlanovDev\\MaxMessengerBot\\Laravel\\MaxBotFacade::class,\n],\n```\n\n### Использование\n\nОтправка сообщения с клавиатурой\n\n```php\nrequire __DIR__.'/vendor/autoload.php';\n\nuse BushlanovDev\\MaxMessengerBot\\Api;\n\n$api = new Api('YOUR_BOT_API_TOKEN');\n\n// Загрузка файла\n$fileAttachmentRequest = $api-\u003euploadAttachment(\n    type: UploadType::File,\n    filePath: __DIR__ . '/test.pdf',\n);\n\n$api-\u003esendMessage(\n    userId: 123,     // ID пользователя получателя сообщения\n    chatId: 321,     // Или ID чата, в который нужно отправить сообщение\n    text: 'Привет!', // Текст сообщения, вы можете использовать HTML или Markdown\n    attachments: [\n        $fileAttachmentRequest,\n        new InlineKeyboardAttachmentRequest([\n            [new CallbackButton('Нажми меня!', 'payload_button1')],\n            [new LinkButton('Нажми меня!', 'https://example.com')],\n        ]),\n    ],\n    format: MessageFormat::Markdown, // Формат сообщения (Markdown или HTML)\n);\n```\n\nОтправка сообщения с использованием фасада Laravel\n\n```php\nMaxBot::sendUserMessage(123456, 'Привет из Laravel!');\n```\n\nСоздание универсального обработчика обновлений\n\n```php\n$dispatcher = $api-\u003egetUpdateDispatcher();\n\n$dispatcher-\u003eonMessageCreated(function (MessageCreatedUpdate $update, Api $api) {\n    $api-\u003esendMessage(\n        userId: $update-\u003emessage-\u003erecipient-\u003euserId,\n        text: 'Привет!',\n    );\n});\n// или\n$dispatcher-\u003eaddHandler(UpdateType::BotStarted, function (BotStartedUpdate $update, Api $api) {\n    $api-\u003esendMessage(\n        chatId: $update-\u003echatId,\n        text: 'Я запущен!',\n    );\n});\n```\n\nПодписка на вэб хуки\n\n```php\n$api-\u003esubscribe(\n    url: 'https://example.com/webhook', // HTTPS URL на который будут приходить хуки\n    secret: 'super_secret',             // Секретная фраза для проверки хуков\n    updateTypes: [\n        // Типы хуков которые вы хотите получать (либо ничего не указывать, чтобы получать все)\n        UpdateType::BotStarted,\n        UpdateType::MessageCreated,\n    ],\n);\n```\n\nОбработка обновлений\n\n```php\n$handler = $api-\u003ecreateWebhookHandler('super_secret'); // Обновления через вебхук\n// ИЛИ\n$handler = $api-\u003ecreateLongPollingHandler();           // Обновления через лонгполлинг\n\n$handler-\u003ehandle();\n```\n\n\u003e ℹ️ С полной документацией [вы можете ознакомиться тут](./docs/README.md).\n\n## Реализованные методы\n\n#### Bots\n\n- [x] `GET /me` (`getBotInfo`) - [*Получение информации о боте.*](./docs/README.md#Получение-информации-о-боте)\n- [x] `PATCH /me` (`editBotInfo`) - [*Редактирование информации о боте.*](./docs/README.md#Редактирование-информации-о-боте)\n\n#### Chats\n\n- [x] `GET /chats` (`getChats`) - [*Получение списка всех чатов бота.*](./docs/README.md#Получение-списка-всех-чатов-бота)\n- [x] `GET /chats/{chatLink}` (`getChatByLink`) - [*Получение информации о чате по ссылке.*](./docs/README.md#Получение-информации-о-чате-по-ссылке)\n- [x] `GET /chats/{chatId}` (`getChat`) - [*Получение информации о чате по ID.*](./docs/README.md#Получение-информации-о-чате-по-ID)\n- [x] `PATCH /chats/{chatId}` (`editChat`) - [*Редактирование информации о чате.*](./docs/README.md#Редактирование-информации-о-чате)\n- [x] `DELETE /chats/{chatId}` (`deleteChat`) - [*Удаление чата.*](./docs/README.md#Удаление-чата)\n- [x] `POST /chats/{chatId}/actions` (`sendAction`) - [*Отправка действия в чат (например, \"печатает...\").*](./docs/README.md#Отправка-действия-в-чат)\n- [x] `GET /chats/{chatId}/pin` (`getPinnedMessage`) - [*Получение закрепленного сообщения.*](./docs/README.md#Получение-закрепленного-сообщения)\n- [x] `PUT /chats/{chatId}/pin` (`pinMessage`) - [*Закрепление сообщения.*](./docs/README.md#Закрепление-сообщения)\n- [x] `DELETE /chats/{chatId}/pin` (`unpinMessage`) - [*Открепление сообщения.*](./docs/README.md#Открепление-сообщения)\n- [x] `GET /chats/{chatId}/members/me` (`getMembership`) - [*Получение информации о членстве бота в чате.*](./docs/README.md#Получение-информации-о-членстве-бота-в-чате)\n- [x] `DELETE /chats/{chatId}/members/me` (`leaveChat`) - [*Выход бота из чата.*](./docs/README.md#Выход-бота-из-чата)\n- [x] `GET /chats/{chatId}/members/admins` (`getAdmins`) - [*Получение администраторов чата.*](./docs/README.md#Получение-администраторов-чата)\n- [x] `POST /chats/{chatId}/members/admins` (`addAdmins`) - [*Назначение администраторов чата.*](./docs/README.md#Назначение-администраторов-чата)\n- [x] `DELETE /chats/{chatId}/members/admins/{userId}` (`deleteAdmin`) - [*Снятие прав администратора.*](./docs/README.md#Снятие-прав-администратора)\n- [x] `GET /chats/{chatId}/members` (`getMembers`) - [*Получение участников чата.*](./docs/README.md#Получение-участников-чата)\n- [x] `POST /chats/{chatId}/members` (`addMembers`) - [*Добавление участников в чат.*](./docs/README.md#Добавление-участников-в-чат)\n- [x] `DELETE /chats/{chatId}/members` (`deleteMember`) - [*Удаление участника из чата.*](./docs/README.md#Удаление-участника-из-чата)\n\n#### Subscriptions\n\n- [x] `GET /subscriptions` (`getSubscriptions`) - [*Получение списка Webhook-подписок.*](./docs/README.md#Получение-списка-Webhook-подписок)\n- [x] `POST /subscriptions` (`subscribe`) - [*Создание Webhook-подписки.*](./docs/README.md#Создание-Webhook-подписки)\n- [x] `DELETE /subscriptions` (`unsubscribe`) - [*Удаление Webhook-подписки.*](./docs/README.md#Удаление-Webhook-подписки)\n- [x] `GET /updates` (`getUpdates`) - [*Получение обновлений через Long-Polling.*](./docs/README.md#Получение-обновлений-через-Long-Polling)\n\n#### Upload\n\n- [x] `POST /uploads` (`getUploadUrl`) - [*Получение URL для загрузки файла.*](./docs/README.md#Получение-URL-для-загрузки-файла)\n\n#### Messages\n\n- [x] `GET /messages` (`getMessages`) - [*Получение списка сообщений из чата.*](./docs/README.md#Получение-списка-сообщений-из-чата)\n- [x] `POST /messages` (`sendMessage`) - [*Отправка сообщения.*](./docs/README.md#Отправка-сообщения)\n- [x] `PUT /messages` (`editMessage`) - [*Редактирование сообщения.*](./docs/README.md#Редактирование-сообщения)\n- [x] `DELETE /messages` (`deleteMessage`) - [*Удаление сообщения.*](./docs/README.md#Удаление-сообщения)\n- [x] `GET /messages/{messageId}` (`getMessageById`) - [*Получение сообщения по ID.*](./docs/README.md#Получение-сообщения-по-ID)\n- [x] `GET /videos/{videoToken}` (`getVideoAttachmentDetails`) - [*Получение детальной информации о видео.*](./docs/README.md#Получение-детальной-информации-о-видео)\n- [x] `POST /answers` (`answerOnCallback`) - [*Ответ на нажатие callback-кнопки.*](./docs/README.md#Ответ-на-нажатие-callback-кнопки)\n\n## Лицензия\n\nДанная библиотека распространяется под лицензией MIT - подробности см. в файле [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbushlanovdev%2Fmax-bot-api-client-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbushlanovdev%2Fmax-bot-api-client-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbushlanovdev%2Fmax-bot-api-client-php/lists"}