# Настройки магазина
### Настройка приветственного сообщения
Сообщение, которое будут видеть ваши пользователи при переходе в бота или при нажатии на команду /start
По умолчанию у вас стоит шаблонное сообщение, которое видят пользователи. Для его изменения перейдите в настройки магазина в панели управления TGShop.
Перейдите в раздел "Автоответ"
Далее добавьте ваш текст сообщения, вы можете добавить любые символы и ссылки, до 4096 символов, а также добавьте фото, до 10 фото.
{% hint style="info" %}
**Важно:** если вы добавляете фото к приветственному сообщению, то допустимое количество символов до 1024 символов.
{% endhint %}
Настройка приветственного сообщения
После ввода текста, вы можете нажать "предпросмотр" - чтобы увидеть как будет выглядеть данный текст у пользователей.
Предпросмотр сообщения
После нажмите "сохранить". Настройку приветственного сообщения после этого можно считать успешно завершенной.
### Настройка автоответа при оформлении заказа
Автоответ — это сообщение, которое покупатель автоматически получает в Telegram / Max сразу после оформления заказа в вашем магазине. Вы можете настроить его содержимое: добавить данные о заказе, покупателе, доставке, составе и сумме, используя динамические теги.
Перейдите в **Настройки магазина** и откройте раздел **Автоответ.**
#### **Редактор сообщения**
Текст автоответа редактируется в визуальном редакторе. Доступны стандартные инструменты форматирования:
* **B** — жирный
* *I* — курсив
* ~~T~~ — зачёркнутый
* U — подчёркнутый
* 🔗 — ссылка
* 😊 — эмодзи
* **{ }** — вставить тег (переменную, условие или цикл)
* Списки маркированный и нумерованный
Для вставки динамических данных используйте кнопку **{ } — Вставить тег**. После нажатия откроется панель со всеми доступными тегами, разделёнными на три группы.
#### **Группы тегов**
#### Переменные
Переменные подставляют конкретное значение в момент отправки сообщения. Доступны в двух форматах:
* **Готовая строка с подписью** — вставляет значение вместе с подписью-меткой, например: `Телефон: 89001234567`
* **Без подписи** — вставляет только само значение, например: `89001234567`
Полный список переменных:
| Переменная | Код |
| ------------------------------------------------ | --------------------- |
| Номер заказа | `orderNumber` |
| Имя покупателя | `receiverFirstName` |
| Фамилия покупателя | `receiverLastName` |
| Отчество покупателя | `receiverPatronymic` |
| ФИО покупателя без подписи | `receiverFullName` |
| Username покупателя в Telegram | `receiverTelegram` |
| Способ оплаты (готовая строка с подписью) | — |
| Статус оплаты (готовая строка с подписью) | — |
| Покупатель (готовая строка с подписью) | — |
| Телефон покупателя (готовая строка с подписью) | — |
| Телефон покупателя без подписи | `receiverPhone` |
| Email покупателя (готовая строка с подписью) | — |
| Email покупателя без подписи | `receiverEmail` |
| Информация о доставке | `deliveryInfo` |
| Имя получателя | `recipientFirstName` |
| Фамилия получателя | `recipientLastName` |
| Отчество получателя | `recipientPatronymic` |
| ФИО получателя (готовая строка с подписью) | — |
| ФИО получателя без подписи | `recipientFullName` |
| Телефон получателя (готовая строка с подписью) | — |
| Телефон получателя без подписи | `recipientPhone` |
| Email получателя (готовая строка с подписью) | — |
| Email получателя без подписи | `recipientEmail` |
| Комментарий к заказу (готовая строка с подписью) | — |
| Комментарий к заказу без подписи | `comment` |
| Промокод (готовая строка с подписью) | — |
| Промокод без подписи | `promocodeRaw` |
| Стоимость доставки (готовая строка с подписью) | — |
| Стоимость доставки без подписи | `deliveryCost` |
| Итоговая сумма | `paymentValue` |
#### Условия
Условия позволяют показывать разные фрагменты текста в зависимости от параметров заказа. Условный блок выглядит как пара открывающего и закрывающего тегов, между которыми вставляется нужный текст.
Условные теги отображаются в редакторе цветными плашками:
* **Зелёный блок** — текст показывается, если условие выполняется
* **Красный блок (с префиксом НЕ)** — текст показывается, если условие НЕ выполняется
**Пример:** тег «Признак оформления без оплаты» позволяет показать разный текст для заказов с оплатой и без:
```
Заказ № {orderNumber} успешно
► [если без оплаты] оформлен ◄
► [если НЕ без оплаты] оплачен ◄
```
Доступные условия:
* **Признак оформления без оплаты** — заказ оформлен без предоплаты
* **Есть ли имя покупателя** (доп. флаг)
* **Есть ли фамилия покупателя** (доп. флаг)
* **Есть ли отчество покупателя** (доп. флаг)
* **Есть ли имя получателя** (доп. флаг)
* **Есть ли фамилия получателя** (доп. флаг)
* **Есть ли отчество получателя** (доп. флаг)
> Флаги «Есть ли...» удобно использовать для отображения ФИО только в том случае, если покупатель указал все составляющие.
***
#### Циклы
Циклы позволяют перечислить все элементы списка — например, все товары или услуги в заказе. Внутри цикла задаётся шаблон одной строки, который будет повторён для каждого элемента.
Доступные циклы:
* **Список товаров** (`items`) — перебирает все товары в заказе. Внутри доступны переменные `Название`, `Цена`, `Количество`
* **Список услуг** (`services`) — перебирает все услуги в заказе. Внутри доступны переменные `Название`, `Цена`
**Пример шаблона состава заказа:**
```
Состав заказа:
► Список товаров
{Название} {Цена} × {Количество} шт
◄ Список товаров
► Список услуг
{Название}: {Цена}
◄ Список услуг
Сумма: {paymentValue}
```
***
#### Сохранение
После редактирования шаблона нажмите **Сохранить**. Изменения вступят в силу немедленно — следующий оформленный заказ получит обновлённое сообщение.
### Настройка полей формы заказа
В данном разделе вы можете убрать или наоборот добавить поля для вашей формы заказы в магазине. Например, если вы не хотите собирать почту или отчетство пользователей - вы можете убрать эти поля, и тогда они не будут отображаться в форме заказа вашего магазина. \
\
Перейдите в раздел настройки магазина в панели управления TGShop
Перейдите в раздел "заказ"
По умолчанию у магазина в форме заказа включены все поля, включенные поля являются обязательными к заполнению кроме полей "промокод" и "комментарий к заказу". \
\
Отключить ненужные поля вы можете нажав на переключатель. \
\
Также, если в вашем магазине получателем и покупателем могут быть разные люди, необходимо включить опцию **Разрешить указать другого получателя** и настроить дополнительные поля. Все включенные поля будут обязательными для заполнения.
{% hint style="info" %}
**Важно:** если вы подключаете интеграцию со службами доставки через способ доставки ApiShip, или подключаете интернет-эквайринг (оплату онлайн через сервисы Юкасса / Ткасса тд.) - то поля email / фамилия / отчество обязательны для успешной работы интеграций. Некоторые службы доставки, например, СДЭК, требуют чтобы у покупателя было указано ФИО и могут отказать в выдаче посылки.
{% endhint %}
### Настройка раздела "о магазине"
Перейдите во вкладку "о магазине"
Заполните необходимые вам поля по умолчанию или добавьте свои
{% hint style="info" %}
Данная информация требуется для быстрого одобрения подключения онлайн-оплаты, например, от Ткассы или Юкассы
{% endhint %}
Для добавления своих полей, нажмите кнопку "добавить ссылку" и заполните появившиеся поля
1. **Текст** - название вкладки в разделе "о магазине", которую будет видеть пользователя при переходе во вкладку меню в вашем мини-приложении. Например, "Политика конфиденциальности" или "Возврат".
2. **Ссылка** - ссылка на страницу куда будет переходить пользователь при нажатии на вкладку с данным названием. Например, если вы хотите сделать страницу со страницей вашей политики конфиденциальности или любой другой контент, мы рекомендуем использовать сервис . Также вы можете зашить любую другую ссылку, на свой сайт, телеграм-канал и пр. \
\
Страницы сделанные при помощи данного сервиса будут открываться у пользователя внутри мини-приложения, и не будут уводить его на внешние источники. Это улучшит пользовательский опыт и повысит конверсию в продажу за счет "бесшовного" опыта при взаимодействии с вашим магазином.
Пример заполненной информации и настроенных вкладок:
После заполнения всей информации, для сохранения изменений нажмите кнопку "сохранить"
Пример настроенной вкладки "о магазине" в вашем мини-приложении
### Настройка группировки товаров в каталоге
Данная настройка разделяет товар на отдельные карточки в каталоге для удобства покупателей.
По умолчанию все товары разделяются по параметру "цвет". Для того, чтобы покупатели видели в каталоге сразу все доступные варианты товара по параметру "цвет". Например, если вы продаете футболки с различными вариантами по цвету (SKU), то вы можете настроить отображение так, чтобы в каталоге листая ваши товары покупатель видел сразу несколько вариантов одного и того же товара без перехода в карточку товара.
При помощи данной настройки вы можете менять логику отображения товаров в листинге, разъединять варианты товара (SKU) на отдельные карточки в каталоге по нужным вам характеристикам товара, или наоборот не разделять товары на отдельные карточки.
Перейдите в раздел настройки -> магазин -> Отображение товаров в листинге
Выберите необходимую опцию настройки
1. **Одна карточка на все варианты -** при включении будет отображать в каталоге только 1 вариант товара. Для выбора данной опции необходимо убрать галочки с других опций.
2. **Выбрать один или несколько вариантов для отображения** - при включении будет отображать в каталоге каждый вариант товара отдельной карточкой. Для выбора опций необходимо предварительно добавить товары и добавить характеристики для данных вариантов товаров (например, цвет или объем), а также объединить данные товары в группу.
Сохраните настройки, настройку можно считать успешно завершенной.
### Настройка кнопки корзины
При помощи данной настройки вы можете добавить кнопку корзины в каталоге.
Для того, чтобы включить отображение кнопки корзины перейдите в настройки -> выберите действие кнопки на карточке товара: \
\
1\. **Не показывать кнопку -** отключает отображение кнопки "корзины" в листинге у товаров. Стоит у всех магазинов как настройка по умолчанию.
2. **Добавлять в корзину** - при нажатии добавляет товар в корзину без перехода в карточку товара. При наличии у карточки нескольких SKU (вариантов) отображает попап для быстрого выбора варианта товара (SKU) и добавляет товар в корзину.
3. **Переход на карточку товара** - при нажатии открывает карточку товара. Добавляется как дополнительная кнопка для увеличения кликов и переходов в карточку товара.
Сохраните настройки, настройку можно считать успешно завершенной.
### Настройка сервисного сбора
Если вы хотите зашить в стоимость заказа отдельно свои расходы, например, упаковку, сбор заказа вы можете настроить сервисный сбор как в процентах от заказа, так и фиксированную сумму. Он будет отображаться у покупателей отдельной строкой в чекауте, и передаваться в чеке отдельной строкой как "услуга".
Для включения данной опции поставьте галочку возле **Сервисный сбор**\
\
1\. Выберите формат сбора: фиксированную сумму или процент от суммы заказа.
2. Укажите размер сервисного сбора
3. Настройте ставку НДС (если нужно)
4. Добавьте текст подсказки, покупатели увидят этот текст как пояснение сервисного сбора в чекауте.
Сохраните настройки, чтобы включить данную опцию и она отобразилась в вашем магазине.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.tgshop.io/osnovnye-nastroiki/nastroiki-magazina.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.