Мини-приложения
Создание
Можно ли добавить мини-приложение в MAX без чат-бота?
Нет, подключить дополнительные сервисы к MAX, управлять ими и запускать можно только с помощью чат-бота. Через него мини-приложения взаимодействуют с API ботов
Как подключить мини-приложение к MAX?
- Перейдите на платформу MAX для партнёров в раздел Чат-боты
- Выберите необходимого бота и нажмите ⋮ → Настройки
- Вставьте URL мини-приложения в поле для ссылки
- Выберите вид кнопки открытия мини-приложения (Открыть, Старт, Играть или без названия) и нажмите Сохранить
Требования к URL мини-приложения:
- Длина: не более 1024 символов
- Протокол: только https://
- Допустимые символы: буквы (латиница), цифры, точка (.) и дефис (-)
- Пробелы не поддерживаются
- URL должен быть валидный
Подробнее об интеграции мини-приложений — в разделе «Как добавить мини-приложение в MAX»
Есть ли ограничения на контент для мини-приложений?
Ограничения есть. Внимательно изучите Правила платформы перед размещением мини-приложения в MAX и убедитесь, что оно безопасно для пользователей и соответствует требованиям к содержанию и функциональности
Управление
Как обновить ссылку на приложение?
- Перейдите на платформу MAX для партнёров в раздел Чат-боты
- Выберите необходимого бота и нажмите ⋮ → Настройки
- Обновите URL мини-приложения в поле для ссылки и нажмите Сохранить
Как изменить кнопку открытия приложения?
- Перейдите на платформу MAX для партнёров в раздел Чат-боты
- Выберите необходимого бота и нажмите ⋮ → Настройки
- Выберите нужный вид кнопки и нажмите Сохранить
Как удалить приложение?
- Перейдите на платформу MAX для партнёров в раздел Чат-боты
- Выберите необходимого бота и нажмите ⋮ → Настройки
- Удалите URL мини-приложения из поля для ссылки и нажмите Сохранить
Использование
Можно ли обновлять опубликованное мини-приложение?
Да, вы можете вносить изменения, если у мини-приложения статичный URL. После деплоя пользователи просто запустят обновлённую версию
Если ссылка поменялась:
- На платформе MAX для партнёров выберите нужную организацию, перейдите в раздел Чат-боты
- Выберите бота, в который было добавлено мини-приложение, и нажмите ⋮ → Настройки
- Укажите новую ссылку и нажмите Сохранить
Можно ли открыть несколько мини-приложений одновременно?
Нет, при открытии нового мини-приложения текущее закроется. Мы работаем над поддержкой одновременной работы нескольких мини-приложений
В чём разница между функциями openLink и openMaxLink?
openLink откроет любую ссылку во внешнем браузере. openMaxLink откроет только ссылку на мини-приложение вида https://max.ru/<botName>?startapp внутри приложения MAX — в новой шторке, без перехода во внешний браузер
Как скачивать файлы с помощью MAX Bridge?
Для скачивания файлов используйте метод window.WebApp.downloadFile(url, file_name)
Скачивание файла через href не поддерживается
Как скачивать файлы без использования MAX Bridge?
Запасной способ скачивания файлов, если использование MAX Bridge недоступно:
// Скачивание файла по ссылке в виде бинарных данных
fetch(url)
// Преобразование ответа сервера в объект `Blob`
.then(function (r) { return r.blob(); })
.then(function (blob) {
// Создание временной локальной ссылки для скачивания файла в памяти браузера
var a = document.createElement('a');
a.href = URL.createObjectURL(blob);
// Динамическое создание скрытой ссылки на странице: задаётся имя файла `document.pdf`, имитируется клик `a.click()` для запуска скачивания
a.download = 'document.pdf';
a.click();
// Очистка памяти
URL.revokeObjectURL(a.href);
});
// Работает, если у файла открыт CORS (`Access-Control-Allow-Origin`)
Выберите один из способов:
window.WebApp.downloadFile(url, file_name)или<a download>. Одновременное использование обоих способов одном клике приведет к конфликту