---
title: "WT Max platform - Joomla библиотека интеграции с мессенджером по API - WebTolk"
description: "Joomla-библиотека для API  мессенджера MAX с системным плагином для настроек и диагностики подключения."
url: "https://web-tolk.ru/dev/biblioteki/wt-max-platform"
date: "2026-06-09T07:42:18+00:00"
language: "ru-RU"
---

# WT Max библиотека для интеграции с Joomla

- **Категория:** [Библиотеки](https://web-tolk.ru/dev/biblioteki)
- **Версия:** 0.1.1
- **Дата:** 02 июня 2026

629 395 CTR 159% Pack Free

[Скачать](https://web-tolk.ru/get?element=lib_wtmax)[Версии](https://web-tolk.ru/dev/biblioteki/wt-max-platform/versions)[Документация](https://github.com/WebTolk/Max-platform-PHP-SDK/blob/main/docs/README.md)[GitHub](https://github.com/WebTolk/WT-Max-Joomla-library)

Joomla-библиотека для API мессенджера MAX с системным плагином для настроек и диагностики подключения. Библиотека предназначена для разработчиков.

![WT Max библиотека для интеграции с Joomla](https://web-tolk.ru/images/swjprojects/projects/113/ru-RU/icon.webp)

## Описание

Joomla-пакет, который ставит:

- библиотеку `WebTolk/Wtmax`
- системный плагин `System - WT Max`

Пакет оборачивает основной SDK `webtolk/max` и даёт готовую точку входа `\Webtolk\Wtmax\Wtmax::getInstance()`. Токен бота и служебные настройки хранятся в системном плагине.

**Основной репозиторий SDK:**[https://github.com/WebTolk/Max-platform-PHP-SDK](https://github.com/WebTolk/Max-platform-PHP-SDK). Он является самостоятельным Composer-пакетом.

**Документация по всем методам библиотеки:** [https://github.com/WebTolk/Max-platform-PHP-SDK/blob/main/docs/README.md](https://github.com/WebTolk/Max-platform-PHP-SDK/blob/main/docs/README.md)

## Что входит в пакет

- Joomla library `Webtolk/Wtmax`
- системный плагин для хранения токена
- поле статуса подключения к API
- опция логирования в отдельный файл

## Как это работает

После установки:

1. включите плагин `System - WT Max`
2. укажите `MAX bot token`
3. при необходимости включите логирование в отдельный файл
4. в коде Joomla получайте готовый SDK через `Wtmax::getInstance()`

Библиотека внутри создаёт:

- `Joomla\Http\HttpFactory`
- `Laminas\Diactoros\RequestFactory`
- `Laminas\Diactoros\StreamFactory`
- PSR-3 логгер из ядра Joomla

## Быстрый старт

### Получить готовый экземпляр SDK

```
<?php

declare(strict_types=1);

use Webtolk\Wtmax\Wtmax;

defined('_JEXEC') or die;

$max = Wtmax::getInstance();

$bot = $max->bots()->me();

echo $bot->getId();
echo $bot->getUsername();
```

### Отправить сообщение в чат

Пример основан на сценарии `messages()->sendToChat()` из основного SDK.

```
<?php

declare(strict_types=1);

use Webtolk\Max\Payload\NewMessageBody;
use Webtolk\Wtmax\Wtmax;

defined('_JEXEC') or die;

$chatId = 123456;

$message = Wtmax::getInstance()->messages()->sendToChat(
	$chatId,
	NewMessageBody::text('Привет из Joomla WT Max library')
);

echo $message->getBody()?->getText() ?? '';
```

### Отправить картинку

Пример основан на upstream upload flow: `uploads()->upload()` + `toAttachment()` + `messages()->sendToChat()`.

```
<?php

declare(strict_types=1);

use Webtolk\Max\Payload\NewMessageBody;
use Webtolk\Max\Payload\UploadType;
use Webtolk\Wtmax\Wtmax;
use RuntimeException;

defined('_JEXEC') or die;

$chatId = 123456;
$imagePath = JPATH_ROOT . '/images/sample.jpg';
$binaryImage = file_get_contents($imagePath);

if ($binaryImage === false)
{
	throw new RuntimeException('Image file was not read: ' . $imagePath);
}

$max = Wtmax::getInstance();

$imageAttachment = $max->uploads()
	->upload(UploadType::IMAGE, $binaryImage, 'image/jpeg')
	->toAttachment();

$message = $max->messages()->sendToChat(
	$chatId,
	NewMessageBody::text('Отправляю картинку из Joomla')
		->withAttachments([$imageAttachment])
);

echo $message->getBody()?->getMessageId() ?? '';
```

### Обработать callback и ответить на него

Пример основан на upstream сценарии `messages()->answerCallback()`.

```
<?php

declare(strict_types=1);

use Webtolk\Max\Payload\CallbackAnswerPayload;
use Webtolk\Wtmax\Wtmax;

defined('_JEXEC') or die;

$payload = file_get_contents('php://input');

if ($payload !== false && $payload !== '')
{
	$update = json_decode($payload, true, 512, JSON_THROW_ON_ERROR);
	$callbackId = $update['callback']['callback_id'] ?? null;

	if ($callbackId !== null)
	{
		Wtmax::getInstance()->messages()->answerCallback(
			(string) $callbackId,
			(new CallbackAnswerPayload())->withNotification('Кнопка обработана')
		);
	}
}
```

## Если нужно собрать экземпляр Max вручную

`Wtmax::getInstance()` удобен для обычной работы в Joomla, но при необходимости SDK можно собрать вручную.

```
<?php

declare(strict_types=1);

require_once JPATH_LIBRARIES . '/Webtolk/Wtmax/src/libraries/vendor/autoload.php';

use Joomla\Http\HttpFactory;
use Laminas\Diactoros\RequestFactory;
use Laminas\Diactoros\StreamFactory;
use Webtolk\Max\Config\MaxConfig;
use Webtolk\Max\Max;
use Psr\Log\NullLogger;

defined('_JEXEC') or die;

$token = 'YOUR_BOT_TOKEN';

$max = new Max(
	new MaxConfig($token),
	new NullLogger()
);

$max->setTransport(
	(new HttpFactory())->getHttp([], ['curl', 'stream']),
	new RequestFactory(),
	new StreamFactory(),
);
```

## Где хранится токен

Токен хранится в параметрах системного плагина `System - WT Max`.

Основные параметры:

- MAX bot token
- Логировать в отдельный файл

## Логирование

Если включён переключатель логирования, библиотека пишет в отдельный файл: `/logs/wtmax.max-api.log`

На логирование могут влиять настройки Joomla из **Система - Основные настройки**.

## Joomla

 **Тип расширения:** Пакет **Состав пакета:** Библиотека, Плагин **Версия Joomla:** 6.1.0, 6.1.1

## Галерея

![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/113/ru-RU/gallery/HJtTZYS2Fpm.webp)

![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/113/ru-RU/gallery/S1ZVXfVxrzf.webp)

## Что нового

 02.06.2026, 19:06:20

Добавлено

### Отправка сообщений в Max через тригер onWtmaxSendMessage

Добавлено событие onWtmaxSendMessage для отправки сообщений из сторонних Joomla-расширений в чат по умолчанию.

Добавлено

### Чат по умолчанию для отправки сообщений

Добавлена настройка default chat_id для исходящих сообщений (выбор MAX-чата через Joomla ModalSelect). В плагине показывается информация об этом chat_id.

Добавлено

### Лог исходящих сообщений

Добавлен лог исходящих сообщений в таблицу плагина #__plg_system_wtmax_messages.

Добавлено

### Центральная обработка входящих вебхуков

Добавлена центральная обработка входящих вебхуков из ботов MAX . Центральная обработка вебхуков триггерит событие onWtmaxIncomingWebhook для системных плагинов и плагинов группы wtmax

Изменено

### Обновление PHP SDK Max

PHP SDK Max обновлён до версии 0.1.1.

## JSON-LD Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "item": {
                "@id": "https://web-tolk.ru/",
                "name": "Главная"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/dev",
                "name": "Расширения Joomla"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "@id": "/dev/biblioteki",
                "name": "Библиотеки"
            }
        },
        {
            "@type": "ListItem",
            "position": 4,
            "item": {
                "name": "WT Max библиотека для интеграции с Joomla"
            }
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://web-tolk.ru/#/schema/Organization/base",
            "name": "WebTolk",
            "url": "https://web-tolk.ru/",
            "logo": {
                "@type": "ImageObject",
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo",
                "url": "images/webtolk-1080p.jpg",
                "contentUrl": "images/webtolk-1080p.jpg",
                "width": 1920,
                "height": 1080
            },
            "image": {
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo"
            },
            "sameAs": [
                "https://github.com/WebTolk",
                "https://github.com/sergeytolkachyov",
                "https://vk.com/web_tolk",
                "https://vk.com/webtolkru",
                "https://tenchat.ru/sergeytolkachyov",
                "https://t.me/sergeytolkachyov",
                "https://t.me/webtolkru"
            ]
        },
        {
            "@type": "WebSite",
            "@id": "https://web-tolk.ru/#/schema/WebSite/base",
            "url": "https://web-tolk.ru/",
            "name": "WebTolk",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform",
            "name": "WT Max platform - Joomla библиотека интеграции с мессенджером по API - WebTolk",
            "description": "Joomla-библиотека для API  мессенджера MAX с системным плагином для настроек и диагностики подключения.",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/SoftwareApplication/base"
            },
            "inLanguage": "ru-RU",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "SoftwareApplication",
            "name": "WT Max библиотека для интеграции с Joomla",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform",
            "description": "Joomla-библиотека для API  мессенджера MAX с системным плагином для настроек и диагностики подключения. Библиотека предназначена для разработчиков.",
            "applicationCategory": "Библиотеки",
            "softwareVersion": "0.1.1",
            "downloadUrl": "https://web-tolk.ru/get?element=lib_wtmax",
            "image": "https://web-tolk.ru/images/swjprojects/projects/113/ru-RU/icon.webp",
            "operatingSystem": "ANY",
            "interactionStatistic": [
                {
                    "@type": "InteractionCounter",
                    "interactionType": "https://schema.org/DownloadAction",
                    "userInteractionCount": 629
                },
                {
                    "@type": "InteractionCounter",
                    "interactionType": "https://schema.org/ViewAction",
                    "userInteractionCount": 396
                }
            ],
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform"
            },
            "softwareRequirements": "Joomla",
            "applicationSubCategory": "0.1.1",
            "isAccessibleForFree": true
        }
    ]
}
```
