---
title: "Отправка сообщений через onWtmaxSendMessage — WT Max - WebTolk"
description: "Как отправить сообщение MAX из расширения Joomla: получатель, форматы plain/Markdown/HTML, локальные вложения, кнопки и результат отправки."
url: "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/onwtmaxsendmessage-otpravka-soobshchenij"
date: "2026-11-17T13:18:12+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) > Документация > Отправка сообщений через onWtmaxSendMessage

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

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)

Как отправить сообщение 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 разметка описана в [официальном справочнике форматирования](https://dev.max.ru/docs-api/use-cases/sending-messages/text-formatting). Любое неподдерживаемое значение `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

- [Установка и настройка WT Max для Joomla](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/ustanovka-i-nastrojka-wt-max)
- [Входящие вебхуки 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": "Отправка сообщений через onWtmaxSendMessage"
            }
        }
    ]
}
```

```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/onwtmaxsendmessage-otpravka-soobshchenij",
            "name": "Отправка сообщений через onWtmaxSendMessage — WT Max - WebTolk",
            "description": "Как отправить сообщение MAX из расширения Joomla: получатель, форматы plain/Markdown/HTML, локальные вложения, кнопки и результат отправки.",
            "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": "Отправка сообщений через onWtmaxSendMessage",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/onwtmaxsendmessage-otpravka-soobshchenij",
            "description": "Как отправить сообщение MAX из расширения Joomla: получатель, форматы plain/Markdown/HTML, локальные вложения, кнопки и результат отправки.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/onwtmaxsendmessage-otpravka-soobshchenij"
            }
        }
    ]
}
```
