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

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

Как отправить сообщение MAX из расширения Joomla: получатель, форматы plain/Markdown/HTML, локальные вложения, кнопки и результат отправки.

Событие для исходящей отправки

onWtmaxSendMessage обрабатывается системным плагином WT Max. Он использует настроенный токен, выбирает чат, готовит сообщение и вложения, вызывает MAX API и сохраняет сведения об успешной отправке.

Полный пример

Замените ID чата и путь к изображению своими значениями. Файл должен существовать внутри сайта Joomla.

<?php
declare(strict_types=1);

use Joomla\CMS\Event\AbstractEvent;
use Joomla\CMS\Factory;
use Joomla\CMS\Plugin\PluginHelper;

defined('_JEXEC') or die;

$app = Factory::getApplication();
$dispatcher = $app->getDispatcher();
PluginHelper::importPlugin('system', 'wtmax', true, $dispatcher);

$event = AbstractEvent::create('onWtmaxSendMessage', [
    'subject' => $app,
    'message' => "**Новый заказ**\nНомер: 10",
    'attachments' => [
        ['type' => 'image', 'path' => 'images/orders/order-10.jpg'],
        ['type' => 'link', 'url' => 'https://example.com/orders/10', 'text' => 'Открыть заказ'],
    ],
    'params' => [
        'chat_id' => 123456,
        'text_format' => 'markdown',
        'context' => 'com_example.order',
        'item_id' => 10,
        'notify' => true,
        'disable_link_preview' => false,
    ],
]);

$dispatcher->dispatch($event->getName(), $event);
$result = $event->getArgument('result', []);

if (($result['success'] ?? false) !== true) {
    $app->enqueueMessage(
        (string) ($result['error'] ?? 'Обработчик WT Max не вернул успешный результат'),
        'error'
    );
}

Аргументы события

Аргумент Назначение
message Текст сообщения. Можно передать пустую строку при наличии вложений.
attachments Массив файловых вложений, link-кнопок или готовых объектов AttachmentPayloadInterface.
link Дополнительный HTTP(S) URL или HTML-ссылка. Корректная ссылка превращается в inline-кнопку.
params['chat_id'] Получатель конкретного сообщения. Если корректный ID не задан, используется чат по умолчанию из плагина.
params['text_format'] plain, markdown или html.
params['context'], params['item_id'] Привязка записи журнала к объекту вашего расширения.
params['notify'] Флаг уведомления MAX.
params['disable_link_preview'] Управление предпросмотром ссылок для этой отправки.

Форматирование текста

По умолчанию используется plain text: HTML-теги удаляются, сущности декодируются, переносы <br> и границы абзацев сохраняются. Для Markdown или HTML формат нужно указать явно. В этих режимах текст передаётся с разметкой.

// Фрагменты аргументов для AbstractEvent::create():
'message' => '<strong>Новый заказ</strong><br><em>Номер: 10</em>',
'params' => ['text_format' => 'html'],

Поддерживаемая MAX разметка описана в официальном справочнике форматирования. Любое неподдерживаемое значение text_format отклоняется до загрузки файлов и отправки сообщения.

Файлы и кнопки

  • Строка 'images/example.jpg' задаёт локальный файл с автоматическим определением типа по MIME.
  • Массив ['type' => 'image|video|audio|file', 'path' => '...'] задаёт тип явно. Он должен соответствовать MIME файла.
  • Для файлов принимаются только локальные пути внутри корня Joomla. Удалённый URL не загружается как файловое вложение.
  • ['type' => 'link', 'url' => 'https://...', 'text' => 'Открыть'] создаёт inline-кнопку. Разрешены HTTP и HTTPS.

Результат и журнал

При успехе в result возвращаются success => true и message с данными MAX. При ошибке — success => false и error. Проверяйте этот результат после dispatch.

Плагин записывает идентификатор сообщения, чат, контекст, ID объекта, число вложений и время в таблицу #__plg_system_wtmax_messages. Прямые вызовы SDK обходят этот механизм. Если отправка прошла, а запись в БД завершилась ошибкой, повторная отправка может создать дубликат: сначала проверьте чат.

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

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

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