---
title: "Логирование и диагностика WT Max — WT Max - WebTolk"
description: "Где искать логи WT Max и как проверить токен, доступ к API, чат, отправку сообщений и доставку вебхуков. Различия файлового лога и журнала отправок."
url: "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/logirovanie-i-diagnostika-wt-max"
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) > Документация > Логирование и диагностика WT Max

# Логирование и диагностика WT Max

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)

Где искать логи WT Max и как проверить токен, доступ к API, чат, отправку сообщений и доставку вебхуков. Различия файлового лога и журнала отправок.

## Лог SDK

Откройте `System - WT Max`, включите «Логировать в отдельный файл» и сохраните параметры. Поле «Имя лог-файла» принимает имя файла без пути. Если оно пустое, используется `wtmax.log`.

Файл создаётся в каталоге логов, настроенном в Joomla. Это не обязательно папка `/logs`. Библиотека регистрирует категорию `lib_webtolk_wtmax`. Если отдельный файл выключен, используется логгер из контейнера Joomla, и запись зависит от общих настроек журналирования.

## Журнал исходящих сообщений

Таблица `#__plg_system_wtmax_messages` хранит сведения об отправках через `onWtmaxSendMessage`: `message_id`, `chat_id`, `context`, `item_id`, `attachment_count` и `date` в миллисекундах. Запись создаётся, если ответ SDK содержит ID сообщения.

Это отдельный механизм, не файловый лог SDK. Вызовы `messages()->sendToChat()` напрямую не проходят через эту запись.

## Частые ситуации

| Ситуация | Что проверить |
| --- | --- |
| Нет статуса подключения или указан пустой токен | Установлен ли весь пакет, включён ли системный плагин, сохранён ли токен. Повторно откройте форму после сохранения. |
| Ошибка авторизации API | Проверьте действительность токена и отсутствие лишних пробелов. Используйте токен нужного бота. |
| Ошибка сертификата или соединения | Проверьте исходящий HTTPS-доступ и доверенные CA в PHP/cURL. Текущий API MAX использует `platform-api2.max.ru`; для него требуется доверие сертификатам Минцифры. Настройте цепочку доверия на сервере, сохраняя проверку TLS. |
| В выборе чата ничего нет | Введите известный ID. MAX не выдаёт общий список групп и каналов бота. Убедитесь, что бот имеет доступ к указанному чату. |
| Не указан получатель | Передайте корректный `params['chat_id']` либо сохраните чат по умолчанию. |
| Разметка отображается как обычный текст | Явно задайте `params['text_format']` как `markdown` или `html` и используйте поддерживаемую MAX разметку. |
| Не отправляется файл | Проверьте наличие и читаемость локального файла внутри Joomla, MIME и соответствие заданного типа. URL используйте как link-кнопку, а не как путь файла. |
| После dispatch результат пуст | Проверьте включение и импорт системного плагина WT Max в используемый dispatcher. Имя события — `onWtmaxSendMessage`. |
| Нет входящих событий | Проверьте включение вебхуков, активную подписку, доступность HTTPS URL, сохранённый секрет и его передачу в URL и заголовке. |
| Вебхук возвращает `ignored` | Сверьте `chat_id` с разрешённым списком. При заполненном списке события без извлечённого ID получателя сообщения также игнорируются. |
| Ошибка AJAX или устаревший токен сессии | Повторно откройте настройки в действующей административной сессии. Используйте штатные кнопки формы управления подпиской. |

Актуальные требования к API-хосту и вебхукам опубликованы в [документации MAX](https://dev.max.ru/docs-api/methods/POST/subscriptions). После изменения секрета или адреса сайта сохраните настройки и пересоздайте подписку.

## Как подготовить сообщение об ошибке

Укажите версию установленного WT Max, Joomla и PHP, действие и текст ошибки. Перед передачей фрагмента лога удалите токены, секреты, callback URL с секретом и персональные данные сообщений. Сам по себе успешный статус подключения проверяет бота, но не подтверждает права отправки в конкретный чат и доставку вебхуков.

## Другие разделы 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)
- [Входящие вебхуки 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)

## 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": "Логирование и диагностика WT Max"
            }
        }
    ]
}
```

```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/logirovanie-i-diagnostika-wt-max",
            "name": "Логирование и диагностика WT Max — WT Max - WebTolk",
            "description": "Где искать логи WT Max и как проверить токен, доступ к API, чат, отправку сообщений и доставку вебхуков. Различия файлового лога и журнала отправок.",
            "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": "Логирование и диагностика WT Max",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/logirovanie-i-diagnostika-wt-max",
            "description": "Где искать логи WT Max и как проверить токен, доступ к API, чат, отправку сообщений и доставку вебхуков. Различия файлового лога и журнала отправок.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/logirovanie-i-diagnostika-wt-max"
            }
        }
    ]
}
```
