Содержание
Как это работает изнутри
Запрос пользователя уходит через MAX Bot API на сервер компании или в конструктор, ответ возвращается в формате JSON. REST-интерфейс работает на platform-api.max.ru с лимитом 30 rps. Аутентификация — через заголовок Authorization, старый способ передачи через query-параметры больше не принимается.
Минимальный запрос для проверки подключения:
https://platform-api.max.ru/me
Authorization: <token>
Сервер вернёт имя, ник и идентификатор сервиса. Текстовые сообщения поддерживают разметку Markdown и HTML — тип задаётся параметром format в теле запроса.
Кто может подключиться
Регистрация сервиса на платформе MAX для партнёров открыта юридическим лицам и ИП с российской пропиской. Частные лица к созданию не допускаются.
До первого запуска организация проходит верификацию. Лимит — пять единиц на одну компанию, каждая настраивается независимо. Несколько нужны там, где у бизнеса разные представительства или принципиально разные сценарии — объединить их в одном потоке не получится.
Карточка: что важно знать заранее
Одно поле карточки изменить после регистрации нельзя — ник. Он генерируется автоматически по шаблону idИНН_bot и сразу становится частью публичной ссылки https://max.ru/idИНН_bot. Когда функция редактирования появится, ник должен начинаться со строчной буквы без @, заканчиваться на _bot или bot, содержать от 11 до 60 символов латиницы, цифр и знаков подчеркивания. Менять его потом не получится — стоит учитывать это на старте.
Всё остальное редактируется. Название отображается в диалоге — до 59 символов без эмодзи. Логотип становится аватаром: квадрат 500×500 px в формате .jpg, .jpeg или .png, вес до 5 МБ, кадрирование доступно прямо в интерфейсе. Описание ограничено 200 символами — суть сервиса, задачи, контакт поддержки. Необязательно добавляются сайт на https:// и телефон начиная с +7.
В логотипе и текстах запрещены нецензурная лексика, материалы 18+ и данные чужих компаний.
Модерация: три исхода
Заполненная карточка уходит на проверку — срок до двух рабочих дней. В этот период вносить изменения нельзя.
По итогам возможны три варианта. Статус «создан» — проверка пройдена, сервис появляется в поиске MAX, открываются расширенные настройки и подключение к партнёрским системам. Статус «требует исправлений» — платформа указала причину отказа, после правок заявка отправляется повторно. При изменении настроек уже работающего сервиса он снова уходит на проверку: пользователи тем временем видят прежнюю версию.
Токен и безопасность
После успешной проверки в разделе Чат-боты → Интеграция → Получить токен появляется строка вида:
AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw
Это единственный ключ к управлению через API. Попав к посторонним, он даёт полный контроль от имени организации — хранить его в публичных репозиториях или передавать третьим лицам небезопасно. При подозрении на утечку строка меняется: кнопка обновления находится справа от поля в том же разделе.
Конструктор или API
Получив токен, компания выбирает способ сборки сценариев — готовый конструктор или прямая разработка.
Конструктор закрывает стандартные задачи: воронки, FAQ, сбор заявок, прогрев. На январь 2026 года платформа официально интегрирована с 7 партнерскими сервисами. Токен вставляется в настройках конструктора, дальше сценарий собирается визуально. LEADTEX работает с MAX наравне с Telegram — единая база контактов и аналитика для всех каналов из одного кабинета.
Прямая разработка нужна там, где логика выходит за рамки шаблонов: сложные воронки, интеграции с внутренними системами, нестандартные обработчики. Официальные библиотеки для TypeScript и JavaScript доступны в разделе «Библиотека MAX Bot API» и на GitHub. Команды задаются самостоятельно — предустановленных нет.
Webhook и Long Polling
Два метода получения событий — одновременно не работают, выбирается один.
Webhook реагирует мгновенно: платформа сама отправляет запрос на сервер при каждом действии пользователя. Нужен публичный адрес с HTTPS — самоподписанные сертификаты принимаются, HTTP нет. Подписка оформляется POST-запросом к /subscriptions, уведомления читаются GET-запросом туда же. Метод для боевого окружения.
Long Polling работает иначе: сервер сам периодически спрашивает платформу о новых событиях через GET-запрос к /updates. Публичный адрес не нужен, но при высокой нагрузке метод накапливает очередь незакрытых соединений. Остаётся инструментом разработчика. Уведомления платформа держит в буфере до 8 часов.
Deep linking
Специальный формат ссылки запускает сервис с параметрами:
https://max.ru/<botName>?start=<payload>
Через payload длиной до 128 символов передаётся контекст первого касания — источник перехода, реферальный код, идентификатор кампании. Если строка длиннее лимита, данные не доходят. Несколько параметров пакуются в одну строку: ?start=param1_value1_param2_value2.
При открытии ссылки приходит событие bot_started с полями update_type, payload, chat_id и данными пользователя: user_id, name, username. Чтобы payload попал в Webhook, тип bot_started должен быть включён в update_types. Работает на iOS 2.7.0+ и Android 2.9.0+.
Что автоматизируется
Поддержка первой линии — наиболее распространённый сценарий. Сервис отвечает круглосуточно на типовые вопросы: статус заказа, условия доставки, часы работы. Операторы подключаются только там, где алгоритм не справляется. Правильно настроенный сценарий закрывает до 80% обращений без человека.
Квалификация лидов строится иначе. Сервис собирает данные, задаёт уточняющие вопросы и передаёт в CRM уже размеченный контакт — менеджер видит карточку с историей, а не пустое сообщение.
Запись и оформление заказов автоматизируются через сценарий с выбором услуги, времени и подтверждением. Там где нужен полноценный интерфейс с каталогом или формой, сервис открывает мини-приложение прямо внутри мессенджера.
Проактивные уведомления — напоминания о записи, статусы заказов, сервисные сообщения — отправляются первыми без входящего триггера. Массовые рассылки по базе пока в разработке.
Ограничения
Пять сервисов на организацию — жёсткий лимит. Ник после создания не меняется, передать права другой компании нельзя, восстановить удалённый — тоже. Запрет добавления в групповые чаты автоматически распространяется и на каналы: разрешение включается в настройках Чат-боты → Чат-бот и мини-приложение → Настроить. Inline-режим, тестовая среда и локальный API не реализованы. Настройки уведомлений конкретного пользователя через API недоступны.
От верификации организации до рабочего сценария — четыре этапа: карточка, модерация до 48 часов, токен, подключение конструктора или разработка. Весной 2026 года платформа снимает ограничения по доступу для всех российских компаний. Компании, запускающие автоматизацию сейчас, отрабатывают сценарии до момента, когда аудитория канала продолжит расти.
LEADTEX поддерживает MAX наравне с Telegram и ВКонтакте — единый конструктор, одна база контактов, управление для всех каналов из одного кабинета. Тестовый период — 7 дней без ограничений по функционалу.