Домен для WebApp (витрина в боте)
Если у вас включена интернет-витрина, покупатель открывает каталог прямо в Telegram (кнопка меню в чате с ботом или Mini App). Чтобы система узнала покупателя — заказ привязался к чату, приходили уведомления о статусе и работала переписка по заявке — нужно привязать домен витрины к боту в @BotFather и указать правильный URL магазина.
Без домена. Магазин в Telegram может открыться, но покупатель не будет «узнан»: в заявке не будет переписки и уведомления в бот не уйдут.
Как привязать домен
- Откройте @BotFather.
- Отправьте команду
/setdomain(или/mybots→ выберите бота → Bot Settings → Domain). - Выберите того же бота, чей токен подключён на вкладке Дисконтная программа → Telegram-бот в Меркурий-ИИ.
- Введите домен сайта витрины без
https://и без пути:- для облака Меркурий-ИИ:
mercury-ai.ru; - не указывайте
/vitrina,wwwи параметры вроде?store=...— только имя домена.
- для облака Меркурий-ИИ:
- BotFather подтвердит привязку.
- Полностью закройте мини-приложение в Telegram (свайп вниз или крестик) и снова откройте магазин — см. способы ниже.
Когда витрина включена, в клавиатуре бота появляется кнопка Заказать — она открывает магазин сразу. Это основной вход для покупателя: кнопка слева от поля ввода (Menu Button) при открытой клавиатуре сворачивается и её часто не замечают.
Покупателю достаточно нажать /start (или любую кнопку бота) — клавиатура обновится, сверху будет Заказать. Для записи клиентов вместо неё будет Записаться.
Кнопка слева от поля ввода (Menu Button)
Её тоже можно настроить в @BotFather — на случай, если кто-то свернёт клавиатуру бота.
- В Меркурий-ИИ: Розница → Дисконтная программа → Боты (или Интернет-витрина) — скопируйте поле WebApp для Telegram.
- В @BotFather:
/setmenubutton(или/mybots→ ваш бот → Bot Settings → Menu Button) → тип Web App → вставьте скопированный URL.
Альтернатива: @BotFather → /newapp → укажите тот же URL WebApp — приложение откроется по ссылке вида https://t.me/имя_бота/shop.
Mini App с прямой ссылкой (/newapp)
В @BotFather есть раздел управления приложениями. Можно создать Mini App с прямой ссылкой — без клавиатурной кнопки внизу чата.
- @BotFather → команда
/newapp(или Bot Settings → Mini Apps / управление приложениями). - Выберите бота, задайте название и короткое имя (например
shop). - Укажите URL: скопируйте из ERP поле WebApp для Telegram.
- После создания приложение открывается по ссылке вида
https://t.me/имя_бота/shopили из профиля бота.
Домен mercury-ai.ru через /setdomain всё равно обязателен — и для кнопки меню, и для Mini App.
Как проверить
- Откройте магазин кнопкой Заказать на клавиатуре бота (или кнопкой слева от поля ввода, если клавиатуру свернули).
- Оформите тестовый заказ и откройте заявку в ERP — должна быть переписка с покупателем.
Важно. Домен привязывается к боту, а не к аккаунту Telegram владельца магазина. Токен в ERP и бот, из которого открывают магазин, должны быть от одной пары «бот + домен». Если бот пересоздавали или меняли токен — проверьте /setdomain снова для нового бота.