---
title: "Входящие вебхуки MAX и событие onWtmaxIncomingWebhook — WT Max - WebTolk"
description: "Настройка подписки MAX, проверка секрета и разрешённых чатов, обработка входящих событий через типизированный WebhookEvent в Joomla."
url: "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/vebhuki-max-onwtmaxincomingwebhook"
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) > Документация > Входящие вебхуки MAX в Joomla

# Входящие вебхуки 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)

Настройка подписки MAX, проверка секрета и разрешённых чатов, обработка входящих событий через типизированный WebhookEvent в Joomla.

## Настройка подписки

1. Включите и настройте `System - WT Max`, сохраните токен бота.
2. На вкладке «Вебхуки» включите входящие вебхуки. Пустое поле секрета заполняется автоматически при открытии формы.
3. Сохраните параметры и повторно откройте форму. Для подписки должны использоваться уже сохранённые настройки.
4. При необходимости заполните «Разрешённые chat_id»: каждый ID на отдельной строке. Для подписки можно выбрать `message_created` и `message_callback`.
5. Нажмите кнопку создания подписки. Проверьте результат и список подписок текущего сайта.

Webhook URL формируется плагином автоматически:

```
https://example.com/index.php?option=com_ajax&plugin=wtmax&group=system&format=raw&action=webhook&secret=YOUR_WEBHOOK_SECRET
```

`YOUR_WEBHOOK_SECRET` — условное обозначение. Используйте URL из настроек своего сайта. Секрет вебхука и токен бота — разные значения. После смены домена или секрета сохраните параметры и пересоздайте подписку с актуальными данными.

По [требованиям MAX к подпискам](https://dev.max.ru/docs-api/methods/POST/subscriptions), обработчик должен быть доступен по HTTPS на порту 443 с доверенным сертификатом и полной цепочкой. Он должен отвечать HTTP 200 в пределах 30 секунд. Тяжёлую обработку лучше передавать в очередь.

## Что проверяет плагин

До вызова пользовательских обработчиков WT Max проверяет включение вебхуков, непустой сохранённый секрет, его совпадение одновременно с query-параметром `secret` и заголовком `X-Max-Bot-Api-Secret`, а затем непустое корректное JSON-тело.

Пустой список разрешённых чатов допускает все запросы, прошедшие эти проверки. При заполненном списке плагин извлекает `chat_id` из получателя сообщения и пропускает только совпавшие ID. События без такого ID также игнорируются. Это существенно для событий, не содержащих объект сообщения.

Если чат не разрешён, событие Joomla не вызывается и обработчик возвращает `ignored`. После успешных проверок вызывается `onWtmaxIncomingWebhook` для плагинов групп `system` и `wtmax`.

## Пример обработчика Joomla

Ниже класс расширения плагина, а не полный установочный пакет. Для своего плагина добавьте манифест и регистрацию сервиса Joomla, установите и включите его.

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

namespace Joomla\Plugin\System\Example\Extension;

use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\Event\SubscriberInterface;
use Webtolk\Wtmax\Event\WebhookEvent;

defined('_JEXEC') or die;

final class Example extends CMSPlugin implements SubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return ['onWtmaxIncomingWebhook' => 'handleWtmaxWebhook'];
    }

    public function handleWtmaxWebhook(WebhookEvent $event): void
    {
        if ($event->getUpdateType() !== 'message_created') {
            return;
        }

        $message = $event->getMessage();
        $chatId = $event->getChatId();

        if ($message === null || $chatId === null) {
            return;
        }

        $text = $message->getBody()?->getText() ?? '';
        $data = $event->getData();

        // Здесь разместите логику вашего расширения.
        // Повторная доставка одного события не должна повторять бизнес-операцию.
    }
}
```

## Контракт WebhookEvent

- `getData(): array` — исходный декодированный JSON.
- `getUpdate(): ?Webtolk\Max\Entity\Update` — типизированный объект SDK.
- `getUpdateType(): ?string` — тип обновления.
- `getMessage(): ?Webtolk\Max\Entity\Message` — сообщение, если оно есть в событии.
- `getChatId(): ?int` — ID, определённый системным плагином.
- `getAllowedChatIds(): array` и `isAllowedChat(): bool` — сведения о проверке разрешённых чатов.

Для `message_callback` сначала проверяйте тип события и читайте соответствующие данные из `getData()` или `getUpdate()`; сообщение может отсутствовать. MAX может повторять доставку, поэтому обработчики должны защищать бизнес-операции от дублирования.

## Удаление подписок

Список показывает подписки бота и выделяет подписки текущего сайта. Из формы WT Max удаляются только выбранные подписки текущего сайта. Отключение приёма в плагине и удаление подписки в MAX — отдельные действия.

## Другие разделы 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)
- [Отправка сообщений через onWtmaxSendMessage](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/onwtmaxsendmessage-otpravka-soobshchenij)
- [Поля 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": "Входящие вебхуки 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/vebhuki-max-onwtmaxincomingwebhook",
            "name": "Входящие вебхуки MAX и событие onWtmaxIncomingWebhook — WT Max - WebTolk",
            "description": "Настройка подписки MAX, проверка секрета и разрешённых чатов, обработка входящих событий через типизированный WebhookEvent в Joomla.",
            "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": "Входящие вебхуки MAX в Joomla",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/vebhuki-max-onwtmaxincomingwebhook",
            "description": "Настройка подписки MAX, проверка секрета и разрешённых чатов, обработка входящих событий через типизированный WebhookEvent в Joomla.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/vebhuki-max-onwtmaxincomingwebhook"
            }
        }
    ]
}
```
