# Версии и публикация

## Версии

Схема приложения хранится в версиях. Вы правите одну версию, а люди по ссылке видят другую — опубликованную. Так приложение можно переделывать, не ломая то, что уже работает.

Меню версий — справа на панели над картой. Пока версия одна и ещё не опубликована, там стоит зелёная кнопка «Опубликовать», а остальные пункты — под стрелкой рядом. Потом на её месте кнопка «Версия N».

В меню «Версии»:

- список версий с датой последней правки; опубликованная отмечена «опубликована». Клик по версии открывает её в конструкторе;
- значок корзины в строке — «Удалить версию». Удалить нельзя единственную и опубликованную версию;
- «Скопировать ссылку» — ссылка на приложение;
- «Создать новую версию» — копия открытой версии со всеми экранами, цветами и кодом приложения. Новая версия сразу открывается;
- «Сохранить как шаблон» — см. [Создание приложения](https://support.watbot.ru/mini-apps/create);
- «Опубликовать» или «Снять с публикации» — для открытой версии.

![Меню версий: опубликованная версия и новая](https://support.watbot.ru/_media/ru/02-mini-apps/_images/versions.webp?v=1791781230)

Когда в версии есть экраны магазина или записи на приём, в меню есть и пункт «Магазин и филиал» — выбранный магазин и филиал подставляются во все элементы и блоки версии разом.

У приложения — до 50 версий.

> [!TIP]
> Большие изменения делайте в новой версии: опубликованная продолжает работать, пока вы собираете и проверяете следующую в предпросмотре.

## Опубликовать

По ссылке приложения открывается только опубликованная версия. Пока ни одна версия не опубликована, вместо приложения человек увидит «Приложение ещё не опубликовано.»

1. Откройте нужную версию в конструкторе.
2. Нажмите «Опубликовать» — кнопку на панели или пункт в меню версий.
3. Если опубликованная версия уже есть, подтвердите замену. Опубликованной может быть только одна версия: прежняя перестанет открываться, новая займёт её место.

**«Снять с публикации»** — версия перестаёт открываться по ссылке, и приложение снова отвечает «Приложение ещё не опубликовано.»

Публиковать версии может тот, у кого есть право «Сборка мини-приложения», а владелец — с подпиской Pro.

## Подключить бота

Чтобы приложение открывалось в Telegram, MAX и чате на сайте, к нему нужно подключить бота. По токену бота платформа проверяет, что приложение открыто из мессенджера, и узнаёт человека.

Если после публикации к приложению не подключено ни одного бота, откроется окно «Приложение опубликовано»:

1. В поле «Боты, из которых открывают приложение» выберите ботов проекта. Если бот в проекте один, он уже выбран.
2. Нажмите «Подключить».

![Окно «Приложение опубликовано»: ссылка и выбор ботов](https://support.watbot.ru/_media/ru/02-mini-apps/_images/published.webp?v=1791781230)

Окно можно закрыть кнопкой «Позже» и подключить ботов в любой момент в разделе «Настройки» приложения — в том же поле.

- Подключать можно только ботов того же проекта, не больше 20.
- Блоки «Сценарий бота» и подсказки тегов контакта работают с подключёнными ботами.

## Настройки приложения

Раздел «Настройки» в меню приложения — окно «Настройки приложения»:

| Поле | Что задаёт |
|---|---|
| «Название» | Название приложения в кабинете, в заголовке страницы и под значком на экране телефона |
| «Боты, из которых открывают приложение» | Подключённые боты — см. выше |
| «Иконка приложения» | Квадратная картинка, минимум 512×512: JPEG, PNG, GIF, WebP или AVIF, до 5 МБ. Без неё приложение нельзя поставить на домашний экран. Кнопки — «Загрузить иконку», «Заменить иконку», «Удалить» |
| «Новых гостей в час с одного адреса» | Лимит гостей — см. [Пользователи](https://support.watbot.ru/mini-apps/users) |
| «Ссылка на приложение» | Адрес приложения и кнопка копирования |

![Раздел «Настройки» мини-приложения](https://support.watbot.ru/_media/ru/02-mini-apps/_images/settings.webp?v=1791781230)

Изменения применяются кнопкой «Сохранить». Иконку можно сменить и из переключателя приложений вверху бокового меню — пункт «Сменить иконку».

## Ссылка на приложение

Ссылка выглядит так: `https://app-код.домен/секрет`. У каждого приложения свой адрес — его не нужно составлять вручную, скопируйте готовый:

- в «Настройках» приложения — поле «Ссылка на приложение»;
- в конструкторе — меню версий → «Скопировать ссылку»;
- в окне «Приложение опубликовано».

Ссылка не меняется от версии к версии: после публикации новой версии её не нужно обновлять в кнопках бота.

### Параметр ссылки

К ссылке можно добавить параметр: `…/секрет?startapp=promo`. Значение попадёт в переменную `startParam`, а условие «Параметр ссылки» поможет открыть разным людям разные экраны — например, отличить переход из рекламы от перехода из рассылки. Параметр — до 512 символов.

## Как открыть приложение из бота

### Telegram

Поставьте в сообщение бота кнопку с типом «Web App»:

1. В схеме бота откройте блок с сообщением и добавьте кнопку.
2. В окне «Настройка пункта меню» выберите «Тип команды» — «Web App».
3. В поле «URL» вставьте ссылку на приложение.
4. Сохраните кнопку.

По нажатию приложение откроется внутри Telegram, и платформа узнает человека. Подробнее о кнопках — на странице [Сообщения](https://support.watbot.ru/chatbots/blocks/messages).

### MAX

В MAX кнопка открывает только тот адрес, который указан в кабинете «MAX для бизнеса», в настройках мини-приложения бота. Поэтому:

1. Скопируйте ссылку на приложение и укажите её в кабинете «MAX для бизнеса» — в настройках мини-приложения бота.
2. Подключите этого бота к приложению в «Настройках».
3. Поставьте в сообщение бота кнопку «Web App» с той же ссылкой.

Кнопка «Web App» в MAX открывает приложение, только если ссылка ведёт в приложение платформы, подключённое к этому боту. Иначе кнопка уйдёт обычной ссылкой и откроется в браузере. Параметр `startapp` из ссылки MAX передаёт в приложение.

### Чат на сайте

Кнопка «Web App» со ссылкой на приложение платформы открывает его поверх чата, не уводя посетителя с сайта. Приложение узнаёт в посетителе контакт чата. Бот должен быть подключён к приложению. Подробнее о чате — на странице [Веб-чат](https://support.watbot.ru/chatbots/channels/web).

### Браузер и экран телефона

Ссылку можно разместить где угодно: на сайте, в соцсетях, в рассылке, в QR-коде. В браузере человек открывает приложение как гость.

Если у приложения есть иконка, браузер телефона предложит поставить его на домашний экран. Так приложение открывается без адресной строки, как обычное. Установка работает только по защищённому адресу `https://`.

Во ВКонтакте и Viber кнопка «Web App» работает как обычная: человеку можно отправить ссылку — приложение откроется в браузере.

## Если приложение не открывается

- **«Приложение ещё не опубликовано.»** Опубликуйте версию.
- **«Не удалось проверить, кто открыл приложение. Проверьте, что бот привязан в настройках приложения.»** Приложение открыли из бота, который к нему не подключён. Подключите бота в «Настройках».
- **В MAX кнопка открывает браузер или другое приложение.** Проверьте адрес в кабинете «MAX для бизнеса» и что бот подключён к приложению.
- **«Сессия истекла, откройте приложение заново.»** Человек долго не заходил — пусть откроет приложение снова.
- **«Слишком много новых посетителей с вашего адреса, попробуйте позже.»** Сработал лимит гостей — см. [Пользователи](https://support.watbot.ru/mini-apps/users).
- **«Слишком много действий подряд, подождите минуту.»** Больше 240 нажатий в минуту от одного человека.
- **Приложение не предлагает установку на экран телефона.** Загрузите иконку в «Настройках».