# WebApp MAX WebApp — это мини-приложение, которое покупатель открывает прямо внутри MAX, не переходя в обычный браузер. В зависимости от выбранного режима это может быть интернет-магазин с каталогом и оформлением заказов или интерфейс для записи клиентов. Чтобы MAX открывал именно ваше приложение и передавал Меркурию данные покупателя, нужно скопировать специальный URL из ERP и указать его в настройках чат-бота MAX. Раздел: [Дисконтная программа](loyalty.md). ## Где взять URL в Меркурий-ИИ Адрес мини-приложения появляется в Меркурии после подключения чат-бота MAX. ### Шаг 1. Откройте настройки ботов Перейдите в раздел **Розница → Дисконтная программа → Боты**. Найдите блок **«Бот MAX»**. Если MAX ещё не подключён, сначала получите токен в кабинете MAX и выполните подключение в Меркурии. Пока бот не подключён, нужный URL не будет доступен. Инструкция: [«Токен бота MAX»](loyalty-bot-max.md). ### Шаг 2. Найдите поле «WebApp для MAX» После успешного подключения MAX в настройках появится дополнительный блок со ссылкой **«WebApp для MAX»**. В поле отображается готовый адрес мини-приложения. Он предназначен для копирования и не редактируется вручную. Для облачной версии Меркурия используется домен `rus.mercury-erp.ru`. ### Шаг 3. Скопируйте адрес Нажмите кнопку **«Копировать»** рядом с полем. URL будет скопирован целиком, и его можно будет вставить в кабинет MAX. Не пытайтесь самостоятельно составить адрес или заменить в нём домен. Используйте именно то значение, которое показывает Меркурий. Это важно для корректной работы мини-приложения и распознавания покупателя. ### Если раньше был указан другой адрес Если в кабинете MAX ранее настраивалась ссылка на `mercury-ai.ru` или другой адрес, замените её на актуальный URL из поля **«WebApp для MAX»**. Не оставляйте старую ссылку только потому, что она раньше открывала магазин: для MAX необходимо использовать адрес, который сейчас показывает Меркурий. ## Куда вставить URL в кабинете MAX Теперь нужно сообщить MAX, какое мини-приложение следует открывать из вашего чат-бота. ### Шаг 1. Откройте кабинет MAX Перейдите на **платформу MAX для бизнеса** и войдите в аккаунт, в котором создан ваш чат-бот. ### Шаг 2. Выберите нужного бота Откройте раздел **«Чат-боты»** и выберите бота, который подключён к Меркурию. **Это должен быть тот же бот, чей токен вы указали в ERP.** Если у вас несколько ботов, внимательно проверьте название и карточку выбранного бота. Настройка другого бота не изменит работу того, который подключён к Меркурию. ### Шаг 3. Откройте расширенные настройки В карточке выбранного бота перейдите в раздел: **«Расширенные настройки» → «Настроить».** ### Шаг 4. Укажите URL мини-приложения Найдите поле для ссылки мини-приложения. Вставьте в него адрес, который ранее скопировали из Меркурия в поле **«WebApp для MAX»**. Проверьте, что адрес вставлен полностью, без пропущенных символов и лишних пробелов. Не заменяйте его ссылкой на главную страницу сайта или обычной ссылкой интернет-витрины. ### Шаг 5. Настройте кнопку и сохраните изменения В настройках может быть доступен выбор вида кнопки запуска, например **«Открыть»** или **«Старт»**. Выберите подходящий вариант, затем нажмите **«Сохранить»**. После сохранения MAX будет использовать указанный адрес для запуска мини-приложения из чата с ботом. В чате с ботом пользователю станет доступна кнопка запуска приложения. Кроме того, в ответах бота могут отображаться кнопки перехода в магазин, например **«Открыть магазин»**, либо аналогичная кнопка для режима записи. Если позднее URL в Меркурии изменился, повторите эту процедуру и сохраните новый адрес в кабинете MAX. ## Как режим WebApp влияет на работу В Меркурии предусмотрено два варианта использования мини-приложения: - **«Интернет-витрина (магазин)»** — покупатель открывает каталог, выбирает товары и оформляет заказ. - **«Запись клиентов»** — покупатель открывает интерфейс онлайн-записи. Режим выбирается в настройках **Дисконтная программа → Боты**. Он общий для Telegram и MAX: нельзя одновременно настроить магазин в одном мессенджере, а запись — в другом. Если вы переключили режим, сохраните настройки программы. После этого проверьте кнопки запуска и перехода в мини-приложение. Для Telegram дополнительно предусмотрена кнопка **«Синхронизировать Menu Button»**, а для MAX нужно проверить настройки в кабинете MAX. Сам URL WebApp для MAX берите из соответствующего поля в ERP. Не пытайтесь изменить назначение приложения заменой части адреса: режим определяется настройками Меркурия. ## Проверка работы После сохранения настроек проверьте не только открытие приложения, но и то, что MAX передаёт данные покупателя в Меркурий. ### Шаг 1. Откройте мини-приложение Зайдите в MAX под обычным пользовательским аккаунтом и откройте чат с вашим ботом. Нажмите кнопку запуска мини-приложения. Убедитесь, что открылся нужный интерфейс: магазин или запись — в зависимости от выбранного режима. ### Шаг 2. Выполните тестовое действие Если настроен режим магазина, оформите тестовый заказ. Если используется режим записи, выполните тестовую запись. ### Шаг 3. Проверьте результат в Меркурии Откройте соответствующий раздел ERP и найдите созданную заявку. Проверьте, что клиент MAX распознан и в заявке доступна переписка с покупателем. Для магазина дополнительно откройте в боте раздел **«Мои заказы»** и убедитесь, что тестовый заказ отображается в списке. **Правильный результат:** мини-приложение открывается, заявка появляется в Меркурии, покупатель MAX определяется, а переписка с ним доступна в ERP. Для режима магазина тестовый заказ также виден в разделе «Мои заказы» бота. ## Если мини-приложение работает неправильно Если приложение не открывается, открывается не тот экран или заказ поступает без привязки к покупателю, проверьте настройки по порядку. ### Мини-приложение не открывается - Убедитесь, что MAX-бот подключён в Меркурии. - Проверьте, что URL скопирован из поля **«WebApp для MAX»** и полностью вставлен в кабинет MAX. - Убедитесь, что вы изменили настройки именно того бота, который подключён к Меркурии. - После изменения адреса нажмите **«Сохранить»** в кабинете MAX. ### Открывается не тот режим Проверьте переключатель режима WebApp в Меркурии. Если нужен магазин, выберите **«Интернет-витрина (магазин)»**; если нужна онлайн-запись — **«Запись клиентов»**. Сохраните настройки и проверьте, что MAX использует актуальный URL из ERP. ### Заказ появляется, но покупатель не определяется В первую очередь проверьте, что в кабинете MAX указан специальный URL из поля **«WebApp для MAX»**, а не публичная ссылка на сайт или интернет-витрину. Именно использование правильного адреса необходимо для распознавания покупателя и связи заказа с перепиской в боте. ### В Меркурии нет переписки или уведомлений Проверьте, что бот действительно подключён в Меркурии и в строке статуса отображается ссылка на него. Если подключение отсутствует или ранее менялся токен, вернитесь к инструкции [«Токен бота MAX»](loyalty-bot-max.md) и проверьте подключение. ## Смежные разделы - [Токен MAX](loyalty-bot-max.md) — создание бота, получение токена и подключение к Меркурию. - [WebApp Telegram](loyalty-webapp-telegram.md) — настройка мини-приложения в Telegram. - [Боты](loyalty-bots.md) — общие настройки Telegram и MAX. - [Дисконтная программа](loyalty.md) — обзор раздела и его возможностей.