MAX Publisher & Widget — публикация записей WordPress в MAX

Кратко: Национальный мессенджер Макс разрешил создавать публичные каналы. А это значит, что у блогеров и владельцев сайта появился еще один канал, который можно связать с WordPress. С этой целью появился MAX Publisher & Widget — WordPress-плагин для автоматической...

Национальный мессенджер Макс разрешил создавать публичные каналы. А это значит, что у блогеров и владельцев сайта появился еще один канал, который можно связать с WordPress. С этой целью появился MAX Publisher & Widget — WordPress-плагин для автоматической публикации записей в Макс и вывода виджета канала на сайте.

Что умеет плагин

Плагин решает две основные задачи:

  1. Публикует новые записи WordPress в канал MAX.
  2. Добавляет на сайт карточку или кнопку перехода в MAX.

Виджет можно разместить тремя способами:

– через Gutenberg;

– через классические виджеты WordPress;

– через шорткод.

Публикация тоже не привязана только к обычным записям. В настройках можно выбрать страницы и другие публичные типы контента, зарегистрированные темой или сторонними плагинами.

Как работает публикация

  1. Вы публикуете запись в WordPress.
  2. Плагин ставит отправку в очередь.
  3. Через указанное количество минут формируется excerpt.
  4. Заголовок, отрывок, ссылка и изображение передаются в MAX.
  5. В редакторе WordPress сохраняется статус публикации.

Повторное редактирование записи не создаёт ещё один пост в MAX. Если нужно отправить материал повторно, это можно сделать вручную кнопкой Publish again.

При временной ошибке плагин выполняет до пяти повторных попыток с увеличивающимся интервалом.

SSL для MAX уже внутри

MAX переводит Bot API на адрес:

https://platform-api2.max.ru

Для подключения также требуется доверие к сертификатам Минцифры.

Обычно это означает отдельную настройку сервера. Но требовать от каждого владельца WordPress ручной установки сертификатов в систему — плохая идея. Не у всех есть root-доступ, а ошибка при установке может повлиять не только на WordPress.

Поэтому я добавил в плагин:

– Russian Trusted Root CA;

– Russian Trusted Sub CA.

При активации создаётся отдельный CA bundle. Он применяется только к запросам этого плагина в MAX.

Глобальное хранилище сертификатов сервера не меняется. Проверка SSL при этом остаётся включённой.

Актуальные требования к адресу API, авторизации и сертификатам опубликованы в документации MAX Bot API.

Что понадобится для настройки

Понадобятся:

– сайт на WordPress 6.0 или новее;

– PHP 7.4 или новее;

– права администратора WordPress;

– канал MAX;

– чат-бот MAX;

– токен бота;

– числовой chat_id канала.

Создание чат-ботов сейчас доступно организациям, ИП и самозанятым с верифицированным профилем на платформе MAX для партнёров. Каждый бот проходит модерацию. Это ограничение самой платформы, а не плагина. Как показала практика, модерация не долгая и не сложная.

Как создать бота MAX

Откройте платформу MAX для партнёров и создайте или выберите верифицированный профиль.

После этого:

  1. Перейдите в раздел Чат-боты.
  2. Нажмите Создать.
  3. Укажите название.
  4. Добавьте описание.
  5. Загрузите аватар.
  6. Отправьте бота на модерацию.

Ник бота формируется платформой автоматически. После создания его нельзя изменить, поэтому стоит заранее проверить остальные данные.

Когда модерация завершится, откройте:

Чат-боты → Перейти → Расширенные настройки → Настроить

Здесь появится токен.

Скопируйте его и сохраните в надёжном месте. Токен предоставляет доступ к управлению ботом, поэтому его нельзя публиковать на странице сайта, в репозитории или в обычном текстовом файле.

Там же нужно включить возможность добавления бота в групповые чаты. По умолчанию она выключена.

Подробные требования к созданию и модерации есть в официальной инструкции MAX.

Создание канала

Если канал уже есть, этот этап можно пропустить.

MAX поддерживает публичные и приватные каналы.

Публичный канал доступен в поиске и имеет обычную ссылку:

https://max.ru/channel_name

Приватный канал открывается по ссылке-приглашению.

Для создания публичного канала бизнеса:

  1. Откройте платформу MAX для партнёров.
  2. Перейдите в Каналы → Создать.
  3. Выберите подходящий вариант.
  4. Перейдите в бот создания каналов.
  5. Подтвердите номер телефона.
  6. Укажите название канала.
  7. Завершите создание.

Приватный канал можно создать непосредственно в приложении MAX.

Отличия публичных и приватных каналов описаны в документации MAX по созданию каналов.

Добавление бота в канал

Создать бота недостаточно. Ему ещё нужно предоставить доступ к каналу.

