MAX — мессенджер VK Group с Bot API для личных чатов и бесед.
С MAX в Pailot вы можете:
- Получать сообщения — процесс стартует, когда пользователь пишет боту (триггер)
- Отправлять ответы — в личный чат или в беседу, с Markdown или HTML
Типичный сценарий: пользователь пишет боту → триггер MAX запускает процесс → агент готовит ответ → блок MAX «отправить сообщение» возвращает текст.
Как подключить
Интеграция использует Bot Token — токен бота MAX.
- Откройте business.max.ru
- Раздел Чат-боты → Интеграция
- Нажмите Получить токен и вставьте его в блок
Инструменты
max_send_message
Отправить текст пользователю или в чат. После триггера передайте sender.id (личный ответ) или recipient.id (группа).
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
botToken | string | Да | Токен с business.max.ru → Чат-боты → Интеграция |
userId | number | Нет* | ID пользователя. Из триггера: <TriggerBlock.sender.id> |
chatId | number | Нет* | ID чата. Из триггера: <TriggerBlock.recipient.id> |
text | string | Да | Текст, до 4000 символов |
format | string | Нет | markdown или html. Пусто — обычный текст |
* Нужно ровно одно: userId или chatId.
Выход: message, data (id, body, text, timestamp).
Триггер: max_webhook
Запуск процесса, когда пользователь пишет боту или начинает диалог.
| Параметр | Описание |
|---|---|
| Webhook URL | Генерируется автоматически |
| Bot Token | Токен с business.max.ru |
| Webhook Secret | Необязательный секрет (5–256 символов: A–Z a–z 0–9 _ -). Если задан, MAX передаёт его в заголовке X-Max-Bot-Api-Secret. Для промышленной эксплуатации рекомендуется |
Вебхук — входящий HTTP-запрос от MAX. Сохраните токен (и секрет, если задаёте) в блоке — входящие сообщения начнут запускать процесс.
Выходы триггера: message.id / text / date / messageType, sender.id / username / firstName / lastName / isBot, recipient.id, updateType (message_created, bot_started), timestamp, userLocale.
Типичный процесс
[MAX, триггер] → [Агент] → [MAX, отправить сообщение]- Триггер получает входящий текст
- Агент читает
<MAX1.message.text>и формулирует ответ - Отправка: в User ID укажите
<MAX1.sender.id>
Ограничения
| Ограничение | Детали |
|---|---|
| Длина | Максимум 4000 символов |
| Формат | Markdown и HTML; без поля format — обычный текст |
| Получатель | Либо userId, либо chatId, не оба сразу |
| Документация | dev.max.ru/docs-api |