Главная · Справка · Как настроить магазин в боте
Как настроить магазин в боте
Магазин — это витрина ваших товаров по адресу chbt.io/s/ваш-магазин. В Telegram она открывается прямо в чате как мини-приложение, в MAX — как мини-приложение бота, во ВКонтакте и в чате на сайте — по ссылке. Покупатель кладёт товары в корзину, выбирает способ получения и оплачивает при получении или онлайн на ваш счёт. Заказ приходит вам в Telegram или MAX, на почту и в раздел «Заказы», сделка — в CRM.
Что нужно
- Тариф «Базовый» или выше. На «Бесплатном» раздел виден, но витрина не принимает заказы.
- Товары с ценой магазина: свои (создаются в разделе «Магазин → Товары») или из каталога — загруженного файлом, фидом или из Wildberries. Цена магазина задаётся отдельно от цены на площадке.
- Хотя бы один способ получения: самовывоз с точками, курьер, доставка по стране или свой вариант — с ценой и бесплатной доставкой от суммы.
- Для онлайн-оплаты — реквизиты продавца (ИП или организация, ИНН, адрес, политика обработки данных и условия возврата) и подключённая касса ЮKassa или CloudPayments.
Шаг 1. Товары и доставка
- В кабинете откройте бота → «Магазин» → «Товары» → «Добавить товар». Название, описание, фото (до 5 МБ, мы сжимаем их и убираем данные съёмки), варианты (размер, цвет), цена, старая цена для скидки и остаток.
- Товарам из каталога и с маркетплейсов задайте цену магазина — тогда их можно положить в корзину. Кнопку «Купить на WB/Ozon» рядом можно оставить или убрать.
- «Доставка» — добавьте способы получения. Покупатель видит их при оформлении, цена доставки добавляется к заказу.
Остаток списывается в момент заказа: два покупателя не купят одну последнюю вещь. Отменённый заказ возвращает товар в остаток.
Шаг 2. Настройки магазина
«Магазин» → «Магазин»: название, адрес витрины, валюта (рубли, тенге или сумы), минимальная сумма заказа, цвет кнопок и контакты. Реквизиты продавца видны покупателю внизу витрины — так требует закон о дистанционной продаже.
Включите «Витрина принимает заказы», когда добавлены товары и способ получения.
Шаг 3. Оплата
- При получении — наличными или переводом. Заказ сразу уходит вам в работу.
- Онлайн — картой или через СБП на странице вашей кассы. Подключите ЮKassa (shopId и секретный ключ) или CloudPayments (Public ID и пароль для API) в разделе «Приём оплаты»: ключи мы проверяем у кассы до сохранения. Деньги приходят на ваш счёт, ЧБТ их не касается.
Онлайн-заказ ждёт оплаты 45 минут, товар на это время зарезервирован. Мы сами сверяем каждый платёж с кассой и отмечаем заказ оплаченным — даже если уведомление кассы потерялось. Адрес уведомлений из «Приёма оплаты» ускоряет это, но не обязателен.
Чеки 54-ФЗ пробивает ваша касса (ЮKassa или CloudKassir): включите «Передавать чек в кассу» и укажите систему налогообложения, ставку НДС (в том числе 22% и 5/7% на УСН) и что продаёте. Ставку можно переопределить у отдельного товара; доставка идёт в чеке отдельной позицией.
Онлайн-оплата работает для магазинов в рублях. Магазины в тенге и сумах принимают оплату при получении.
Шаг 4. Где покупатель откроет магазин
- Кнопка в сценарии. В сообщении добавьте кнопку с действием «Открывает магазин»: пусто — весь каталог,
p/123— товар (номер есть в карточке товара),c/Свечи— категория. - Telegram. Витрина открывается внутри чата. В «Магазин → Магазин → Где открыть магазин» можно поставить кнопку меню «Магазин» слева от поля ввода; прежнюю кнопку меню мы сохраним и вернём при выключении.
- MAX. На платформе MAX для партнёров укажите адрес витрины как мини-приложение бота (адрес — в том же разделе) и включите «Открывать витрину как мини-приложение».
- ВКонтакте и чат на сайте. Кнопка придёт ссылкой. Заказ всё равно привяжется к диалогу, и статусы покупатель получит туда же.
- ИИ-продавец показывает у товаров с ценой магазина кнопку «Купить в магазине».
Цифровые товары за звёзды
Курсы, консультации, доступы и файлы Telegram разрешает продавать в ботах и мини-приложениях только за звёзды — Telegram Stars. В магазине это включается у товара.
- «Магазин» → «Товары» → карточка товара → «Цифровой товар»: включите «Продавать в Telegram за звёзды» и укажите «Цену в звёздах» — целое число от 1 до 10 000.
- В мини-приложении Telegram у товара появится кнопка «Купить за N ★». Это заказ на одну позицию, без корзины и доставки; оплата — окном Telegram прямо в мини-приложении. Неоплаченный заказ ждёт 15 минут.
- Оплаченный заказ приходит в «Заказы» как обычный, сделка — в CRM.
Куда приходят звёзды. На баланс вашего бота в Telegram — у каждого продавца свой бот, ЧБТ звёзд не касается. Вывести их можно через Fragment в TON; сроки и условия вывода устанавливает Telegram. Чека 54-ФЗ за звёзды нет.
Возврат — только целиком: «Вернуть всё» в карточке заказа вернёт звёзды на баланс покупателя. Если покупатель оплатил заказ дважды, вторая оплата вернётся автоматически.
Вне Telegram — в MAX, ВКонтакте и на сайте — звёздами не заплатить: там товар продаётся за рубли через кассу, если у него задана цена магазина. Звёздами можно брать оплату и в сценарии: в блоке «Оплата» выберите кассу «Telegram Stars» — счёт придёт прямо в чат Telegram.
Заказы
Новый заказ приходит вам в Telegram или MAX (раздел «Уведомления»), на почту, push-уведомлением и в раздел «Магазин → Заказы». Там — состав, покупатель, способ получения, оплата и история. Меняйте статус: «Собирается», «Отправлен», «Готов к выдаче», «Выполнен» — покупатель получит сообщение в свой чат и на почту. Сделка в CRM двигается вместе со статусом.
Чтобы писать покупателю своими словами, добавьте в сценарий триггер «Событие магазина» — «Заказ оформлен», «Оплачен», «Отправлен» и другие. Тогда вместо стандартного сообщения бот отправит ваш сценарий; в тексте доступны {{order_number}}, {{order_total}}, {{order_status}} и {{order_url}}.
Возвраты
В карточке оплаченного заказа — «Вернуть деньги»: выберите позиции и доставку или «Вернуть всё». Деньги вернутся через вашу кассу, чек возврата касса пробьёт сама. Полный возврат отменяет заказ и возвращает товар в остаток.
Если покупатель оплатил заказ после того, как истекло время на оплату, мы восстановим заказ, когда товар есть. Если товара уже нет — придёт уведомление, а в карточке будут кнопки «Восстановить заказ» и «Вернуть деньги». Если покупатель оплатил один заказ дважды, вторая оплата вернётся автоматически.
Ограничения
- Цифровые товары в Telegram оплачиваются только звёздами (Telegram Stars): за них нет чека 54-ФЗ, а вернуть звёзды можно только целиком — см. «Цифровые товары за звёзды».
- Рубли — на странице вашей кассы; оплаты картой внутри Telegram (Telegram Payments) нет.
- Доставка — ваши способы с вашей ценой. Расчёт стоимости и трекинг СДЭК или Почты России пока не подключены.
- Одна валюта на магазин. Промокодов и отзывов в витрине пока нет.
- Онлайн-оплата и чеки — только в рублях, через ЮKassa или CloudPayments.
Частые вопросы
Сколько стоит магазин?
Магазин входит в тарифы «Базовый» и выше без доплаты за заказы. Комиссию за оплату берёт ваша касса по своему договору.
Куда приходят деньги?
На счёт вашей ЮKassa или CloudPayments. ЧБТ не принимает и не хранит деньги покупателей и данные карт.
Можно ли продавать и на Wildberries, и в своём магазине?
Да. У товара из каталога может быть и цена магазина, и ссылка на маркетплейс: покупатель выбирает, положить товар в корзину или перейти на WB или Ozon.
Нужен ли сайт?
Нет. Витрина открывается по адресу chbt.io/s/ваш-магазин и внутри мессенджеров. Ссылку можно поставить на свой сайт или в соцсети.
Магазин в боте: возможности и ценыКаталог товаровИИ-продавецПодключение TelegramПодключение MAX