Меркурий-ИИ

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

Домен WebApp Telegram

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

Настройка особенно важна для связи мини-приложения с ботом. Если домен не привязан правильно, витрина может открываться, но Telegram не передаст необходимые данные о покупателе. В результате Меркурий не сможет связать заказ с перепиской в боте и отправлять покупателю уведомления через этот канал.

Почему нельзя пропустить привязку домена?

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

Что подготовить в Меркурии

Перед настройкой Telegram убедитесь, что бот уже подключён к Меркурию. Откройте Розница → Дисконтная программа → Боты.

1. Подключите Telegram-бота

В блоке «Telegram-бот» должен быть указан статус подключения и ссылка на вашего бота. Если бот ещё не подключён, сначала получите токен через @BotFather и подключите его в Меркурии.

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

2. Выберите режим WebApp

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

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

3. Скопируйте URL WebApp

После подключения Telegram в блоке появляется поле «WebApp для Telegram (@BotFather)». В нём находится готовый адрес мини-приложения, сформированный Меркурием.

Поле предназначено для просмотра и копирования, а не для редактирования. Нажмите «Копировать» и сохраните адрес в буфере обмена. Он понадобится на следующем этапе.

4. Синхронизируйте Menu Button

Кнопка «Синхронизировать Menu Button» обновляет кнопку меню Telegram-бота с учётом выбранного режима WebApp.

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

Таким образом, в Меркурии нужно подготовить две вещи: подключённого Telegram-бота и скопированный URL WebApp. Теперь можно переходить к настройкам Telegram.

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

Telegram должен знать, какой домен разрешён для работы мини-приложения вашего бота. Эта привязка выполняется через официального бота @BotFather.

Шаг 1. Откройте @BotFather

Перейдите в Telegram по ссылке t.me/BotFather. Откройте чат с официальным BotFather.

Шаг 2. Запустите настройку домена

Отправьте команду:

/setdomain

Также к этой настройке можно перейти через меню:

/mybots → выберите своего бота → Bot Settings → Domain.

Шаг 3. Выберите нужного бота

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

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

Шаг 4. Введите домен

Для облачной версии Меркурий-ИИ укажите:

mercury-ai.ru

Вводить нужно только доменное имя. Не добавляйте протокол https://, путь к странице или дополнительные параметры.

Правильно:

mercury-ai.ru

Неправильно:

Шаг 5. Подтвердите настройку

Следуйте указаниям BotFather и подтвердите привязку домена. После успешного выполнения домен будет связан с выбранным ботом.

Обратите внимание: привязка домена и указание URL мини-приложения — два разных действия. На этом этапе вы разрешили использование домена. Теперь нужно указать Telegram конкретный адрес WebApp, который вы скопировали из Меркурия.

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

После настройки не ограничивайтесь тем, что мини-приложение просто открылось. Важно проверить, что Telegram передаёт данные покупателя и Меркурий может связать заказ с его ботом.

  1. Полностью закройте ранее открытое мини-приложение в Telegram.
  2. Откройте чат с вашим ботом.
  3. Если необходимо, отправьте команду /start.
  4. Откройте магазин кнопкой «Заказать» или через настроенную кнопку меню.
  5. Оформите тестовый заказ.
  6. Откройте в Меркурии журнал Расходы → Заявки покупателей и найдите созданную заявку.
  7. Проверьте, появилась ли в заявке возможность переписки с покупателем.

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

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

Если покупатель не определяется

Если интернет-витрина открывается, но в заявке нет переписки с покупателем или уведомления в бот не приходят, проверьте настройки последовательно.

  1. Проверьте подключение бота в Меркурии. На вкладке «Боты» должна отображаться ссылка на подключённого Telegram-бота.
  2. Проверьте, что выбрали того же бота в BotFather. Домен должен быть привязан к боту, токен которого указан в Меркурии.
  3. Проверьте домен. Для облачной версии указывается mercury-ai.ru, без протокола, пути и дополнительных частей адреса.
  4. Проверьте URL WebApp. В Telegram должен быть указан адрес, скопированный из Меркурия, а не произвольная ссылка на сайт.
  5. Проверьте Menu Button. Если вы меняли режим WebApp, сохраните настройки программы и выполните синхронизацию кнопки меню.
  6. Перезапустите мини-приложение. Закройте его полностью и откройте заново из чата с ботом.
  7. Создайте тестовую заявку. Проверьте результат в журнале заявок покупателей.

Если после проверки проблема сохраняется, обратите внимание на сообщения об ошибках в Меркурии и на результат выполнения команд в BotFather. Не создавайте новый бот и не меняйте токен без необходимости: сначала убедитесь, что правильно настроены домен и URL уже подключённого бота.