Меркурий-ИИ

Дисконтная программа

WebApp MAX

WebApp — это мини-приложение, которое покупатель открывает прямо внутри MAX, не переходя в обычный браузер. В зависимости от выбранного режима это может быть интернет-магазин с каталогом и оформлением заказов или интерфейс для записи клиентов. Чтобы MAX открывал именно ваше приложение и передавал Меркурию данные покупателя, нужно скопировать специальный URL из ERP и указать его в настройках чат-бота MAX.

В этой инструкции разберём, где найти адрес WebApp в Меркурии, куда его вставить в кабинете MAX и как проверить, что всё работает правильно.

Важно: используйте специальный URL из Меркурия.

Не подставляйте вместо него обычную публичную ссылку на интернет-витрину с сайта. Адрес WebApp для MAX нужен не только для открытия магазина, но и для правильного распознавания покупателя. Если указать обычную ссылку, заказ может поступить без привязки к покупателю MAX: в ERP не будет переписки, а уведомления через бота не смогут работать как положено.

Где взять URL в Меркурий-ИИ

Адрес мини-приложения появляется в Меркурии после подключения чат-бота MAX.

Шаг 1. Откройте настройки ботов

Перейдите в раздел Розница → Дисконтная программа → Боты. Найдите блок «Бот MAX».

Если MAX ещё не подключён, сначала получите токен в кабинете MAX и выполните подключение в Меркурии. Пока бот не подключён, нужный URL не будет доступен.

Инструкция: «Токен бота MAX».

Шаг 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 должно находиться значение из поля «WebApp для MAX», а не обычный адрес сайта или витрины. Это принципиально: при неправильной ссылке мини-приложение может открываться, но Меркурий не сможет корректно связать действия покупателя с его аккаунтом MAX.

Проверка работы

После сохранения настроек проверьте не только открытие приложения, но и то, что MAX передаёт данные покупателя в Меркурий.

Шаг 1. Откройте мини-приложение

Зайдите в MAX под обычным пользовательским аккаунтом и откройте чат с вашим ботом. Нажмите кнопку запуска мини-приложения.

Убедитесь, что открылся нужный интерфейс: магазин или запись — в зависимости от выбранного режима.

Шаг 2. Выполните тестовое действие

Если настроен режим магазина, оформите тестовый заказ. Если используется режим записи, выполните тестовую запись.

Шаг 3. Проверьте результат в Меркурии

Откройте соответствующий раздел ERP и найдите созданную заявку. Проверьте, что клиент MAX распознан и в заявке доступна переписка с покупателем.

Для магазина дополнительно откройте в боте раздел «Мои заказы» и убедитесь, что тестовый заказ отображается в списке.

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

Если мини-приложение работает неправильно

Если приложение не открывается, открывается не тот экран или заказ поступает без привязки к покупателю, проверьте настройки по порядку.

Мини-приложение не открывается

Открывается не тот режим

Проверьте переключатель режима WebApp в Меркурии. Если нужен магазин, выберите «Интернет-витрина (магазин)»; если нужна онлайн-запись — «Запись клиентов». Сохраните настройки и проверьте, что MAX использует актуальный URL из ERP.

Заказ появляется, но покупатель не определяется

В первую очередь проверьте, что в кабинете MAX указан специальный URL из поля «WebApp для MAX», а не публичная ссылка на сайт или интернет-витрину. Именно использование правильного адреса необходимо для распознавания покупателя и связи заказа с перепиской в боте.

В Меркурии нет переписки или уведомлений

Проверьте, что бот действительно подключён в Меркурии и в строке статуса отображается ссылка на него. Если подключение отсутствует или ранее менялся токен, вернитесь к инструкции «Токен бота MAX» и проверьте подключение.