n8n-nodes-max

n8n community node для интеграции с MAX Мессенджер API.

MAX — российский мессенджер с открытым API для бизнеса и ботов.

n8n — платформа автоматизации workflow с открытым кодом.

Установка

Через n8n (рекомендуется)

1. Откройте Settings > Community Nodes
2. Нажмите Install
3. Введите @alex_rexby/n8n-nodes-max
4. Нажмите Install

Через npm

npm install @alex_rexby/n8n-nodes-max

Настройка credentials

1. Создайте бота через MAX Bot API
2. Скопируйте токен бота
3. В n8n создайте credentials:
   • Тип: MAX API
   • Token: ваш токен бота

Ноды

MAX (действия)

Сообщения

| Операция | Описание | |----------|----------| | Отправить текст | Текстовое сообщение пользователю или в чат | | Отправить с медиа | Сообщение с файлами (фото, видео, аудио, документы) | | Получить | Получить сообщение по ID | | Редактировать | Изменить существующее сообщение | | Удалить | Удалить сообщение |

Чаты

| Операция | Описание | |----------|----------| | Список чатов | Получить все чаты бота | | Информация о чате | Получить данные конкретного чата | | Обновить чат | Изменить название / описание | | Действие в чате | Отправить статус (печатает, отправляет фото...) | | Закрепить / Открепить | Закрепить или открепить сообщение | | Удалить чат | Удалить чат |

Участники

| Операция | Описание | |----------|----------| | Список участников | Получить участников чата | | Добавить участников | Добавить пользователей в чат | | Удалить участника | Удалить пользователя из чата | | Список админов | Получить администраторов чата | | Назначить админа | Сделать пользователя админом | | Снять админа | Убрать права администратора |

Бот

| Операция | Описание | |----------|----------| | Информация | Получить данные бота (ID, имя, статус) |

Callback

| Операция | Описание | |----------|----------| | Ответить | Ответ на нажатие inline-кнопки | | Ответить и отправить | Ответ на callback + новое сообщение |

Возможности

• Отправка в личку (user_id) и чаты/каналы (chat_id)
• Несколько файлов в одном сообщении (фото, видео, аудио, документы)
• Inline-кнопки (визуальный конструктор или JSON)
• Форматирование текста (Markdown, HTML)
• Ответ на сообщение (reply)
• Беззвучные сообщения
• Отключение превью ссылок

MAX Trigger (триггер)

Polling-триггер для получения событий из MAX в реальном времени.

Режимы

• Все события — получать всё (для тестирования)
• Выбранные события — фильтр по типам:
  • Новое сообщение (message_created)
  • Сообщение отредактировано (message_edited)
  • Сообщение удалено (message_removed)
  • Нажатие на кнопку (message_callback)
  • Старт бота (bot_started)

Как использовать

1. Добавьте ноду MAX Trigger в workflow
2. Укажите credentials (MAX API)
3. Выберите режим событий
4. Активируйте workflow
5. Бот начнёт получать обновления через long polling

Примеры

Отправка текста

• User ID: 4624138
• Текст: Привет из n8n!

Отправка в канал

• Chat ID: -70931657203722
• Текст: Новое объявление!

Отправка фото с подписью

• User ID: 4624138
• Бинарное свойство: data
• Подпись: Смотрите что нашёл!

Несколько файлов в одном сообщении

• User ID: 4624138
• Бинарные свойства: photo1, photo2, document
• Подпись: Три файла в одном сообщении

Сообщение с кнопками

• User ID: 4624138
• Текст: Выберите действие:
• Добавить кнопки: да
• Кнопка 1: Вариант A → Callback → option_a
• Кнопка 2: На сайт → Link → https://example.com

Триггер + обработка событий

1. Добавьте MAX Trigger (все события)
2. Подключите к ноде Switch / IF для фильтрации по update_type
3. Обрабатывайте разные типы событий в отдельных ветках

Совместимость

• n8n: 1.0.0+

Ссылки

• MAX API документация
• MAX Bot Platform
• n8n Community Nodes

История версий

0.4.34

• Триггер переделан на polling (poll() + polling: true)
• Поддержка нескольких файлов в одном сообщении
• Удалена утечка _debug данных из ответов
• Очистка от мусорных файлов

0.4.20

• Исправлена загрузка медиа (multipart/form-data)
• Поддержка каналов/групп (chat_id с -)

0.4.0

• Первый релиз
• Сообщения, кнопки, webhook-триггер

Лицензия

MIT

Поддержка

• MAX Developer Portal