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

На подвкладке **«Боты»** подключаются собственные Telegram- и MAX-боты магазина. Через них покупатели взаимодействуют с дисконтной программой, открывают интернет-витрину или онлайн-запись. Нужен бот **вашей** организации (не общий бот Меркурия) и его токен.

Модуль: [Дисконтная программа](loyalty.md).

Настройка из двух частей:

1. **Подключение бота в Меркурии** — токен, регистрация webhook.
2. **WebApp во внешнем сервисе** — адрес мини-приложения в Telegram или MAX.

## Обзор возможностей

- **Telegram** — токен от @BotFather.
- **MAX** — токен интеграции с платформы MAX.

Каналы независимы: можно начать с одного. После подключения сервер регистрирует webhook. Те же каналы используются для купонов и рассылок. Сам факт подключения бота ещё не настраивает витрину или запись — нужен режим WebApp и адрес во внешнем кабинете.

## Режим WebApp

Блок **«Режим WebApp»** вверху подвкладки:

- **«Интернет-витрина (магазин)»** — меню бота открывает каталог и заказ.
- **«Запись клиентов»** — онлайн-запись; см. [Онлайн-запись](booking-online.md).

Одновременно оба режима нельзя. После смены: сохраните настройки на «Программа», для Telegram нажмите **«Синхронизировать Menu Button»**.

## Подключение Telegram-бота

Подробно: [Токен Telegram-бота](loyalty-bot-telegram.md).

| Элемент | Назначение |
| --- | --- |
| **Токен бота** | HTTP API token; поле типа пароль, после успеха очищается |
| **Статус** | «Не подключён» или ссылка `https://t.me/…` |
| **Подключить Telegram** | Регистрация webhook |
| **Синхронизировать Menu Button** | Обновить кнопку меню под режим WebApp |
| **Отключить** | Снять подключение |
| **WebApp для Telegram (@BotFather)** | URL только для чтения + **Копировать** |

Подсказки команд: `/setdomain`, `/newapp`, `/setmenubutton`. Подробнее: [Домен WebApp Telegram](loyalty-webapp-telegram.md). Кнопка **«Заказать»** при reply-клавиатуре может быть слева от поля ввода.

## Подключение MAX-бота

Подробно: [Токен бота MAX](loyalty-bot-max.md).

| Элемент | Назначение |
| --- | --- |
| **Токен бота** | Access token интеграции MAX |
| **Webhook secret (опционально)** | Можно пусто («авто») |
| **Статус** | «не подключён» или ссылка на бота |
| **Подключить MAX** / **Отключить** | Подключение / снятие |
| **WebApp для MAX** | URL + **Копировать**; домен облака `rus.mercury-erp.ru` |

В кабинете MAX: **Чат-боты → бот → Расширенные настройки → URL мини-приложения**. См. [WebApp MAX](loyalty-webapp-max.md).

## Порядок подключения Telegram

1. Создать бота у @BotFather, получить токен.
2. **Розница → Дисконтная программа → Боты**.
3. Вставить токен → **Подключить Telegram**.
4. Проверить ссылку на бота.
5. При необходимости скопировать WebApp URL и настроить домен/меню в BotFather.
6. **Синхронизировать Menu Button**; проверить `/start`.

## Порядок подключения MAX

1. Создать бота на [business.max.ru](https://business.max.ru/), получить токен.
2. Вставить токен (secret по желанию) → **Подключить MAX**.
3. Скопировать **WebApp для MAX** → указать в расширенных настройках бота.

## Безопасность токенов

Токен = пароль от бота. Не публиковать. После подключения поле очищается — это нормально. Не путать: **токен**, **Webhook secret** (MAX), **URL WebApp**.

## Подробные инструкции

- [Токен Telegram](loyalty-bot-telegram.md) · [WebApp Telegram](loyalty-webapp-telegram.md)
- [Токен MAX](loyalty-bot-max.md) · [WebApp MAX](loyalty-webapp-max.md)
- [Включение программы](loyalty-enable.md)