MultiShop - настройка бота и меню

Конструктор кнопок бота

Раздел «Меню»: дерево кнопок слева, редактор кнопки справа, живое превью чата рядом - вы сразу видите, как меню будет выглядеть у клиента. У каждой кнопки настраивается тип действия (открыть экран, выполнить команду, отправить ссылку), цвет (из палитры стилей Bot API), кастомный эмодзи и вложенные подэкраны. Магазин ставится с готовым меню по умолчанию, его можно оставить как есть, подправить или вернуть заводским кнопкой «Сбросить к стандартному».

Отдельный раздел «Картинки бота» - включает и выключает медиа-обложки экранов, одну общую или свою для каждого экрана.

Настройки бота

Больше 200 параметров, разложенных по 11 разделам: Основные, Подписки и триал, Платежи, Уведомления, Реферальная программа, Безопасность, Бэкапы, ИИ-поддержка, Интерфейс бота, CDN для мини-аппы, VPN-панель. У каждого параметра - человекочитаемое название и пояснение, поиск ищет по обоим. Пароли и ключи касс в этом списке никогда не показываются обратно: видно только «задано» или «не задано».

Значение применяется в течение 15 секунд после сохранения - бот, сайт и фоновые задачи это разные процессы, каждый обновляет настройки из общего хранилища не чаще раза в это время. Если открыли экран сразу после правки и видите старое число, дело не в поломке, подождите немного.

Язык клиента

По умолчанию бот говорит по-русски со всеми. Включается в Настройки → Основное → «Выбор языка клиентом»: у клиента появляется команда /language, а вы можете добавить кнопку «Язык» в меню.

Переведены на английский системные экраны: покупка, оплата, подписка, баланс, устройства, рефералка, поддержка, документы, ошибки. Не переводятся ваши собственные тексты - приветствие, шаблоны уведомлений, названия тарифов, юридические документы, подписи кнопок, которые вы правили в кабинете: это ваши слова, и никакой автоперевод их не подменяет. Если нужна англоязычная витрина целиком, впишите английские варианты в свои шаблоны сами.

Обязательная подписка на канал

Настройки → «Обязательная подписка». Клиент не увидит покупку (и, отдельным флажком, пробный период), пока не вступит в ваш канал. Бот обязан быть администратором канала - иначе он физически не может проверить подписку, и, чтобы не запереть магазин целиком, пропускает всех.

Проверка запоминается на время, а не дёргает Telegram на каждое нажатие: бот слушает вступления и выходы из канала и обновляет ответ сам. Если человек вышел из канала, доступ пропадёт не сразу, а в течение примерно 15 минут (или раньше, если Telegram успел прислать уведомление о выходе). Кнопка «✅ Я подписался», наоборот, всегда спрашивает Telegram заново и пускает без задержки.

Управление магазином из чата

Кабинет открывать не обязательно. Команда /admin в самом боте открывает «Сегодня», «Клиенты», «Промокоды», «Рассылку» и настройки прямо в переписке.

/admin → ⚙️ Настройки - семь тумблеров на самом верху экрана (техработы, триал, рефералка и другие), под ними «🛠 Все настройки бота»: те же параметры, что и в кабинете, с поиском. Выбрали параметр → «Изменить» → прислали новое значение сообщением. Сообщение с ключом кассы бот удаляет сразу после сохранения - сообщения в Telegram хранятся вечно, и если бот стоит в рабочей группе, его прочитают все. Кнопка «Вернуть по умолчанию» стирает ваше значение и возвращает заводское - для ключа кассы это значит, что его придётся вводить заново.

Кто до чего дотянется в чате, зависит от той же роли, что и в веб-кабинете: экран настроек открывается только с правом «настройки», а тумблер техработ дополнительно требует отдельного права на техработы.

Тех-режим

Тумблер «Режим техработ» - бот отвечает всем заглушкой, кроме администраторов. Есть и авто-техрежим: если панель падает, бот сам включает заглушку, а когда панель отвечает снова, снимает её сам, без вашего участия.

На что обратить внимание

Прописать свой Telegram ID в ADMIN_IDS стоит сразу после установки - без этого некому увидеть /admin в чате и получить уведомление об аварии узла или новой версии продукта. В это же поле можно добавить роль через двоеточие (222222222:маркетолог), и человек увидит в чате только то, что положено его роли, подробнее - в статье про команду.