Откройте канал в MAX:

  1. Нажмите название или аватар канала.
  2. Перейдите в раздел Администраторы.
  3. Нажмите Добавить администратора.
  4. Найдите созданного бота.
  5. Назначьте его администратором.
  6. Разрешите публикацию сообщений.
  7. Сохраните изменения.

Если бот не отображается в списке, сначала добавьте его в канал по нику или ссылке.

Не стоит выдавать боту все возможные права. Для работы плагина достаточно доступа к каналу и возможности публиковать сообщения.

Установка плагина

Скачайте архив:

Скачать MAX Publisher & Widget 1.0.0

После этого в WordPress:

  1. Откройте Плагины → Добавить плагин.
  2. Нажмите Загрузить плагин.
  3. Выберите ZIP-архив.
  4. Нажмите Установить.
  5. Активируйте плагин.
  6. Перейдите в Настройки → MAX Publisher.

Если раньше MAX был настроен внутри IK Email Newsletter, новый плагин попробует автоматически импортировать токен, chat_id и ссылку на канал.

Старые статусы публикаций тоже учитываются. Одна и та же запись не должна автоматически отправиться дважды.

Email, Push, Telegram и VK при этом продолжают работать независимо.

После этого в WordPress:

  1. Откройте Плагины → Добавить плагин.
  2. Нажмите Загрузить плагин.
  3. Выберите ZIP-архив.
  4. Нажмите Установить.
  5. Активируйте плагин.
  6. Перейдите в Настройки → MAX Publisher.

Если раньше MAX был настроен внутри IK Email Newsletter, новый плагин попробует автоматически импортировать токен, chat_id и ссылку на канал.

Старые статусы публикаций тоже учитываются. Одна и та же запись не должна автоматически отправиться дважды.

Email, Push, Telegram и VK при этом продолжают работать независимо.

Настройка соединения

В разделе MAX connection нужно заполнить два основных поля.

Bot token

Вставьте токен из расширенных настроек бота.

После сохранения токен не выводится обратно в поле. Пустое поле означает, что сохранённый токен нужно оставить.

Для удаления токена предусмотрен отдельный флажок Remove the saved token.

Chat or channel ID

chat_id — это числовой идентификатор канала.

Это не название, не ник и не публичная ссылка.

Если идентификатор уже известен, просто вставьте его в поле.

Если неизвестен:

  1. Добавьте бота в канал как администратора.
  2. Введите токен в настройках WordPress.
  3. Сохраните настройки.
  4. Нажмите Discover channel ID.
  5. Сохраните найденный идентификатор.

Плагин ищет chat_id в недавних событиях MAX.

Если канал не найден, удалите бота из канала, добавьте его снова и сразу повторите поиск. Событие добавления должно быть свежим.

После этого нажмите Test connection.

Плагин проверит:

– правильность токена;

– информацию о боте;

– доступ к указанному каналу.

Тестовая запись при этой проверке не отправляется.

Настройка автоматической публикации

В разделе Post publishing можно включить автоматическую отправку новых материалов.

Задержка

Задержка задаётся в минутах.

Например:

0 — почти сразу;

3 — через три минуты;

10 — через десять минут.

Отправка работает через WP-Cron. На сайтах с очень низкой посещаемостью задача может запуститься немного позже.

Типы контента

Можно выбрать:

– записи;

– страницы;

– пользовательские типы контента.

Например, если на сайте есть отдельный тип «Новости», его тоже можно разрешить для публикации.

Шаблон сообщения

По умолчанию используется примерно такой шаблон:

*{title}*

{excerpt}

{url}

Доступные переменные:

{title} — заголовок;

{excerpt} — отрывок;

{url} — ссылка;

{site_name} — название сайта;

{author} — автор;

{date} — дата;

{categories} — рубрики.

Можно использовать Markdown или HTML.

Пример HTML-шаблона:

<b>{title}</b>

{excerpt}

{url}

MAX принимает сообщения длиной до 4000 символов. Даже если шаблон получился слишком большим, плагин дополнительно ограничит итоговый текст.

Настройка excerpt

Это одна из основных настроек нового плагина.

Сначала выбираем число, затем единицу ограничения.

Например:

40 words

Плагин оставит первые 40 слов.

Или:

3 sentences

Плагин оставит первые три предложения.

Если исходный текст короче лимита, многоточие не добавляется. Если длиннее — появится .

Ручной excerpt из редактора WordPress имеет приоритет. Это удобно, если для конкретной статьи нужен отдельный анонс.

Если ручной excerpt пуст, плагин возьмёт текст записи, удалит блоковую разметку и шорткоды, а затем сократит его по выбранному правилу.

Изображение и кнопка

В настройках сообщения можно:

– прикрепить изображение записи;

– добавить ссылку на статью;

– включить или отключить уведомления;

– отключить предпросмотр ссылки;

– добавить inline-кнопку.

