Приложение MAX для бизнеса: каналы, боты и что можно автоматизировать

Бизнес-часть MAX собрана из трёх модулей: чат-боты, мини-приложения и каналы. Чат-боты делают двумя путями — через конструктор без кода с шаблонами или через API с программированием. Мини-приложение — это веб-приложение на HTML, JS и CSS, которое открывается прямо в мессенджере через библиотеку MAX Bridge. Каналы работают как площадка для публикаций. Эта связка и даёт компании инструменты для потока заявок и уведомлений внутри одной площадки.

Для собственника и руководителя отдела продаж связка «каналы + боты + мини-приложения» — это способ принимать обращения, рассылать уведомления и вести клиента по шагам, не выводя его в отдельный сайт или форму. Один момент закладывается в сроки с самого начала: любой бот и любое мини-приложение проходят модерацию перед публикацией. Это не формальность на один час, и дальше мы покажем, во что она упирается на практике.

Как устроен бот: каналы, чаты, deep-ссылки

Бота добавляют в групповой чат или в канал. В чатах он отвечает на команды и сообщения, в каналах публикует посты. Для работы ему нужны права администратора с разрешениями read_all_messages и write — без них бот не видит входящие и не может отвечать.

Контекст в бота передают через deep-ссылки вида https://max.ru/<botName>?start=<payload>, где payload — до 128 символов. Такая ссылка запускает бота уже с данными: по ней удобно открывать трекинг конкретного заказа или передавать промокод из рекламы. Пользователь нажимает ссылку из письма или с сайта и сразу попадает в нужный сценарий, без лишних вопросов «назовите номер заказа».

Набор действий у бота предсказуемый: он отправляет сообщения и медиафайлы, строит интерфейс из кнопок и клавиатур, редактирует и удаляет ранее отправленные сообщения. У платформы есть официальные библиотеки для TypeScript, JavaScript и Golang и OpenAPI-спецификация — на этой базе и собирают сценарии. Сборку ботов и сценариев в MAX мы ведём на этих средствах, об этом ниже — разработка ботов для MAX начинается с разбора задачи под конкретный сценарий.

Bot API: режимы доставки и лимиты

Bot API MAX работает в двух режимах доставки событий. Webhook — для боевого использования: платформа сама шлёт события на ваш сервер. Long polling, периодические запросы к платформе, — для разработки и тестов. Базовый URL — https://platform-api2.max.ru/, лимит — 30 запросов в секунду.

Технические рамки задают, какие сценарии вообще собираются. Сообщение — до 4000 символов. Редактировать и удалять можно только сообщения не старше 24 часов, так что «подчистить» вчерашнюю рассылку уже не выйдет. Webhook работает лишь по порту 443 и не принимает самоподписанные сертификаты — это прямое требование к серверу, где живёт бот. Из приятного: платформа позволяет загружать файлы до 4 ГБ с докачкой и собирать интерфейс из 210 inline-кнопок в 30 рядах, чего хватает на тяжёлые документы и разветвлённые меню.

Отдельно про миграцию API: токен теперь передаётся только в заголовке Authorization, query-параметры с токеном больше не поддерживаются. Реализации, где токен был зашит в адрес запроса, на этом ломаются — при переносе старого бота это первое, что проверяют.

Требования к публикации: верификация, карточка, модерация

Подключение к платформе доступно юрлицам, ИП и самозанятым-резидентам РФ. Нужны профиль организации, верификация и российский номер телефона. По каналам действует лимит: до 10 публичных каналов для юрлица и ИП и 1 канал для самозанятого — структуру каналов компании планируют под это ограничение заранее.

Карточку бота проверяют жёстко. Ник — от 11 до 60 символов, обязательно заканчивается на bot или _bot. Сайт обязателен и только по протоколу https. В интерфейсе бота должны присутствовать:

• пользовательское соглашение;
• политика конфиденциальности;
• реквизиты организации;
• контакты поддержки.

Без этого карточку не пропускают. Модерация и верификация занимают до 48 часов в рабочие дни, и запуск чаще всего буксует именно здесь: сценарий готов, код написан, а бот стоит в очереди на проверку из-за недооформленной карточки. Эти требования удобнее закрыть до первой отправки на модерацию, чем ходить по второму кругу.

Где сценарии упираются в границы API

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

В мини-приложениях отсутствуют MainButton и CloudStorage. Это значит, что главную кнопку интерфейса и хранение состояния пользователя решают своими средствами — на стороне сервера или в своей базе. Для разработчика это дополнительный слой, для заказчика — лишние часы, которые лучше увидеть в смете заранее.

Рабочие задачи при этом реализуемы. Трекинг заказа, уведомления о статусах, приём обращений — всё это собирается из доступных кирпичей: сообщений, кнопок, клавиатур и deep-ссылок. Граница проходит там, где заканчивается ручная переписка менеджера и начинается сценарий. Бот принимает обращение, сам пишет данные в карточку CRM, ставит задачу ответственному и ведёт клиента по шагам — оператору не нужно переносить номер телефона и суть вопроса руками. Как такой приём и маршрутизацию обращений устроить на стороне CRM, мы разбирали в материале про ИИ в отделе продаж.

Когда сценарии в MAX стоит поднимать с интегратором

Запуск упирается в требования платформы к верификации, карточке и модерации и в границы Bot API. Идея бота тут редко бывает проблемой — время теряется на оформлении и на упор в лимиты, которые вылезают уже в середине сборки. Самостоятельный заход по второму кругу модерации обходится дороже, чем кажется на старте.

Наш порядок работы такой. Разбираем задачу на созвоне и смотрим, какие из нужных вам сценариев укладываются в возможности Bot API, а какие придётся собирать обходным путём. Собираем сценарий под эти возможности, готовим карточку бота под требования модерации — соглашение, политику, реквизиты, контакты — и настраиваем интеграцию с CRM на коде или штатными средствами платформы. No-code-склейка годится для прототипа на месяц; в постоянную работу идёт интеграция, которую можно сопровождать и чинить.

Разбор ведёт Никита Бердников. Вход — бесплатный созвон, после него присылаем план и смету; состав и стоимость этапа — в смете. Логика та же, что и в соседних проектах по ботам и ассистентам: прежде чем писать код, мы собираем сценарий целиком — как это устроено, мы показывали в разборе как собрать ИИ-ассистента.

Итог для компании простой по смыслу. MAX даёт рабочую связку каналов, ботов и мини-приложений, через которую можно принимать обращения и вести клиента внутри мессенджера. Запуск завязан на верификацию, модерацию и границы API, и эти рамки проходят один раз на старте. Сценарии быстрее доходят до работы у тех, кто через эти требования уже проходил, — а дальше бот работает в связке с вашей CRM. Техническую часть, от карточки до интеграции, берём на себя: боты и сценарии для MAX — наша профильная задача.