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

WT Max библиотека для интеграции с 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 и обрабатываете исключения.

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

Расширения Joomla WebTolk

113 Всего расширений
12 Категорий
588 Выпущено версий
949240 Всего скачиваний