---
title: "Работа с MAX API через PHP SDK в Joomla — WT Max - WebTolk"
description: "Получение настроенного SDK через Wtmax::getInstance(), запрос информации о боте и отправка сообщения напрямую из Joomla. Отличия от событий системного плагина."
url: "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/max-php-sdk-v-joomla"
date: "2026-11-17T13:18:11+00:00"
language: "ru-RU"
---

## Breadcrumbs

[Главная](https://web-tolk.ru/) > [Расширения Joomla](https://web-tolk.ru/dev) > [Библиотеки](/dev/biblioteki) > [WT Max библиотека для интеграции с Joomla](/dev/biblioteki/wt-max-platform) > Документация > Работа с MAX API через PHP SDK в Joomla

# Работа с MAX API через PHP SDK в Joomla

WT Max библиотека для интеграции с Joomla - Документация

**Категория:** [Библиотеки](https://web-tolk.ru/dev/biblioteki)

[Проект](https://web-tolk.ru/dev/biblioteki/wt-max-platform)[Версии](https://web-tolk.ru/dev/biblioteki/wt-max-platform/versions)[Документация](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation)[GitHub](https://github.com/WebTolk/WT-Max-Joomla-library)

Получение настроенного SDK через Wtmax::getInstance(), запрос информации о боте и отправка сообщения напрямую из Joomla. Отличия от событий системного плагина.

## Настроенный экземпляр SDK

`Webtolk\Wtmax\Wtmax::getInstance()` возвращает объект `Webtolk\Max\Max`. Обёртка читает токен и параметры из `System - WT Max`, подключает HTTP-транспорт Joomla и PSR-3 логгер. Вызывайте её внутри Joomla после установки полного пакета и включения плагина.

```
<?php
declare(strict_types=1);

use Webtolk\Wtmax\Wtmax;

defined('_JEXEC') or die;

$max = Wtmax::getInstance();
$bot = $max->bots()->me();

$botId = $bot->getId();
$username = $bot->getUsername();
```

## Отправить текст в чат

```
<?php
declare(strict_types=1);

use Joomla\CMS\Factory;
use Webtolk\Max\Payload\NewMessageBody;
use Webtolk\Wtmax\Wtmax;

defined('_JEXEC') or die;

$app = Factory::getApplication();
$chatId = 123456; // Замените на ID чата, доступного вашему боту.

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

    $messageId = $message->getBody()?->getMessageId();
} catch (\Throwable $e) {
    $app->enqueueMessage($e->getMessage(), 'error');
}
```

В прямом вызове SDK получателя нужно передавать явно. Настройка `default_chat_id` и автоматическая запись в таблицу `#__plg_system_wtmax_messages` относятся к обработчику `onWtmaxSendMessage`.

## Передать отдельные параметры

Для особого подключения можно передать `Joomla\Registry\Registry` в `getInstance($params)`. Если ключ `bot_token` отсутствует, настройки объединяются с параметрами системного плагина. Если ключ передан явно, используется указанное значение, включая пустую строку. Для обычного подключения достаточно вызова без аргументов.

## Другие методы MAX API

Объект SDK предоставляет модули для работы с ботом, чатами, сообщениями, загрузкой вложений и подписками. Состав методов зависит от версии SDK, включённой в установленную сборку WT Max. Для точных сигнатур, объектов ответа и payload используйте [справочник MAX PHP SDK](https://github.com/WebTolk/Max-platform-PHP-SDK/blob/main/docs/README.md) и [официальную документацию MAX API](https://dev.max.ru/docs-api).

Для расширений, которым нужна стандартная отправка с локальными файлами, кнопками, чатом по умолчанию и журналом, используйте событие `onWtmaxSendMessage`. Для прямого SDK вы самостоятельно готовите payload и обрабатываете исключения.

## Другие разделы WT Max

- [Установка и настройка WT Max для Joomla](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/ustanovka-i-nastrojka-wt-max)
- [Отправка сообщений через onWtmaxSendMessage](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/onwtmaxsendmessage-otpravka-soobshchenij)
- [Входящие вебхуки MAX и событие onWtmaxIncomingWebhook](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/vebhuki-max-onwtmaxincomingwebhook)
- [Поля WT Max для Joomla Form](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/polya-wt-max-joomla-form)
- [Логирование и диагностика WT Max](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/logirovanie-i-diagnostika-wt-max)

## 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": {
                "@id": "/dev/biblioteki/wt-max-platform",
                "name": "WT Max библиотека для интеграции с Joomla"
            }
        },
        {
            "@type": "ListItem",
            "position": 5,
            "item": {
                "name": "Работа с MAX API через PHP SDK в 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": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "contentUrl": "https://web-tolk.ru/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/documentation/max-php-sdk-v-joomla",
            "name": "Работа с MAX API через PHP SDK в Joomla — WT Max - WebTolk",
            "description": "Получение настроенного SDK через Wtmax::getInstance(), запрос информации о боте и отправка сообщения напрямую из Joomla. Отличия от событий системного плагина.",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/TechArticle/base"
            },
            "inLanguage": "ru-RU",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "TechArticle",
            "headline": "Работа с MAX API через PHP SDK в Joomla",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/max-php-sdk-v-joomla",
            "description": "Получение настроенного SDK через Wtmax::getInstance(), запрос информации о боте и отправка сообщения напрямую из Joomla. Отличия от событий системного плагина.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/max-php-sdk-v-joomla"
            }
        }
    ]
}
```
