Чат-бот и мини-приложение в MAX решают разные части одной задачи. Бот ведёт диалог, направляет пользователя и отправляет сообщения. Mini App даёт удобный интерфейс для выбора, заполнения и подтверждения данных.
Связка нужна, когда бизнес хочет не только отвечать в мессенджере, но и доводить клиента до структурированного действия: заявки, записи, заказа, подбора или обращения в поддержку.
Роль чат-бота
Бот работает в диалоговом интерфейсе. Он может:
- приветствовать пользователя и объяснять возможности;
- показывать основные действия кнопками;
- отвечать на частые вопросы;
- запрашивать контакт;
- открывать нужный экран Mini App;
- принимать события от backend;
- отправлять подтверждения и статусы;
- передавать диалог оператору.
Бот особенно эффективен для коротких сценариев. Если нужно задать два-три вопроса и передать результат, отдельный Mini App может быть избыточным.
Роль мини-приложения
Mini App используется для действий, которые неудобно выполнять сообщениями:
- выбирать дату в календаре;
- просматривать карточки и изображения;
- применять фильтры;
- заполнять несколько связанных полей;
- сравнивать варианты;
- редактировать корзину;
- смотреть историю и статусы;
- работать с личным кабинетом.
Интерфейс снижает когнитивную нагрузку: пользователь видит структуру целиком, может вернуться на предыдущий шаг и сразу понимает, какие данные требуются.
Как работает общая связка
Типовой поток выглядит так:
- Пользователь пишет боту или нажимает кнопку из канала.
- Бот определяет задачу и открывает Mini App с нужным контекстом.
- Mini App получает данные запуска через MAX Bridge.
- Пользователь выполняет действие.
- Backend проверяет данные и обращается к CRM или внутренней системе.
- Mini App показывает результат.
- Бот отправляет подтверждение и остаётся каналом дальнейшей коммуникации.
Для перехода сразу к определённому экрану можно использовать диплинки с параметром запуска. Параметры необходимо проверять на сервере и не считать доверенными только потому, что они пришли из клиента.
Пример: заявка в отдел продаж
Бот уточняет, что интересует пользователя, и открывает форму с подходящими полями. После отправки backend создаёт лид в CRM, добавляет источник и назначает ответственного. Клиент получает номер обращения и ожидаемый срок ответа.
Преимущество связки в том, что менеджер получает заполненный контекст, а пользователю не приходится описывать задачу свободным текстом.
Пример: запись на услугу
Бот открывает Mini App на экране выбора услуги. Пользователь выбирает филиал, дату и время, после чего backend создаёт запись. Бот отправляет подтверждение, напоминание и ссылку на перенос.
Если свободных слотов нет, Mini App предлагает альтернативы, а бот может сообщить о появлении времени.
Пример: каталог и заказ
Пользователь переходит из сообщения о конкретной акции сразу в нужную категорию. В Mini App он выбирает товар и оформляет заказ. Backend проверяет цену и наличие, передаёт данные в учётную систему, а бот сообщает статусы.
Пример: клиентская поддержка
Бот отвечает на простые вопросы и предлагает открыть форму, если нужна помощь сотрудника. Mini App собирает тему, номер заказа и описание. Helpdesk создаёт тикет, а бот возвращает его номер и изменения статуса.
Когда достаточно одного бота
Mini App не нужен, если:
- выбор состоит из нескольких кнопок;
- заявка содержит два-три поля;
- нет визуального каталога;
- пользователь не должен редактировать сложный набор данных;
- сценарий строится вокруг вопроса и ответа;
- бизнес только проверяет интерес к каналу.
Начать с простого бота разумно, если процесс ещё не сформирован. Данные пилота покажут, какие этапы стоит перенести в интерфейс.
Когда нужна связка
Бот и Mini App стоит проектировать вместе, если:
- диалог становится длиннее пяти-семи последовательных выборов;
- пользователю важно видеть доступные варианты;
- есть каталог, календарь или личный кабинет;
- требуется возврат к предыдущим шагам;
- нужно показывать данные из внешней системы;
- после действия необходимы сообщения и статусы;
- сценарий должен открываться по разным диплинкам.
Архитектура и безопасность
Фронтенд Mini App не должен напрямую работать с токеном бота, CRM или 1С. Все секреты хранятся на backend. Сервер проверяет стартовые данные MAX, применяет бизнес-правила и возвращает клиенту только необходимую информацию.
Production-бот получает события через Webhook по HTTPS. Токен передаётся API MAX в заголовке Authorization, а не в URL. Официальная документация также рекомендует Webhook для production и ограничивает Long Polling тестовыми задачами: обзор API MAX.
Нужно отдельно предусмотреть:
- проверку входных данных;
- повторную обработку событий без дублей;
- журналирование ошибок;
- таймауты внешних систем;
- безопасное обновление токена;
- согласия и правила обработки персональных данных;
- роли и права в личном кабинете.
Интеграция с CRM и поддержкой
Связка становится частью бизнеса, когда результат не остаётся только в чате. Backend может:
- создавать лид и контакт;
- добавлять источник и параметры кампании;
- назначать менеджера;
- создавать тикет поддержки;
- получать статус заказа;
- отправлять подтверждение в чат;
- сохранять историю действий для аналитики.
Сценарий нужно тестировать сквозным образом: от нажатия пользователем до появления корректной записи у сотрудника и обратного сообщения клиенту.
Какие события измерять
- запуск бота;
- выбор целевого действия;
- открытие Mini App;
- начало и завершение формы;
- ошибки валидации;
- успешная запись в CRM;
- ответ сотрудника;
- изменение статуса;
- повторное использование.
Если измерять только сообщения боту, невозможно понять, где именно теряются заявки.
Частые ошибки
- Дублировать одинаковый сценарий и в боте, и в Mini App.
- Заставлять пользователя сначала проходить длинный диалог, а затем повторять данные в форме.
- Передавать токен во фронтенд.
- Показывать успех до подтверждения backend.
- Не обрабатывать возврат пользователя и повторный запуск.
- Создавать лид без источника и контекста.
- Не предусматривать подключение оператора.
Частые вопросы
Что лучше запускать первым: бота или Mini App?
Если задача простая или ещё не проверена, начните с бота. Если клиенту сразу нужно выбирать товар, дату, параметры или работать с кабинетом, проектируйте общую связку.
Может ли Mini App отправлять сообщения пользователю?
Сообщения отправляет бот через API. Mini App передаёт результат на backend, после чего бот может подтвердить действие или сообщить статус.
Можно ли добавить Mini App к существующему боту?
Да. После модерации бота в его расширенных настройках указывается HTTPS-адрес мини-приложения и настраивается кнопка запуска.
Нужен ли отдельный backend?
Для демонстрационного статического интерфейса — не всегда. Для заявок, авторизации, интеграций, платежей и работы с персональными данными backend практически необходим.
Можно ли связать решение с оператором поддержки?
Да. Бот может передавать обращение в чат-платформу или helpdesk, а Mini App — собирать структурированные данные до подключения сотрудника.