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

Что это даёт

• Покупатель регистрируется в вашем боте Telegram или MAX и получает бонусный баланс.
• На кассе Mercury-POS при оплате читается карта/код клиента — бонусы начисляются и списываются по правилам программы.
• В ERP — настройки, статистика, журнал операций, массовая выдача купонов и рассылки в бот.

Раздел в программе: Розница → Дисконтная программа. Абонентская плата — 0,02 ₽ в сутки за каждого участника (зарегистрированного клиента программы).

Включение программы

1. Откройте базу фирмы и перейдите в Дисконтная программа.
2. Укажите название в боте, приветствие, бонус за регистрацию, процент начисления и максимальный процент списания.
3. Нажмите Сохранить, затем включите программу переключателем.
4. Переэкспортируйте прайс на кассы — ключи дисконта попадут в выгрузку для любого склада базы.

Подключение ботов

Для дисконтной программы нужен ваш собственный бот — не общий бот Меркурий-ИИ. Вы создаёте бота у Telegram или MAX, копируете токен и вставляете его на вкладке Дисконтная программа. Сервер Меркурий-ИИ сам зарегистрирует webhook; покупатели будут общаться с ботом вашего магазина.

Telegram — кратко

1. Получите токен в @BotFather — пошагово в разделе Как получить токен Telegram.
2. На вкладке Telegram-бот вставьте токен и нажмите Подключить Telegram.
3. Если включена интернет-витрина, скопируйте URL WebApp из ERP и настройте магазин в @BotFather — пошагово в разделе Домен для WebApp.
4. После успешного подключения появится ссылка вида https://t.me/ИмяВашегоБота — проверьте, что бот отвечает на команду /start.

MAX — кратко

1. Создайте и промодерируйте бота на платформе MAX для партнёров — подробно в разделе Как получить токен MAX.
2. На вкладке Бот MAX вставьте токен интеграции (поле Webhook secret можно оставить пустым).
3. Нажмите Подключить MAX.
4. Если включена интернет-витрина, скопируйте WebApp для MAX из ERP и вставьте в кабинете MAX как URL мини-приложения — пошагово в разделе Мини-приложение MAX.

Можно подключить оба канала или один. Купоны и рассылки отправляются в выбранный канал или в оба.

Как получить токен Telegram-бота

Официальный способ — сервис @BotFather в Telegram. Нужен аккаунт Telegram (на телефоне или в десктоп-клиенте).

Новый бот

1. Откройте чат с @BotFather и нажмите Start (или отправьте /start).
2. Отправьте команду /newbot (или выберите в меню пункт создания бота).
3. Введите отображаемое имя бота — как его увидит покупатель, например Бонусы «Мой магазин».
4. Введите username бота латиницей; он должен заканчиваться на bot, например myshop_bonus_bot. Если имя занято, BotFather предложит другие варианты.
5. BotFather пришлёт сообщение с HTTP API token — строка вида 7823321789:AAHdgHUyTrfDGWJx456ofSAs0K5PALDsaw. Скопируйте её целиком.
6. В Меркурий-ИИ: Розница → Дисконтная программа → Telegram-бот → вставьте токен → Подключить Telegram.

Бот уже создан

1. Откройте @BotFather.
2. Отправьте /mybots → выберите нужного бота.
3. Нажмите API Token → Revoke current token только если старый токен мог утечь; иначе используйте показ текущего токена без перевыпуска.
4. Скопируйте токен и вставьте в Меркурий-ИИ.

Рекомендуется настроить в BotFather

• /setdescription — краткое описание программы лояльности.
• /setabouttext — текст «О боте».
• /setuserpic — логотип магазина.
• /setcommands — например: start — Регистрация в программе.
• Если используете интернет-витрину в боте — обязательно /setdomain (см. Домен для WebApp).

Домен для WebApp (витрина в боте)

Если у вас включена интернет-витрина, покупатель открывает каталог через WebApp в Telegram (Mini App или Menu Button). Чтобы покупатель был «узнан» ботом, заказ попал в ERP с привязкой к чату, а работали уведомления о статусе и переписка по заявке, Telegram должен передать подписанные данные сессии (initData). Это возможно только после привязки домена сайта витрины к боту и указания правильного URL WebApp в @BotFather.

Как привязать домен

