max-advance

Advanced n8n community nodes for the current MAX Bot API

Package Information

Released: 1 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.2
Author: Catalogicus International

Available Nodes

Documentation generating…

MAX Advance Bot icon
MAX Advance Bot
Get the authenticated MAX bot and manage its commands
MAX Advance Chat icon
MAX Advance Chat
Manage a MAX chat, its pinned message, and bot membership
MAX Advance Chat Administrator icon
MAX Advance Chat Administrator
List and manage MAX chat administrators
MAX Advance Chat Member icon
MAX Advance Chat Member
List, remove, and optionally block MAX chat members
MAX Advance Comment icon
MAX Advance Comment
Create, read, update, and delete MAX message comments
MAX Advance Media icon
MAX Advance Media
Upload MAX media from n8n binary data or get video details
MAX Advance Message icon
MAX Advance Message
Send, read, update, and answer callbacks for MAX messages
MAX Advance Subscription icon
MAX Advance Subscription
Create, list, and delete MAX webhook subscriptions
MAX Advance Trigger icon
MAX Advance Trigger
Starts the workflow on a Max messenger event

Documentation

@catalogicus-international/n8n-nodes-max-advance

Расширенный набор community nodes для работы n8n с актуальным MAX Bot API.

Установка

В Settings → Community Nodes укажите:

@catalogicus-international/n8n-nodes-max-advance

Для разработки используйте Node.js 20.15+ и pnpm 9:

pnpm install
pnpm run lint
pnpm run build
pnpm test

Credentials

Создайте credentials MAX Advance API и укажите токен бота. Base URL по умолчанию —
https://platform-api2.max.ru. Токен передаётся только в заголовке Authorization.

Все int64-идентификаторы MAX представлены строками, поэтому большие ID не теряют точность.

Ноды

  • MAX Advance Bot — информация о боте и команды.
  • MAX Advance Message — отправка, чтение, изменение, удаление и callback-ответы.
  • MAX Advance Media — загрузка binary-файлов и сведения о видео.
  • MAX Advance Chat — информация и настройки чата, действия, pin и членство бота.
  • MAX Advance Chat Administrator — получение и управление администраторами.
  • MAX Advance Chat Member — получение, удаление и блокировка участников.
  • MAX Advance Comment — CRUD комментариев к постам каналов.
  • MAX Advance Subscription — управление webhook-подписками.
  • MAX Advance Trigger — production webhook-trigger для событий MAX.

Отключённый GET /chats, удаляемое добавление участников и Long Polling намеренно не
представлены.

Сообщения и медиа

MAX Advance Message отправляет сообщения пользователю или в чат, поддерживает plain text,
Markdown, HTML, reply/forward, notify, отключение link preview и inline-клавиатуры. Вложения
можно передать из binary data, по прямому URL изображения, через готовый MAX token или полным
attachment JSON. Binary-вложения загружаются последовательно, в порядке настройки.

При временной ошибке attachment.not.ready отправка повторяется через 700, 1500 и 3000 мс.
Markdown передаётся в MAX без локальной проверки количества символов форматирования, поэтому
литеральные *, _ и обратные кавычки внутри названий не блокируют отправку. Для распознанной
ошибки Markdown от MAX доступен включённый по умолчанию однократный fallback в plain text. Общие
mutating-запросы автоматически не повторяются.

MAX Advance Media → Upload Binary выполняет двухэтапную загрузку и возвращает type,
payload, а также token/url, если они доступны. Поддерживаются image, video, audio,
file с лимитами из официальной документации.

Trigger

При активации trigger регистрирует свой HTTPS webhook, а при деактивации удаляет только его.
All Events не передаёт update_types, поэтому принимает и будущие типы событий. Selected Events ограничивает подписку выбранными типами. Можно задать secret и фильтры user/chat ID.

Webhook должен быть доступен через HTTPS на порту 443 с доверенным TLS-сертификатом. Secret
проверяется по X-Max-Bot-Api-Secret до запуска workflow.

Релиз

CI проверяет lint, build, tests и содержимое npm archive. Теги v*.*.* запускают публикацию
через npm Trusted Publisher/OIDC; remote и публикация настраиваются отдельно владельцем.

Лицензия

MIT © 2026 Catalogicus International.

Discussion