Меркурий-ИИ

Интернет-витрина

Магазин в Telegram и MAX

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

Для такой работы используются WebApp — встроенные веб-приложения мессенджеров. Это не отдельный магазин и не второй каталог: Telegram и MAX открывают интернет-витрину, которая уже настроена в Меркурии.

Что нужно для подключения

Для работы магазина внутри мессенджера используются две связанные части:

В Меркурии для этого предусмотрены настройки дисконтной программы и интернет-витрины. Токены ботов задаются на вкладке дисконта, а адреса WebApp можно скопировать на вкладке «Ссылки» интернет-витрины или в настройках дисконта.

Когда связка считается активной

Если одновременно включена дисконтная программа и опубликована интернет-витрина, на вкладках дисконта или витрины отображается бейдж «Связка активна».

Это индикатор того, что необходимые части связки включены. Если он не отображается, проверьте состояние дисконтной программы и публикацию витрины.

Перед подключением мессенджера сначала настройте и опубликуйте сам магазин. Если витрина ещё не включена, адреса WebApp могут быть недоступны.

Инструкции:

Где получить ссылки WebApp в ERP

Меркурий формирует адреса мини-приложений для каждого мессенджера. Их не нужно придумывать или собирать вручную — достаточно скопировать готовую ссылку из программы.

Откройте «Розница → Интернет-витрина → Ссылки». На этой вкладке находятся адреса для разных способов открытия магазина.

WebApp для Telegram (@BotFather)

Это адрес интернет-витрины, который используется при настройке мини-приложения Telegram. Рядом с полем находится кнопка «Копировать». Само поле доступно только для чтения: редактировать адрес вручную не требуется.

WebApp для MAX

Здесь находится отдельный адрес для мини-приложения MAX. Его также можно скопировать кнопкой рядом с полем.

Ссылки появляются после включения интернет-витрины на вкладке «Настройки». Если нужного адреса нет, сначала проверьте, включена ли витрина и сохранены ли её настройки.

Те же адреса доступны в настройках дисконта. Это удобно, если вы настраиваете ботов из раздела дисконтной программы.

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

Подключение Telegram

Для Telegram адрес WebApp копируется из Меркурия, а настройка самого мини-приложения выполняется через @BotFather — официальный бот Telegram для управления ботами.

Общий порядок подключения:

  1. Скопируйте адрес WebApp для Telegram.

    В Меркурии откройте вкладку «Ссылки» интернет-витрины и нажмите «Копировать» рядом с полем «WebApp для Telegram (@BotFather)».

  2. Настройте домен.

    В @BotFather используется команда /setdomain. В качестве домена укажите домен сайта витрины. Вводить нужно только доменное имя — без https:// и без пути к странице.

  3. Настройте мини-приложение.

    Для этого в @BotFather используется команда /newapp или настройка /setmenubutton. В соответствующее поле вставьте скопированный из Меркурия URL WebApp.

После настройки покупатель сможет открывать магазин через бота Telegram.

Отдельно изучите инструкции:

Подключение MAX

Для MAX используется отдельный URL мини-приложения. Его нужно скопировать в Меркурии из поля «WebApp для MAX».

Настройка выполняется в кабинете MAX:

  1. Откройте раздел «Чат-боты».
  2. Перейдите в «Расширенные настройки».
  3. Нажмите «Настроить».
  4. Найдите поле «URL мини-приложения».
  5. Вставьте туда адрес WebApp для MAX, скопированный из Меркурия.

Для MAX используется адрес с хостом rus.mercury-erp.ru. При настройке берите готовую ссылку из ERP, а не составляйте её самостоятельно.

Подробная инструкция: Мини-приложение MAX.

Бонусы при оформлении заказа

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

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

Если заказ отменён, удалён или оплата возвращена, списанные баллы возвращаются покупателю.

Таким образом, бонусная программа связана не только с каталогом магазина, но и с дальнейшей обработкой заказа и его оплатой.

Подробнее о правилах списания и возврата баллов: Бонусы в заказе с витрины.

Где искать заказы из мессенджеров

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

Перейдите в «Расходы → Заявки покупателей». Там можно открыть поступившую заявку, проверить состав заказа и продолжить работу с ней.

Если заказ оформлен через WebApp в Telegram или MAX и связан с чатом, в карточке заявки также доступна привязка к переписке. Покупатель может написать боту обычное текстовое сообщение, а сотрудник сможет продолжить диалог в Меркурии при наличии необходимой привязки.

Подробнее: