---
title: "Установка и настройка WT Max для Joomla — WT Max - WebTolk"
description: "Установка библиотеки WT Max, подключение бота MAX, настройка системного плагина и выбор чата для исходящих сообщений."
url: "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/ustanovka-i-nastrojka-wt-max"
date: "2026-11-17T13:18:13+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) > Документация > Установка и настройка WT Max для Joomla

# Установка и настройка WT Max для 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)

Установка библиотеки WT Max, подключение бота MAX, настройка системного плагина и выбор чата для исходящих сообщений.

## Что устанавливает WT Max

WT Max связывает Joomla с MAX Bot API. Пакет включает библиотеку `Webtolk/Wtmax`, системный плагин `System - WT Max` и готовые поля Joomla Form. Внутри используется самостоятельный PHP SDK `webtolk/max`.

Требования библиотеки: Joomla 5.0 или новее, PHP 8.1 или новее и токен бота MAX. Для входящих вебхуков нужен доступный из интернета HTTPS-сайт.

## Установка и подключение

1. Скачайте готовый установочный ZIP со страницы проекта или из [GitHub Releases](https://github.com/WebTolk/WT-Max-Joomla-library/releases). Устанавливайте пакет целиком: он содержит библиотеку, плагин и зависимости SDK.
2. Установите ZIP через стандартный установщик расширений Joomla.
3. Откройте «Система → Управление → Плагины», найдите `System - WT Max` и включите его.
4. В параметре «Токен бота MAX» укажите токен вашего бота и сохраните настройки.
5. Повторно откройте настройки. Поле статуса подключения должно показать сведения о боте. При ошибке проверьте токен, сетевой доступ сервера и доверенные сертификаты PHP.

Токен хранится в параметрах системного плагина. Сторонним расширениям обычно достаточно получить настроенный SDK через `Wtmax::getInstance()` или отправить событие `onWtmaxSendMessage`.

## Чат по умолчанию

Поле «MAX chat_id по умолчанию» задаёт получателя для `onWtmaxSendMessage`, когда событие не передало свой корректный `params['chat_id']`. Сохраните настройки после выбора чата. Соседняя карточка показывает название, ID и доступные сведения о чате.

В текущем окне выбора чата можно ввести известный `chat_id` или ID канала и нажать «Найти чат / обновить», затем выбрать найденную строку. Отрицательные ID поддерживаются. Если строка поиска пуста, окно показывает сохранённое значение и чаты из настроек `default_chat_id` и `allowed_chat_ids`, запрашивая каждый по ID.

API MAX не предоставляет список всех групп и каналов бота. Как получить идентификатор, описано в [официальной инструкции MAX](https://dev.max.ru/docs-api/use-cases/getting-chat-id). Если в установленной сборке нет поиска по ID, обновите WT Max до сборки с этим полем.

## Исходящие сообщения и вебхуки

Для исходящих сообщений достаточно включённого плагина, токена и доступного боту чата. Входящие вебхуки включаются отдельно во вкладке «Вебхуки». Их список разрешённых чатов ограничивает только входящие события; выбор получателя исходящего сообщения его не меняет.

## Первый запрос из Joomla

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

use Webtolk\Wtmax\Wtmax;

defined('_JEXEC') or die;

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

echo htmlspecialchars((string) $bot->getUsername(), ENT_QUOTES, 'UTF-8');
```

Код выполняется внутри загруженной Joomla, например в вашем расширении. Отдельно создавать HTTP-транспорт, подключать Composer на сервере или повторно указывать токен для обычной интеграции не требуется.

## Другие разделы 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)
- [Работа с MAX API через PHP SDK в Joomla](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/max-php-sdk-v-joomla)
- [Логирование и диагностика 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": "Установка и настройка 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": "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/ustanovka-i-nastrojka-wt-max",
            "name": "Установка и настройка WT Max для Joomla — WT Max - WebTolk",
            "description": "Установка библиотеки WT Max, подключение бота MAX, настройка системного плагина и выбор чата для исходящих сообщений.",
            "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": "Установка и настройка WT Max для Joomla",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/ustanovka-i-nastrojka-wt-max",
            "description": "Установка библиотеки WT Max, подключение бота MAX, настройка системного плагина и выбор чата для исходящих сообщений.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/ustanovka-i-nastrojka-wt-max"
            }
        }
    ]
}
```