Например:

Читать на сайте

Кнопка появится под сообщением и будет вести на опубликованную статью.

Для изображения используется его публичный HTTPS-адрес. Если сайт или CDN запрещает внешнюю загрузку файлов, MAX может не получить картинку, но текст публикации всё равно отправится.

Ручная публикация

В редакторе записи появляется боковой блок MAX publication.

Он показывает состояние:

– ещё не опубликовано;

– запланировано;

– опубликовано;

– последняя ошибка.

Кнопка Publish now отправляет запись вручную.

Если материал уже был опубликован, появляется Publish again. Перед повторной отправкой WordPress попросит подтверждение.

Если MAX вернул публичную ссылку на сообщение, в этом же блоке появится переход к публикации.

Виджет MAX для сайта

Кроме отправки записей плагин умеет показывать карточку канала.

В общих настройках указываются:

– ссылка MAX;

– заголовок;

– описание;

– текст кнопки;

– тема;

– ширина;

– выравнивание;

– способ открытия ссылки.

Есть два вида:

  1. Карточка.
  2. Отдельная кнопка.

И три темы:

– светлая;

– тёмная;

– фирменная фиолетовая.

Gutenberg

В редакторе блоков найдите:

MAX channel

После добавления блока справа появятся настройки ссылки, текста, темы, ширины и выравнивания.

Если включено Use plugin defaults, блок наследует общие настройки плагина.

Это удобно: поменяли название или ссылку один раз — обновились все блоки, использующие значения по умолчанию.

Классические виджеты

Откройте:

Внешний вид → Виджеты

Добавьте виджет MAX channel в боковую панель, подвал или другую область темы.

Можно использовать глобальные настройки или указать отдельные значения только для этого виджета.

Шорткод

Самый простой вариант:

[max_widget]

Кнопка по центру:

[max_widget layout="button" theme="dark" align="center" width="320px" button="Открыть MAX"]

Индивидуальная карточка:

[max_widget use_defaults="no" url="https://max.ru/channel_name" title="Наш канал в MAX" text="Новости и новые статьи" button="Подписаться" layout="card" theme="light" width="100%"]

Шорткод можно вставить в запись, страницу, текстовый виджет или шаблон, который поддерживает выполнение WordPress-шорткодов.

Возможные ошибки

HTTP 401

Проблема с токеном.

Скопируйте его заново, сохраните настройки и повторите проверку соединения.

HTTP 404

Бот не видит канал или указан неправильный chat_id.

Проверьте права администратора и повторно определите идентификатор.

Канал не найден

Событие добавления бота уже устарело.

Удалите бота, добавьте снова и сразу нажмите Discover channel ID.

Ошибка SSL

Откройте блок SSL and maintenance.

В нём должны отображаться:

– адрес platform-api2.max.ru;

– наличие сертификатов;

– путь к private CA bundle;

– SHA-256 цепочки.

Также проверьте, что WordPress может записывать файлы в wp-content/uploads.

Отключать проверку SSL не нужно.

Запись долго находится в Scheduled

Плагин использует WP-Cron.

Проверьте раздел Инструменты → Здоровье сайта, loopback-запросы и настройки cron в wp-config.php.

Для сайта с низкой посещаемостью лучше настроить системный cron.

Безопасность

Токен передаётся только в заголовке Authorization. В разметку страницы, Gutenberg, виджет и шорткод он не попадает.

Плагин напрямую обращается к официальному API MAX.

В нём нет:

– AI-ключей;

– proxy;

– внешнего сервера обработки текста;

– отключения SSL-проверки.

Сертификаты применяются только к запросам MAX и не устанавливаются глобально в операционную систему.

Что получилось

Получился небольшой самостоятельный плагин с одной понятной задачей.

Опубликовал статью в WordPress — получил анонс в MAX. Без отдельного конструктора, без копирования текста вручную и без установки большой системы рассылок.

А виджет помогает связать сайт и канал: читатель может перейти в MAX через карточку, кнопку или шорткод.

Внутри архива также находится отдельная подробная инструкция:

docs/SETUP-RU.md

Если MAX продолжит развивать API, плагин тоже буду обновлять. Сейчас главное уже работает: публикация, excerpt, изображения, кнопки, SSL и три варианта виджета.

Вопросы по материалу

О чем этот материал?

Национальный мессенджер Макс разрешил создавать публичные каналы. А это значит, что у блогеров и владельцев сайта появился еще один канал, который можно связать с WordPress. С этой целью появился MAX Publisher & Widget — WordPress-плагин для автоматической...

Кто автор материала?

Материал подготовил Игорь Колосов. Автор материалов о продуктивности, IT, управлении, нейросетях и инструментах для работы и жизни.

Когда материал опубликован или обновлен?

Дата публикации: 17.07.2026. Последнее обновление: 17.07.2026.