# Токен Telegram-бота

Чтобы подключить Telegram-бота к Меркурий-ИИ, нужен **HTTP API token** от [@BotFather](https://t.me/BotFather). Токен — секрет для интеграции, не ссылка для покупателей.

Модуль: [Дисконтная программа](loyalty.md) · хаб ботов: [Подключение ботов](loyalty-bots.md).

## Где указать токен в Меркурии

**Розница → Дисконтная программа → Боты → Telegram-бот.**

| Элемент | Назначение |
| --- | --- |
| **Токен бота** | Вставить целиком (формат вроде `123456789:ABC…XYZ`); без пробелов |
| **Статус** | «Не подключён» или ссылка на бота |
| **Подключить Telegram** | Проверка токена и регистрация webhook |
| **Синхронизировать Menu Button** | Обновить меню под режим WebApp |
| **Отключить** | Снять связь с Меркурием |
| **WebApp для Telegram (@BotFather)** | URL мини-приложения + **Копировать** |

После успеха поле токена очищается. Токен и URL WebApp — разные значения. WebApp: [Домен WebApp Telegram](loyalty-webapp-telegram.md).

Режим WebApp выше на вкладке: **Интернет-витрина** или **Запись клиентов**. При ошибке смотрите строку ошибки в блоке.

**Один токен — один бот.** Подключение регистрирует webhook Меркурия; не используйте тот же токен параллельно в другой интеграции, если обе должны получать сообщения.

## Создание нового бота в @BotFather

1. Откройте [t.me/BotFather](https://t.me/BotFather) → Start / `/start`.
2. `/newbot` — укажите display name и username (должен оканчиваться на `bot`).
3. BotFather выдаст HTTP API token — сохраните и вставьте в Меркурий.

## Токен существующего бота

`/mybots` → выбрать бота → **API Token** (или перевыпуск токена). Старый токен после отзыва перестанет работать — обновите подключение в Меркурии.

## Дополнительно в BotFather

По необходимости: описание, аватар, команды. Для витрины/записи отдельно настраиваются `/setdomain` и Menu Button / Mini App — см. [Домен WebApp Telegram](loyalty-webapp-telegram.md).

## Смежные разделы

- [Подключение ботов](loyalty-bots.md)
- [WebApp Telegram](loyalty-webapp-telegram.md)
- [WebApp MAX](loyalty-webapp-max.md)