1. Откройте @BotFather.
2. Отправьте команду /setdomain (или /mybots → выберите бота → Bot Settings → Domain).
3. Выберите того же бота, чей токен подключён на вкладке Дисконтная программа → Telegram-бот в Меркурий-ИИ.
4. Введите домен сайта витрины без https:// и без пути:
   • для облака Меркурий-ИИ: mercury-ai.ru;
   • не указывайте /vitrina, www и параметры вроде ?store=... — только имя домена.
5. BotFather подтвердит привязку.
6. Полностью закройте мини-приложение в Telegram (свайп вниз или крестик) и снова откройте магазин — см. способы ниже.

Кнопка «Магазин» в чате (Menu Button)

После привязки домена настройте вход в магазин через @BotFather — кнопку слева от поля ввода в чате с ботом (Menu Button) или Mini App.

1. В Меркурий-ИИ: Розница → Дисконтная программа → Боты (или Интернет-витрина) — скопируйте поле WebApp для Telegram.
2. В @BotFather: /setmenubutton (или /mybots → ваш бот → Bot Settings → Menu Button) → тип Web App → вставьте скопированный URL.
3. Откройте чат с ботом и нажмите Menu Button слева от поля ввода.

Альтернатива: @BotFather → /newapp → укажите тот же URL WebApp — приложение откроется по ссылке вида https://t.me/имя_бота/shop.

Mini App с прямой ссылкой (/newapp)

В @BotFather есть раздел управления приложениями. Можно создать Mini App с прямой ссылкой — без клавиатурной кнопки внизу чата.

1. @BotFather → команда /newapp (или Bot Settings → Mini Apps / управление приложениями).
2. Выберите бота, задайте название и короткое имя (например shop).
3. Укажите URL: полная ссылка на витрину с webapp=1 (скопируйте из ERP или из диагностики WebApp — строка webapp_shop_url).
4. После создания приложение открывается по ссылке вида https://t.me/имя_бота/shop или из профиля бота.

Домен mercury-ai.ru через /setdomain всё равно обязателен — и для Menu Button, и для Mini App.

Как проверить

1. Откройте магазин через Menu Button (слева от поля ввода) или через Mini App из @BotFather.
2. В блоке «Клиент (Telegram)» должно быть resolved initData length: > 0 и в POST-тесте — resolveMessenger: {"chat_id":...}.
3. Оформите новый тестовый заказ из WebApp и откройте заявку в ERP — на вкладке Интернет-заказ должна появиться переписка с покупателем.

Как получить токен бота MAX

Бот создаётся в кабинете MAX для бизнеса (платформа для партнёров). Нужен верифицированный профиль организации, ИП или самозанятого. Актуальные требования и скриншоты интерфейса — в справке MAX для разработчиков.

Регистрация и создание бота

1. Зайдите на business.max.ru под аккаунтом с верифицированным профилем компании.
2. Откройте раздел Чат-боты → Создать.
3. Заполните карточку бота: название, описание, аватар (как увидят покупатели в MAX).
4. Сохраните и дождитесь модерации. Статус приходит в служебные уведомления MAX; проверка может занять до нескольких рабочих дней.

Получение токена после модерации

1. Снова откройте Чат-боты и выберите вашего бота.
2. Перейдите в раздел Интеграция или Расширенные настройки → Настроить (название пункта зависит от версии кабинета).
3. Нажмите Получить токен (или скопируйте значение из поля Токен).
4. Это длинная строка — токен интеграции бота. Его вставляют в Меркурий-ИИ в поле Токен бота на вкладке Бот MAX.
5. Нажмите Подключить MAX. Поле Webhook secret можно не заполнять — секрет сгенерируется автоматически при регистрации webhook на сервере Меркурий-ИИ.

Если токен не отображается

• Бот ещё не прошёл модерацию — дождитесь статуса «одобрен» / «активен».
• Профиль организации не верифицирован — завершите проверку в кабинете MAX.
• Токен перевыпускали — используйте только последний; старый перестаёт работать.

Мини-приложение MAX (витрина в боте)

Если включены дисконт и интернет-витрина, покупатель открывает каталог прямо в MAX — так же, как WebApp в Telegram. Заказы пишутся с MAX_ID, работают списание бонусов, уведомления о статусе и переписка на вкладке «Клиенты».

Куда вставить URL в кабинете MAX

