статья 23 октября 2026· 6 мин чтения· Команда AISSE

MAX API для бизнеса: интеграция и отправка сообщений

Что есть в Bot API мессенджера MAX, как получить токен и передавать его в запросах, как отправлять сообщения, чем вебхук отличается от опроса обновлений, какие ограничения учитывать и с чего начать разработчику.

API мессенджера MAX для бизнеса — это Bot API: HTTP-интерфейс, через который бот компании получает сообщения пользователей и отправляет ответы, файлы и кнопки. Запросы идут по HTTPS, ответы приходят в JSON, токен бота передаётся в заголовке Authorization. Получать события можно двумя способами: опросом (GET /updates) или вебхуком (POST /subscriptions).

Статья — для разработчиков и тех, кто ставит им задачу. Если бот нужен без кода, начните со статьи как создать чат-бота в MAX.

Что есть в API

Bot API MAX покрывает основные задачи бота:

сообщения — отправка текста, медиа и файлов, редактирование и удаление;
кнопки — клавиатуры в сообщениях и обработка нажатий;
события — новые сообщения, нажатия кнопок, добавление бота в чат;
чаты — информация о чатах и участниках, где бот состоит;
файлы — загрузка и получение вложений;
мини-приложения — запускаются из бота, у них свой набор методов на стороне клиента.

Полный список методов и форматов — в официальной документации на dev.max.ru. Ниже — то, что нужно, чтобы начать.

Токен и доступ

Верифицированный профиль. Создавать ботов могут верифицированные организации, ИП и самозанятые — резиденты РФ. Подробно — в статье MAX для бизнеса.
Бот и токен. Бот создаётся на платформе MAX для партнёров, там же выдаётся токен.
Передача токена. По документации токен передаётся в заголовке запроса:

Authorization: <токен>

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

Базовый адрес API указан в документации; в 2026 году он менялся, поэтому берите его оттуда, а не из примеров в интернете.

Храните токен в переменных окружения или хранилище секретов, не в коде и не в репозитории.

Отправка сообщений

MAX API для отправки сообщений — метод POST /messages. В запросе указывается, кому отправить — пользователю или в чат, — и тело сообщения: текст, вложения, кнопки.

Схематично:

POST /messages?user_id=<id получателя>
Authorization: <токен>
Content-Type: application/json

{"text": "Ваш заказ передан в доставку"}

Точные имена параметров и формат тела сверяйте с документацией — они могут отличаться от этого упрощённого примера.

Важное ограничение: бот обычно может писать только тем, кто начал с ним диалог или находится в чате, где есть бот. Массовые рассылки «по базе телефонов» через Bot API не делаются — для уведомлений и рассылок у платформы и её партнёров есть отдельные условия.

Вебхуки или опрос

Опрос (long polling), GET /updates. Ваш сервер сам спрашивает у API новые события. Удобно для разработки и отладки: не нужен публичный адрес.

Вебхук, POST /subscriptions. Вы регистрируете адрес, и MAX сам присылает туда события. Это основной вариант для рабочего бота: быстрее и не нужно постоянно опрашивать API.

Требования к вебхуку:

адрес работает по HTTPS с действительным сертификатом;
сервер быстро отвечает на запрос — тяжёлую обработку лучше выносить в очередь;
обработчик выдерживает повторы — одно событие может прийти дважды.

Ограничения и правила

Лимиты запросов. При превышении API возвращает код 429. Конкретные лимиты смотрите в документации и закладывайте очередь с повторами.
Коды ошибок. 401 — проблема с токеном, 400 — ошибка в запросе, 404 — не найдено, 503 — сервис временно недоступен. Для 429 и 503 — повтор с паузой.
Правила платформы. Боты и их содержание должны соответствовать правилам MAX; публикация может проходить проверку.
Персональные данные. Если бот собирает имя, телефон, адрес — нужно согласие и соблюдение 152-ФЗ.
Реклама. Рекламные сообщения требуют согласия получателя по закону о рекламе.

С чего начать разработчику

Прочитайте документацию на dev.max.ru — раздел о Bot API и, если нужно, о мини-приложениях.
Получите токен тестового бота.
Запустите опрос GET /updates локально и убедитесь, что события приходят.
Отправьте ответ через POST /messages.
Посмотрите официальные и популярные библиотеки для вашего языка — они берут на себя формат запросов.
Перед запуском переведите бота на вебхук, настройте очередь, логи и обработку ошибок.

Вывод и следующий шаг

API мессенджера MAX — это Bot API: HTTPS-запросы, ответы в JSON, токен в заголовке Authorization. Сообщения отправляются через POST /messages, события получают опросом GET /updates или вебхуком POST /subscriptions. Для рабочего бота нужны вебхук по HTTPS, очередь с повторами на 429 и соблюдение правил платформы, закона о персональных данных и закона о рекламе.

Если вы связываете бота с другими системами, полезно, чтобы и сайт отдавал события наружу. У AISSE есть публичный API и события: заявки и запросы поиска можно получать вебхуком и передавать в CRM или другие сервисы. Если вопросы покупателей приходят ещё на сайте, их закрывает Ассистент AISSE: отвечает по справке и страницам сайта, проверяет статус заказа и передаёт сложное оператору.

Частые вопросы

Что такое API мессенджера MAX?

Bot API — HTTP-интерфейс для ботов: получать сообщения и события, отправлять ответы, файлы и кнопки.

Как получить токен MAX API?

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

Как отправить сообщение через MAX API?

Методом POST /messages с токеном в заголовке Authorization, указав получателя и текст сообщения.

Вебхук или long polling?

Опрос удобен для разработки, вебхук — для рабочего бота: события приходят сразу, без постоянных запросов.

Можно ли делать массовые рассылки через Bot API?

Бот пишет тем, кто начал с ним диалог или состоит в чате. Для массовых уведомлений у платформы и партнёров отдельные условия.

Где документация MAX API?

На портале для разработчиков dev.max.ru. Адреса и параметры берите оттуда: в 2026 году они менялись.