Мини-приложения в MAX: Руководство для разработчиков

Мини-приложения в мессенджере MAX

Мини-приложения (Web Apps) — это современные веб-сервисы, работающие прямо внутри MAX. Они позволяют бизнесу создавать полноценные интерфейсы для заказов, игр, записи на услуги и других сложных сценариев, не заставляя пользователя выходить из мессенджера.

[!IMPORTANT] Подключить дополнительные сервисы к MAX, управлять ими и запускать можно только с помощью чат-бота. Мини-приложения взаимодействуют с платформой через API ботов.

Как подключить мини-приложение к MAX

Для запуска вашего сервиса выполните следующие шаги:

  1. Профиль организации: Перейдите в личный кабинет на платформе MAX для партнёров.
  2. Настройка бота: Зайдите в раздел Чат-боты → Чат-бот и мини-приложение → Настроить.
  3. URL сервиса: Вставьте ссылку на ваше веб-приложение в поле для URL.
  4. Кастомизация кнопки: Выберите название для кнопки открытия (Открыть, Старт, Играть или оставьте пустой) и нажмите Сохранить.

Требования к URL мини-приложения

  • Протокол: Только https://.
  • Длина: Не более 1024 символов.
  • Символы: Латиница, цифры, точки (.) и дефисы (-).
  • Валидность: URL должен быть рабочим и доступным.

Управление и обновление

Вы можете вносить изменения в работающее приложение в реальном времени.

  • Если URL не меняется: Просто загрузите новую версию на ваш хостинг. Пользователи увидят изменения при следующем запуске.
  • Если URL изменился: Обновите ссылку в панели управления на платформе MAX для партнёров.

Как удалить мини-приложение

Если вам нужно отключить сервис, перейдите в настройки бота и просто удалите URL из соответствующего поля, после чего нажмите Сохранить.

Технические особенности

  • openLink: Открывает любую стороннюю ссылку во внешнем системном браузере.
  • openMaxLink: Открывает ссылку вида https://max.ru/<botName>?startapp внутри MAX (в новой шторке), обеспечивая бесшовный пользовательский опыт.

[!NOTE] На данный момент одновременно может быть открыто только одно мини-приложение. При попытке открыть второе — текущее будет автоматически закрыто.

Частые вопросы (FAQ)

[!TIP] Можно ли запустить мини-приложение без бота? Нет, бот является обязательным связующим звеном.

[!WARNING] Есть ли ограничения на контент? Да, все приложения должны соответствовать Правилам платформы. Запрещён контент, нарушающий законодательство или угрожающий безопасности пользователей.

Источник: help.max.ru (Официальная документация MAX)