PHPackages belka-tech/php-vk-teams-bot - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. belka-tech/php-vk-teams-bot ActiveLibrary[API Development](/categories/api) belka-tech/php-vk-teams-bot =========================== PHP client for VK Teams Bot API (aka ICQ Bot) 0.3.0(4mo ago)3387MITPHPPHP ^8.2CI passing Since Mar 20Pushed 4mo agoCompare [ Source](https://github.com/belka-tech/php-vk-teams-bot)[ Packagist](https://packagist.org/packages/belka-tech/php-vk-teams-bot)[ RSS](/packages/belka-tech-php-vk-teams-bot/feed)WikiDiscussions master Synced 1w ago READMEChangelog (4)Dependencies (12)Versions (12)Used By (0) PHP VK Teams Bot API (aka ICQ Bot) ================================== [](#php-vk-teams-bot-api-aka-icq-bot) [![Latest Version](https://camo.githubusercontent.com/56ca7a1ef8a0ce23b994bef3923f6b3436ab309aedb038acd9fbdaccad893259/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62656c6b612d746563682f7068702d766b2d7465616d732d626f742e7376673f7374796c653d666c61742d737175617265266c6162656c3d6c617465737425323076657273696f6e)](https://packagist.org/packages/belka-tech/php-vk-teams-bot)[![Build](https://camo.githubusercontent.com/9af5b9885f5175a1c0845a9a6eeb0f2941d5d7d1108a4a01920d3c94e11e0a39/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f62656c6b612d746563682f7068702d766b2d7465616d732d626f742f74657374732e796d6c3f7374796c653d666c61742d737175617265)](https://github.com/belka-tech/php-vk-teams-bot/actions/workflows/tests.yml)[![License](https://camo.githubusercontent.com/ca1aec086009a463615963cf405d2b8b47ca1239ea1d2eaed05383bf151621b7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f62656c6b612d746563682f7068702d766b2d7465616d732d626f742e7376673f7374796c653d666c61742d737175617265)](https://github.com/belka-tech/php-vk-teams-bot/blob/master/LICENSE) Introduction ------------ [](#introduction) PHP client for VK Teams Bot API. Provides a typed interface for sending messages, managing chats, and receiving events via long polling. Official documentation: Requirements ------------ [](#requirements) - PHP 8.2+ - PSR-18 HTTP Client (`psr/http-client`) - PSR-17 HTTP Factories (`psr/http-factory`) - PSR-3 Logger (`psr/log`) — optional, for `LoggingHttpClient` Installation ------------ [](#installation) ``` composer require belka-tech/php-vk-teams-bot ``` Quick Start ----------- [](#quick-start) ``` $bot = new \BelkaTech\VkTeamsBot\Bot( new \BelkaTech\VkTeamsBot\Http\HttpClient( baseUri: 'https://api.icq.net/bot', token: 'YOUR_BOT_TOKEN', client: new \GuzzleHttp\Client( [ 'connect_timeout' => 4, 'timeout' => 15, 'http_errors' => false, ], ), requestFactory: new \GuzzleHttp\Psr7\HttpFactory(), streamFactory: new \GuzzleHttp\Psr7\HttpFactory(), ), ); // Send a text message $bot->messages->sendText( chatId: 'YOUR_CHAT_ID', text: 'Hello!', ); ``` API --- [](#api) ### Messages (`$bot->messages`) [](#messages-bot-messages) MethodDescription`sendText()`Send a text message`sendFile()`Send a file`sendVoice()`Send a voice message`editText()`Edit a message`deleteMessages()`Delete messages`answerCallbackQuery()`Answer a callback query`pinMessage()`Pin a message`unpinMessage()`Unpin a message`filesGetInfo()`Get file information### Chats (`$bot->chats`) [](#chats-bot-chats) MethodDescription`create()`Create a chat`addMembers()`Add members`removeMembers()`Remove members`sendAction()`Send an action (typing, etc.)`getInfo()`Get chat information`getAdmins()`List administrators`getMembers()`List members`blockUser()`Block a user`unblockUser()`Unblock a user`resolvePending()`Approve/reject join requests`setTitle()`Set chat title`setAvatar()`Set chat avatar`setAbout()`Set chat description`setRules()`Set chat rules### Events API (`$bot->events`) [](#events-api-bot-events) MethodDescription`get()`Fetch events (long polling)### Event Listener [](#event-listener) Long polling with event dispatching: ``` $botEventListener = new \BelkaTech\VkTeamsBot\BotEventListener( bot: $bot, ); // Register event handlers $botEventListener->onMessage( function ( \BelkaTech\VkTeamsBot\Bot $bot, \BelkaTech\VkTeamsBot\Event\EventDto $event, ): void { $bot->messages->sendText( chatId: $event->payload['chat']['chatId'], text: 'Pong!', ); }, ); $botEventListener->onCommand( '/start', function ( \BelkaTech\VkTeamsBot\Bot $bot, \BelkaTech\VkTeamsBot\Event\EventDto $event, ): void { // handle /start command }, ); // Start long polling (must be called after all handlers are registered) $botEventListener->listen( pollTime: 30, onException: function ( \Exception $exception, \BelkaTech\VkTeamsBot\Event\EventDto $event ): void { // Log the error $this->logger->error('Some text', [ 'event_id' => $event->eventId, 'event_type' => $event->type, 'event_payload' => $event->payload, 'exception' => $exception, ]); error_log($exception->getMessage()); // Or catch exception to an error reporting system $this->sentry->captureException($exception); // On exception loop continues, // you can re-throw the exception to force stop the loop throw $exception; }, ); // Stop the listener programmatically (e.g. from a handler) $botEventListener->stop(); ``` MethodDescription`onCommand()`Register a command handler`onMessage()`Handle new messages`onEditedMessage()`Handle edited messages`onDeletedMessage()`Handle deleted messages`onPinnedMessage()`Handle pinned messages`onUnpinnedMessage()`Handle unpinned messages`onNewChatMember()`Handle new chat members`onLeftChatMember()`Handle members leaving`onCallbackQuery()`Handle callback queries`listen()`Start long polling`stop()`Stop the listenerIf the `pcntl` extension is available, `SIGTERM` and `SIGINT` signals are handled automatically for graceful shutdown. Without `pcntl`, use `$botEventListener->stop()` from a handler to stop the loop. ### Keyboard [](#keyboard) ``` $keyboard = new \BelkaTech\VkTeamsBot\Keyboard\Keyboard(); $keyboard->addRow([ new \BelkaTech\VkTeamsBot\Keyboard\Button( text: 'OK', callbackData: 'confirm', style: \BelkaTech\VkTeamsBot\Enum\ButtonStyleEnum::Primary, ), new \BelkaTech\VkTeamsBot\Keyboard\Button( text: 'Cancel', callbackData: 'cancel', style: \BelkaTech\VkTeamsBot\Enum\ButtonStyleEnum::Attention, ), ]); $bot->messages->sendText( chatId: '123456', text: 'Confirm?', inlineKeyboardMarkup: $keyboard, ); ``` ### LoggingHttpClient [](#logginghttpclient) Decorator for a PSR-18 client that logs requests and responses: ``` $loggingClient = new \BelkaTech\VkTeamsBot\Http\LoggingHttpClient( $psrHttpClient, $psrLogger, ); ``` Parse Mode ---------- [](#parse-mode) `HTML` is used by default. You can switch to `MarkdownV2`: ``` $bot = new \BelkaTech\VkTeamsBot\Bot( httpClient: $httpClient, parseMode: \BelkaTech\VkTeamsBot\Enum\ParseModeEnum::MarkdownV2, ); ``` You can also specify `parseMode` for an individual message: ``` $bot->messages->sendText( chatId: '123456', text: '**bold**', parseMode: \BelkaTech\VkTeamsBot\Enum\ParseModeEnum::MarkdownV2, ); ``` Development ----------- [](#development) ``` make setup # build image, start container, install dependencies make test # run tests make phpstan # run static analysis make shell # enter the container ``` Other commands: `make up`, `make down`, `make build`, `make install`. Alternatives ------------ [](#alternatives) - - - - License ------- [](#license) - `PHP VK Teams Bot` package is open-sourced software licensed under the [MIT license](LICENSE) by [BelkaCar](https://belkacar.ru). ### Health Score 39 — LowBetter than 84% of packages Maintenance75 Regular maintenance activity Popularity21 Limited adoption so far Community6 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 4 Last Release 138d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b3fddc40462126bbc119e373ed6a3f942a90a400f30c076c447c0625b841c4ef?d=identicon)[antonkomarev](/maintainers/antonkomarev) --- Top Contributors [![antonkomarev](https://avatars.githubusercontent.com/u/1849174?v=4)](https://github.com/antonkomarev "antonkomarev (13 commits)") --- Tags bot-apiicqicq-botmailru-teamsphp-botvk-botvk-bot-apivk-teamsvk-teams-botvk-workspace ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/belka-tech-php-vk-teams-bot/health.svg) ``` [![Health](https://phpackages.com/badges/belka-tech-php-vk-teams-bot/health.svg)](https://phpackages.com/packages/belka-tech-php-vk-teams-bot) ``` ### Alternatives [tempest/framework The PHP framework that gets out of your way. 2.3k37.6k19](/packages/tempest-framework)[flow-php/flow PHP ETL - Extract Transform Load - Data processing framework 86337.5k](/packages/flow-php-flow)[cakephp/cakephp The CakePHP framework 8.9k20.0M1.8k](/packages/cakephp-cakephp)[drupal/core-recommended Locked core dependencies; require this project INSTEAD OF drupal/core. 6943.5M443](/packages/drupal-core-recommended)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.5k6.0M766](/packages/sylius-sylius)[typo3/cms TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL. 1.2k1.9M122](/packages/typo3-cms) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)