1. В Меркурий-ИИ: Розница → Дисконтная программа → Бот MAX — скопируйте поле WebApp для MAX (ссылка вида …/index.php?store=…&webapp=1&channel=max).
2. Откройте платформу MAX для партнёров → Чат-боты → Перейти.
3. Выберите того же бота, чей токен подключён в Меркурий-ИИ.
4. Перейдите в Расширенные настройки → Настроить.
5. Вставьте скопированный URL в поле ссылки мини-приложения.
6. Выберите вид кнопки открытия (Открыть / Старт и т.п.) и нажмите Сохранить.

После сохранения в чате с ботом появляется кнопка запуска магазина. В ответах бота (карта, баланс, заказы) дополнительно есть кнопка «Открыть магазин».

Проверка

1. Откройте магазин из чата с ботом MAX (кнопка в шапке чата или «Открыть магазин»).
2. Оформите тестовый заказ — в ERP в заявке должен быть клиент MAX и доступна переписка.
3. В боте нажмите «Мои заказы» — должен появиться тестовый заказ.

Касса и прайс

Касса Mercury-POS обращается к API Меркурий-ИИ по тем же методам, что и внешний СкидкаБот: баланс, начисление, списание, корректировка. Магазин определяется полями fk_vendor и vendor_secret в запросе; в прайсе они задаются как skidkabot_vendorid и skidkabot_vendorsecret.

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

Веб-касса без Mercury-POS

Если у вас нет кассы Mercury-POS, но нужно начислять и списывать бонусы в магазине, используйте веб-кассу — мобильный интерфейс по образцу Скидкабот-Онлайн. Вход — по выносной ссылке, как у ТСД: продавец переходит по ссылке и сразу попадает в кассу без ввода пароля и секретов.

1. В ERP откройте Дисконтная программа → Веб-касса (или общий раздел Выносные ссылки) и нажмите Создать ссылку. Укажите номер кассы/точки (например 1) и сохраните ссылку — она показывается один раз.
2. Откройте ссылку на телефоне продавца. Можно добавить ярлык на главный экран.
3. Нажмите Сканировать QR покупателя — покупатель открывает карту в боте (кнопка «Показать карту»).
4. Укажите сумму покупки, при необходимости скорректируйте списание и нажмите Начислить или Списать баллы.

Можно ввести код клиента и секретный код QR вручную — они отображаются в боте рядом с QR-кодом. Ссылки можно отозвать в списке на вкладке «Веб-касса» или в общих выносных ссылках.

Пригласительные QR

На вкладке Пригласительные QR распечатайте лист с QR-кодом ссылки на бота (Telegram или MAX). Покупатель сканирует код и регистрируется в программе.

Клиенты и переписка

На вкладке Клиенты — список участников программы и переписка с каждым: история сообщений, ответ в бот, бейдж непрочитанных на строке клиента и на вкладке.

• Покупатель может написать в бот любой текст (не команду меню) — это обратная связь; сообщение попадёт в ERP.
• Если включена интернет-витрина, в боте также доступны заказы и WebApp; переписка по заявке — часть того же диалога.
• В карточке Заявки покупателей показывается тот же тред с клиентом (не только сообщения по одной заявке).
• Новые входящие подсвечивают вкладку «Клиенты» и кнопку ИИ-ассистента.

Входящие — сверху на вкладке «Клиенты»: список диалогов с непрочитанными и счётчик +N. Тот же счётчик светится на вкладке «Клиенты». Сообщение помечается прочитанным, когда вы открываете переписку.

Это не массовая рассылка. Для оповещения всех клиентов сразу используйте вкладку «Рассылка» (см. ниже) — там нет диалога и ответов в ERP.

Купоны и рассылка

На вкладке дисконта это два отдельных раздела: Купоны и Рассылка. Они не заменяют личную переписку на вкладке «Клиенты».

Купоны

• Укажите сумму, дату окончания и канал уведомления.
• Выдать купоны всем клиентам — не чаще одного раза в сутки; каждому зарегистрированному клиенту создаётся купон и отправляется сообщение в бот.

Рассылка

Введите текст сообщения, при необходимости приложите изображение (JPG, PNG, WebP), выберите канал и нажмите Отправить рассылку. Произвольную рассылку можно запускать не чаще одного раза в сутки (отдельно от выдачи купонов). Отправка идёт в фоне — на вкладке «Рассылка» отображается прогресс.

Статистика и журнал

На вкладке отображаются число клиентов, сумма балансов, активные купоны и последние транзакции с кассы (дата, клиент, сумма операции, номер кассы).