Подключение ботов
На подвкладке «Боты» подключаются собственные Telegram- и MAX-боты магазина. Через них покупатели могут взаимодействовать с вашей дисконтной программой, открывать интернет-витрину или пользоваться онлайн-записью. Для подключения понадобится создать бота от имени вашей организации или магазина и указать его токен в Меркурии.
Используется именно ваш собственный бот, а не общий бот Меркурий-ИИ. Покупатель будет видеть название, оформление и ссылку на бота вашего магазина. Вы можете подключить Telegram, MAX или оба канала одновременно.
Настройка состоит из двух частей:
- Подключение бота в Меркурии. Вы указываете токен, после чего программа регистрирует обработчик сообщений на сервере.
- Настройка WebApp во внешнем сервисе. Если покупатели должны открывать интернет-витрину или онлайн-запись прямо внутри мессенджера, нужно дополнительно указать адрес мини-приложения в настройках Telegram или MAX.
Обзор возможностей
В разделе можно подключить один или два канала связи с покупателями:
- Telegram. Подключение бота через токен, полученный у @BotFather.
- MAX. Подключение бота через токен интеграции, полученный на платформе MAX.
Каждый канал настраивается отдельно. Например, можно начать с Telegram, а MAX подключить позднее. Наличие одного подключённого бота не мешает подключить второй.
После подключения сервер Меркурия регистрирует webhook — адрес, на который мессенджер передаёт события и сообщения от пользователей. Благодаря этому покупатели могут писать боту магазина, а Меркурий получает эти сообщения для дальнейшей обработки.
Подключённые каналы также используются для отправки купонов и массовых рассылок. Если подключены оба бота, сообщения могут направляться в выбранный канал или в оба.
Важно понимать: подключение бота само по себе ещё не означает, что интернет-витрина или онлайн-запись уже настроены. Для открытия мини-приложения потребуется выбрать режим WebApp и выполнить настройку адреса во внешнем кабинете мессенджера.
Режим WebApp
В верхней части подвкладки находится блок «Режим WebApp». Он определяет, какое мини-приложение будет открываться покупателю из меню бота.
Предусмотрено два варианта:
«Интернет-витрина (магазин)»
В этом режиме кнопка или меню бота открывает интернет-витрину магазина. Покупатель может перейти к каталогу и оформлению заказа через мини-приложение.
Выбирайте этот режим, если бот предназначен для обслуживания покупателей интернет-магазина.
«Запись клиентов»
В этом режиме бот используется для онлайн-записи клиентов на услуги мастеров.
Выбирайте его, если ваша организация принимает записи на определённое время, а не продаёт товары через интернет-витрину.
Подробнее об этом сценарии: «Онлайн-запись».
Можно ли одновременно использовать оба режима?
Нет. Для одной организации выбирается один режим: либо интернет-магазин, либо онлайн-запись. Если вы переключаете режим, учитывайте, что изменится назначение кнопки мини-приложения в боте.
Что сделать после смены режима
- Выберите нужный вариант WebApp.
- Перейдите на подвкладку «Программа» и сохраните настройки программы.
- Если используете Telegram, нажмите «Синхронизировать Menu Button», чтобы обновить кнопку меню бота под новый режим.
Смена режима в Меркурии и обновление кнопки меню Telegram — связанные, но отдельные действия. Не забудьте выполнить синхронизацию, иначе меню бота может продолжить показывать прежний вариант.
Подключение Telegram-бота
Блок Telegram предназначен для подключения вашего бота к Меркурию. Для этого понадобится токен, который выдаёт официальный бот Telegram @BotFather.
Если бот ещё не создан, сначала создайте его и получите токен. Подробная инструкция: «Токен Telegram-бота».
Поле «Токен бота»
Сюда вставляется токен Telegram-бота. Это секретный ключ, который подтверждает право Меркурия управлять подключением бота.
Поле имеет тип ввода пароля: введённое значение скрыто. После успешного подключения поле очищается, поэтому не нужно ожидать, что токен останется видимым в форме.
Статус подключения
В этом месте отображается состояние Telegram-бота.
- «Не подключён» — бот ещё не подключён к Меркурию.
- Ссылка на бота — подключение выполнено. По ссылке вида
https://t.me/…можно перейти к вашему боту в Telegram.
Ссылка позволяет быстро проверить, какой именно бот подключён. Это особенно полезно, если у магазина несколько ботов или вы недавно создавали нового.
Кнопка «Подключить Telegram»
Запускает подключение бота. Меркурий использует указанный токен и регистрирует webhook на своём сервере. После успешного выполнения операции в форме отображается статус подключения и ссылка на бота.
Если подключение не удалось, проверьте правильность токена и прочитайте сообщение об ошибке.
Кнопка «Синхронизировать Menu Button»
Обновляет кнопку меню Telegram-бота в соответствии с выбранным режимом WebApp.
Эта кнопка особенно важна, если вы переключили режим с интернет-витрины на онлайн-запись или обратно. Синхронизация приводит меню Telegram в соответствие с текущими настройками Меркурия.
Кнопка «Отключить»
Снимает подключение Telegram-бота к Меркурию. Кнопка отображается, когда бот уже подключён.
Используйте её, если хотите прекратить работу с этим ботом или заменить его другим. После отключения не следует считать, что бот продолжает работать с Меркурием как прежде.
Адрес WebApp для Telegram
После подключения бота отображается блок с адресом мини-приложения:
«WebApp для Telegram (@BotFather)» — поле только для чтения, рядом находится кнопка «Копировать».
Скопированный адрес понадобится для настройки мини-приложения в @BotFather. В зависимости от выбранного режима WebApp покупатель будет открывать интернет-витрину или онлайн-запись.
Подсказка по настройке домена и WebApp
В интерфейсе приведены команды, которые используются при настройке Telegram:
/setdomain— указание домена для WebApp./newapp— создание мини-приложения./setmenubutton— настройка кнопки меню бота.
Сначала укажите домен, затем настройте мини-приложение или кнопку меню с использованием адреса, скопированного из Меркурия.
Подробная инструкция: «Домен WebApp Telegram».
Кнопка «Заказать»
Если выбран режим интернет-витрины и соответствующие настройки выполнены, у покупателя может отображаться кнопка «Заказать».
В Telegram расположение этой кнопки зависит от типа клавиатуры. При использовании клавиатуры ответов (reply-клавиатуры) она находится слева от поля ввода сообщения. Поэтому её легко не заметить, если вы ищете кнопку в верхней части чата.
Сообщение об ошибке
Если при подключении или отключении возникла проблема, в блоке ошибки отображается сообщение. Прочитайте его: оно помогает понять, что именно не удалось выполнить.
Подключение MAX-бота
Блок MAX предназначен для подключения бота, созданного на платформе MAX. Для подключения используется токен интеграции.
Если бота ещё нет, сначала создайте его на платформе MAX и получите токен. Порядок действий описан в статье «Токен MAX-бота».
Поле «Токен бота»
Вставьте сюда access token интеграции MAX. Это ключ, который используется для подключения бота к Меркурию.
Относитесь к токену как к паролю: его нельзя публиковать или передавать посторонним.
Поле «Webhook secret (опционально)»
Дополнительное поле для секрета webhook. Оно необязательное: если отдельное значение не требуется, его можно оставить пустым. В качестве подсказки в поле отображается слово «авто».
Статус и ссылка на бота
В этом блоке отображается состояние подключения MAX. После успешного подключения появляется ссылка на бота, по которой можно перейти к нему и проверить, что подключён именно нужный бот.
Кнопка «Подключить MAX»
Запускает подключение MAX-бота к Меркурию с использованием указанного токена и дополнительных параметров.
После успешного подключения в блоке отображается статус и ссылка на бота.
Кнопка «Отключить»
Снимает подключение MAX-бота. Используйте её, если нужно прекратить работу с текущим ботом или изменить подключение.
Адрес WebApp для MAX
После подключения отображается поле «WebApp для MAX». В нём находится адрес мини-приложения, который нужно использовать в кабинете MAX. Поле доступно только для чтения, рядом находится кнопка «Копировать».
Для настройки мини-приложения используется домен rus.mercury-erp.ru. Скопированный URL нужно указать в кабинете MAX в настройках соответствующего бота.
Путь к настройке:
Чат-боты → нужный бот → Расширенные настройки → URL мини-приложения.
Подробная инструкция: «WebApp MAX».
Сообщение об ошибке
Если MAX-бот не подключился или операция завершилась ошибкой, сообщение отображается в специальном блоке. Проверьте токен и указанные параметры, а затем повторите подключение.
Порядок подключения Telegram
Если вы подключаете Telegram впервые, удобнее выполнять действия в следующем порядке.
- Создайте собственного бота. Откройте @BotFather, создайте бота и получите токен. Подробности — инструкция по получению токена.
- Откройте Меркурий. Перейдите в «Розница → Дисконтная программа → Боты».
- Вставьте токен. Укажите полученный токен в поле «Токен бота» в блоке Telegram.
- Подключите бота. Нажмите «Подключить Telegram» и дождитесь результата.
- Проверьте статус. Убедитесь, что вместо сообщения «не подключён» появилась ссылка на вашего бота.
- Настройте WebApp, если он нужен. Скопируйте адрес из поля «WebApp для Telegram (@BotFather)» и выполните настройку домена и мини-приложения в @BotFather. Подробнее — настройка домена WebApp.
- Синхронизируйте Menu Button. Если требуется обновить кнопку меню под выбранный режим, нажмите «Синхронизировать Menu Button».
- Проверьте бота. Откройте ссылку на бота и отправьте команду
/start.
Если вам нужна только возможность взаимодействия с ботом, не путайте её с настройкой WebApp. Подключение токена и настройка мини-приложения — разные этапы.
Порядок подключения MAX
Для MAX последовательность похожа, но токен и настройки мини-приложения выполняются через платформу MAX.
- Создайте бота на платформе MAX. Откройте business.max.ru и выполните необходимые действия для создания бота и получения токена интеграции.
- Откройте Меркурий. Перейдите в «Розница → Дисконтная программа → Боты».
- Укажите токен. Вставьте токен интеграции в поле «Токен бота» блока MAX.
- Заполните Webhook secret при необходимости. Если отдельный секрет не требуется, оставьте поле пустым.
- Подключите бота. Нажмите «Подключить MAX» и дождитесь результата.
- Проверьте подключение. Убедитесь, что появился статус и ссылка на бота.
- Настройте WebApp, если он нужен. Скопируйте адрес из поля «WebApp для MAX».
- Укажите URL во внешнем кабинете. Откройте настройки бота на платформе MAX и перейдите в «Расширенные настройки». Вставьте адрес в поле «URL мини-приложения».
Подробные инструкции:
Безопасность токенов
Токен — это пароль от бота. Не публикуйте его в открытом доступе, не размещайте на сайте и не отправляйте посторонним. Тот, кто получил токен, может получить возможность управлять подключением бота.
После успешного подключения Меркурий очищает поле ввода токена. В интерфейсе остаются статус подключения и ссылка на бота. Это нормальное поведение: токен не должен постоянно отображаться в форме.
Если вы случайно раскрыли токен, не продолжайте использовать его как секретный ключ. Получите новый токен средствами соответствующей платформы и обновите подключение в Меркурии.
Также не путайте три разных значения:
- Токен бота — секретный ключ для подключения Telegram или MAX к Меркурию.
- Webhook secret — дополнительный секрет для MAX, который можно не указывать.
- URL WebApp — адрес мини-приложения, который копируется из Меркурия и указывается во внешних настройках мессенджера.
Подробные инструкции
Если вам нужно разобраться с отдельным этапом подключения, воспользуйтесь соответствующей статьёй.
- Токен Telegram-бота — создание бота и получение токена через @BotFather.
- Домен WebApp Telegram — настройка домена и мини-приложения в Telegram.
- Токен MAX-бота — создание бота и получение токена интеграции.
- WebApp MAX — настройка адреса мини-приложения в кабинете MAX.
- Включение программы — основные параметры дисконтной программы.
- Дисконтная программа — обзор всех возможностей раздела.