Мини-приложения

Создание

Можно ли добавить мини-приложение в MAX без чат-бота?

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

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

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

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

Подробнее об интеграции мини-приложений — в разделе «Как добавить мини-приложение в MAX»

Есть ли ограничения на контент для мини-приложений?

Ограничения есть. Внимательно изучите Правила платформы перед размещением мини-приложения в MAX и убедитесь, что оно безопасно для пользователей и соответствует требованиям к содержанию и функциональности

Управление

Как обновить ссылку на приложение?
  1. Перейдите в профиль организации на платформе MAX для партнёров
  2. Если у вас несколько ботов, в левом верхнем углу выберите нужный
  3. Перейдите в раздел Чат-бот и мини-приложениеНастроить
  4. Обновите URL мини-приложения в поле для ссылки и нажмите Сохранить
Как изменить кнопку открытия приложения?
  1. Перейдите в профиль организации на платформе MAX для партнёров
  2. Если у вас несколько ботов, в левом верхнем углу выберите нужный
  3. Перейдите в раздел Чат-бот и мини-приложениеНастроить
  4. Выберите нужный вид кнопки и нажмите Сохранить
Как удалить приложение?
  1. Перейдите в профиль организации на платформе MAX для партнёров
  2. Если у вас несколько ботов, в левом верхнем углу выберите нужный
  3. Перейдите в раздел Чат-бот и мини-приложениеНастроить
  4. Удалите URL мини-приложения из поля для ссылки и нажмите Сохранить

Использование

Можно ли обновлять опубликованное мини-приложение?

Да, вы можете вносить изменения, если у мини-приложения статичный URL. После деплоя пользователи просто запустят обновлённую версию

Если ссылка поменялась, на платформе MAX для партнёров выберите нужную организацию, перейдите в раздел Чат-бот и мини-приложениеНастроить, укажите новую ссылку и нажмите Сохранить

Можно ли открыть несколько мини-приложений одновременно?

Нет, при открытии нового мини-приложения текущее закроется. Мы работаем над поддержкой одновременной работы нескольких мини-приложений

В чём разница между функциями openLink и openMaxLink?

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