# Магазин в Telegram и MAX

**Раздел:** **Интернет-витрина** (vitrina.md)

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

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

- **Интернет-витрина** — сам магазин: каталог, цены, товары и оформление заказов.
- **Бот мессенджера** — точка входа, через которую покупатель запускает магазин и взаимодействует с ним.

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

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

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

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

Инструкции:

- **Настройка и публикация интернет-витрины** (vitrina-setup.md).
- **Настройка токена бота** (loyalty-bot-telegram.md).

## Где получить ссылки 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.

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

- **Домен для WebApp в Telegram** (loyalty-webapp-telegram.md) — настройка домена.
- **Токен бота Telegram** (loyalty-bot-telegram.md) — где получить токен и куда его внести в Меркурии.

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

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

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

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

Подробная инструкция: **Мини-приложение MAX** (loyalty-webapp-max.md).

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

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

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

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

Подробнее о правилах списания и возврата баллов: **Бонусы в заказе с витрины** (loyalty-vitrina-bonuses.md).

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

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

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

Подробнее:

- **Заявки покупателей с интернет-витрины** (vitrina-orders.md) — связь заказов с сайтом и мессенджерами.
- **Журнал заявок покупателей** (rashody-customer-orders.md) — поиск и обработка заявок в разделе «Расходы».