Логирование и диагностика WT Max
Где искать логи 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. После изменения секрета или адреса сайта сохраните настройки и пересоздайте подписку.
Как подготовить сообщение об ошибке
Укажите версию установленного WT Max, Joomla и PHP, действие и текст ошибки. Перед передачей фрагмента лога удалите токены, секреты, callback URL с секретом и персональные данные сообщений. Сам по себе успешный статус подключения проверяет бота, но не подтверждает права отправки в конкретный чат и доставку вебхуков.