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

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

Где искать логи 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 с секретом и персональные данные сообщений. Сам по себе успешный статус подключения проверяет бота, но не подтверждает права отправки в конкретный чат и доставку вебхуков.

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

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

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