Работа с MAX API через PHP SDK в Joomla
Получение настроенного 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 и официальную документацию MAX API.
Для расширений, которым нужна стандартная отправка с локальными файлами, кнопками, чатом по умолчанию и журналом, используйте событие onWtmaxSendMessage. Для прямого SDK вы самостоятельно готовите payload и обрабатываете исключения.