Инструкция по настройке "Отзывы с маркетплейсов"
1. Общие настройки
Где находится: «Shop-Script → Настройки → Плагины → Отзывы с маркетплейсов», верхняя часть страницы.
| Настройка | Описание |
|---|---|
| Включить пагинацию | Заменяет стандартный вывод отзывов на странице товара на постраничную навигацию. Рекомендуется включать при большом количестве отзывов — ускоряет загрузку страницы. |
| Количество отзывов на странице | Сколько отзывов показывать на одной странице при включенной пагинации (по умолчанию: 20). Оптимально: 20–50. |
| Пересчитать кол-во отзывов и рейтинги | Кнопка ручного пересчёта — обновляет счётчики отзывов и средний рейтинг для всех товаров на основе импортированных данных. Нажимайте после массового импорта или удаления отзывов. |
Рекомендация: включите пагинацию и установите 20–50 отзывов на странице. После первого массового импорта обязательно нажмите «Пересчитать» для актуализации рейтингов.
2. Настройка импорта из OZON
Где находится: блок «OZON» на странице настроек.
Получение API-ключей OZON
- Зайдите в личный кабинет продавца OZON: https://seller.ozon.ru/
- Важно: убедитесь, что у вас подключена подписка «Управление отзывами» или «Premium Pro» — без неё API отзывов недоступен.
- Перейдите в «Настройки → API-ключи»: https://seller.ozon.ru/app/settings/api-keys
- Создайте новый ключ или используйте существующий. Необходимые права ключа:
- Отзывы (Reviews) — чтение (эндпоинты
/v1/review/*) - Товары (Products) — чтение (эндпоинт
/v3/product/info/list— для сопоставления артикулов)
- Отзывы (Reviews) — чтение (эндпоинты
- Скопируйте Client-ID и API-Key
Параметры:
| Настройка | Описание |
|---|---|
| Client-ID | Идентификатор клиента OZON API |
| API-Key | Ключ API для доступа к отзывам |
| ID для сопоставления товаров | Как сопоставлять отзывы с товарами в Shop-Script (см. раздел 5) |
| Минимальная оценка | Импортировать отзывы с оценкой не ниже указанной (0 — все, 5 — только пятёрки) |
| Включать отзывы с пустым текстом | Если выключено — отзывы без текста пропускаются |
3. Настройка импорта из Яндекс.Маркета
Где находится: блок «Яндекс.Маркет» на странице настроек.
Получение API-ключа Яндекс.Маркета
- Зайдите в личный кабинет Яндекс.Маркета для продавцов
- Перейдите в раздел API и создайте ключ. Необходимые права:
- Чтение отзывов о товарах (эндпоинт
/v2/businesses/{id}/goods-feedback)
- Чтение отзывов о товарах (эндпоинт
- Скопируйте API-Key и Business ID (идентификатор вашего бизнеса, отображается в личном кабинете)
Параметры:
| Настройка | Описание |
|---|---|
| Business ID | Идентификатор бизнеса в Яндекс.Маркете |
| Токен | Токен авторизации API (передаётся в заголовке Api-Key) |
| ID для сопоставления товаров | Как сопоставлять отзывы с товарами (см. раздел 5) |
| Минимальная оценка | Импортировать отзывы с оценкой не ниже указанной |
| Включать отзывы с пустым текстом | Если выключено — отзывы без текста пропускаются |
Статистика, кнопки «Обновить», «Удалить» и CRON-команда работают аналогично блоку OZON.
4. Настройка импорта из Wildberries
Где находится: блок «Wildberries» на странице настроек.
Получение API-ключа Wildberries
- Зайдите в личный кабинет продавца Wildberries
- Перейдите в «Настройки → Доступ к API»
- Создайте или скопируйте существующий токен. Необходимые права:
- Отзывы (Feedbacks API) — чтение (эндпоинт
/api/v1/feedbacks)
- Отзывы (Feedbacks API) — чтение (эндпоинт
- Токен передаётся в заголовке
Authorization
Ограничение API: Wildberries допускает не более 3 запросов в секунду. Плагин соблюдает это ограничение автоматически — между запросами выдерживается пауза не менее 333 мс.
Параметры:
| Настройка | Описание |
|---|---|
| Токен | Токен авторизации API Wildberries |
| ID для сопоставления товаров | Как сопоставлять отзывы с товарами (см. раздел 5) |
| Минимальная оценка | Импортировать отзывы с оценкой не ниже указанной |
| Включать отзывы с пустым текстом | Если выключено — отзывы без текста пропускаются |
5. Сопоставление товаров (маппинг)
Ключевая настройка для каждого маркетплейса — «ID для сопоставления товаров». Она определяет, как плагин связывает отзыв с товаром в Shop-Script.
| Вариант | Пример | Когда использовать |
|---|---|---|
| [ID Товара] | 12345 |
ID товара в Shop-Script совпадает с ID товара на маркетплейсе |
| [ID Артикула] | 12345 |
SKU товара в Shop-Script совпадает с ID на маркетплейсе |
| [Код артикула] | ABC-123 |
Рекомендуемый вариант. Код артикула в Shop-Script совпадает с артикулом на маркетплейсе |
| [ID Товара]s[ID артикула] | 12345s67890 |
Составной ключ: ID товара + буква s + ID артикула |
Рекомендация: используйте «[Код артикула]», если вы ведёте единую номенклатуру артикулов на всех площадках. Это наиболее надёжный способ сопоставления.
Важно: если товар не найден по выбранному идентификатору — отзыв будет загружен, но останется несопоставленным. Такие отзывы не отображаются на витрине, но видны в блоке статистики (счётчик «Сопоставлено отзывов»). Чтобы исправить: смените тип сопоставления, удалите старые отзывы и нажмите «Обновить» заново.
6. Ручное обновление, удаление и пересчёт рейтинга
Кнопка «Пересчитать кол-во отзывов и рейтинги»
Находится в общих настройках (блок «Общие»). Обновляет агрегированные данные в карточках товаров: количество отзывов и средний рейтинг. Нажимайте после массового импорта или удаления отзывов — без пересчёта новые оценки могут не отображаться на витрине.
Кнопка «Обновить отзывы»
Запускает процесс импорта из выбранного маркетплейса прямо сейчас:
- Плагин обращается к API маркетплейса
- Загружает отзывы по всем товарам (с учётом фильтров: минимальная оценка, пустой текст)
- Сопоставляет их с товарами в Shop-Script по выбранному идентификатору
- Сохраняет в базе данных
Процесс может занять несколько минут при большом количестве отзывов. Не закрывайте страницу до завершения.
| Элемент | Назначение |
|---|---|
| Выгружено отзывов / Сопоставлено отзывов | Статистика: сколько всего загружено и сколько привязано к товарам |
| Обновить отзывы | Запускает ручной импорт отзывов из OZON |
| Удалить сопоставленные отзывы | Удаляет все импортированные из OZON отзывы (товары не затрагиваются) |
| CRON-команда | Для автоматического обновления (см. раздел 7) |
Кнопка «Удалить сопоставленные отзывы»
Удаляет все отзывы, импортированные из выбранного маркетплейса: тексты и оценки сбрасываются, сами товары не затрагиваются. Используйте, если нужно переимпортировать отзывы заново — например, после смены ID для сопоставления.
7. Автоматическое обновление по CRON
Для каждого маркетплейса в настройках указана команда CRON. Добавьте её в crontab на сервере, чтобы отзывы подгружались автоматически по расписанию.
Команды:
| Маркетплейс | CRON-команда |
|---|---|
| OZON | php /home/user/example.com/www/cli.php shop mpreviewsImportOzonReviews |
| Яндекс.Маркет | php /home/user/example.com/www/cli.php shop mpreviewsImportYandexMarketFeedbacks |
| Wildberries | php /home/user/example.com/www/cli.php shop mpreviewsImportWildberriesFeedbacks |
Важно: убедитесь, что путь к cli.php соответствует вашему серверу, а в настройках каждого маркетплейса заполнены API-ключи и выбран тип сопоставления — иначе cron-импорт ничего не загрузит.
Пример настройки cron (раз в сутки, в 3:00 ночи):
crontab -e -u web
Добавьте строки:
0 3 * * * php /home/user/example.com/www/cli.php shop mpreviewsImportOzonReviews 0 3 * * * php /home/user/example.com/www/cli.php shop mpreviewsImportYandexMarketFeedbacks 0 3 * * * php /home/user/example.com/www/cli.php shop mpreviewsImportWildberriesFeedbacks
Поддержка в компании Bodysite производится только через создание тикета. Поддержка по телефону или мессенджерам не оказыается.
Для создания и отслеживания обращений вы можете использовать ваш личный кабинет.
В техническую поддержку входит:
- Консультации по вопросам приобретения плагина;
- Консультации по функционалу и возможностям плагина;
- Ваши предложения по дальнейшему развитию плагина.
- Выявление и решение проблем в работе функционала плагина.*
* - По причине наличия множества факторов и влияния сторонних разработок, диагностика может быть платной. Если проблема на стороне плагина подтверждается — мы возвращаем деньги.
Если у вас вопрос:
На многие вопросы есть ответы в нашем информационном хабе. Если вы не нашли ответ, напишите нам.
Если у вас ошибка:
Максимально подробно опишите детали вашего вопроса - если это ошибка, то при каких условиях и действиях её можно воспроизвести. Что происходило перед ошибкой - что обновляли/переносили/меняли ?
Убедитесь, что вы используете самую свежую версию решения, в инсталлере нет новых обновлений и имеется активная лицензия на этот продукт.
Пожалуйста, проверьте логи по инструкции.
Желательно сразу предоставить доступ в админ-панель вашего сайта для проверки настроек плагина/темы дизайна на вашем сайте. Как предоставить доступы.
В случае, если визуально причины ошибки установить не удастся могут потребоваться FTP/SSH доступы для технической диагностики.
Если у вас пожелание:
Мы всегда прислушиваемся к вашим пожеланиям и рассматриваем их в первую очередь при дальнейшем развитии нашего решения.
Опишите максимально подробно, чтобы вы хотели доработать, и какую бизнес задачу это решит для вас.
Также, мы готовы в некоторых случаях оперативно доработать решение под вас на платной основе и включить этот функционал в общее обновление.
Условия обработки обращений:
- График работы Пн-Пт, 08:00-17:00 (Мск). Сб, Вс и праздничные дни - выходные дни;
- Заявки обрабатываются только в рабочее время;
Наши продукты пользуются спросом, многие из них имеют тысячи установок, что говорит о том, что они работают. Однако, в некоторых случаях бывают индивидуальные ошибки, которые далеко не всегда вызваны нашим решением.
Если продукт опубликован давно, то мы уже устранили все возможные массовые ошибки на 99%.
Каждый проект - это уникальный набор из различных готовых решений и собственных доработок, с некоторыми из которых могут происходить технические конфликты. В случае обнаружения ошибок, нужно написать нам в поддержку, мы все проверим.
В некоторых случаях диагностика может быть платной. Если выявляется ошибка в нашем решении, то оплата возвращается.
Ошибка в плагине более вероятна, если:
а) Это новый плагин, который опубликован недавно.
б) Ошибка появилась после свежего обновления плагина.
В этом случае нужно написать нам, мы все проверим и исправим.
Самая частая причина такого поведения - выбор витрины. Во многих наших решениях есть возможность назначить индивидуальные настройки для конкретной витрины.
При этом, если вы изменяете настройки "для всех витрин", они не действуют, если уже имеются индивидуальные для этой витрины.
Откройте выпадающее поле выбора витрины и убедитесь, не выделена ли цветом нужная вам витрина.
В некоторых случаях вы можете увидеть сообщение, что на вашем сайте установлены нелицензионные продукты, которые могут быть удалены. Но ведь вы покупали лицензии, куда они могли пропасть?
Лицензии прикрепляются к конкретному ID инсталлера. Посмотреть его можно в приложении "Инсталлер" - "Настройки" - кнопка "Показать". Если этот ID на вашем сайте изменился, то все плагины будут думать, что на данной установке лицензии нет.
Почему может измениться ID инсталлера?
ID Инсталлера обычно меняется при смене хостинга или изменении файлов в папке wa-config.
Если переустановить Webasyst, то, вероятно, тоже будет новый ID.
Как вернуть прикрепление лицензий?
Купленные вами лицензии никуда не пропали, они есть в вашем личном кабинете заказчика в Webasyst. Там же вы можете прикрепить их к новому ID инсталлера.
Если лицензий нет в вашем кабинете заказчика, возможно их вам устанавливал кто-то другой и владельцем является другой аккаунт. Он может передать лицензии на ваш аккаунт, чтобы вы могли ими управлять.
В большинстве случаев для интеграции в тему дизайна нужно редактировать её шаблоны - вставить в код специальные конструкции "хелперы", которые вызывают функции плагина.
Для каждого решения есть соответствующие инструкции в этом информционном хабе.
Наши популярные плагины уже интегрировны во многие актуальные темы дизайна и дополнительных интеграций может не потребоваться. Уточните у разработчика.
Также, разработчик темы часто сам помогает с интеграцией плагинов в его тему.
За продажу и "отгрузку" готовых решений отвечает система Webasyst. Подробно про активацию они написали здесь.
- Откройте приложение «Инсталлер» в панели администрирования своего сайта.
- Перейдите на главную страницу «Инсталлера» или в раздел «Плагины/Темы дизайна».
- С помощью поля поиска найдите страницу программного продукта, лицензию которого нужно установить или активировать.
- Щёлкните по кнопке «Купить или активировать».
- Если вы не авторизованы в Центре заказчика Webasyst, введите свой email-адрес и пароль. Если вы не помните пароль для входа в Центр заказчика, восстановите его.
- Когда появится список лицензий, выберите ту, которую нужно установить или активировать.
- Дождитесь завершения установки или активации лицензии.
Скидки на наши разработки предоставляются в следующих случаях:
1) Участникам Bodysite.club - скидка 50% на любое наше решение.
2) Переход с предыдущей версии продукта - запрос промокода через телеграм-бот @bodysite_promocode_bot
3) Скидки на нашу тему дизайна при наличии лицензии на любую другую тему - 20%.
4) В рамках наших услуг по продвижению (SEO) или подключению и ведению на маркетплейсах все необходимые решения входят в стоимость.
5) Наши продукты участвуют в различных распродажах, которые устраивает Webasyst несколько раз в год.
На данный момент тестовый период предоставляется только для сайтов, расположенных "в облаке" от Webasyst.
Вы можете очень легко зарегистрировать аккаунт в облаке на любой Email, установить плагин в инсталлере и протестировать его работу и настройки.
За выдачу и активацию лицензий отвечает компания Webasyst. В вашем личном кабинете заказчика вы можете управлять купленными лицензиями - перепривязывать к другим сайтам или передавать на другие аккаунты.
Если на вашем сайте указано, что "продукт не лицензирован", то проверьте к какому ID инталлера привязана лицензия в личном кабинете заказчика. Узнать, какой у вашего сайта ID инсталлера можно в разделе "Инсталлер" - "Настройки", кликните "показать" на Id инсталлера.
Если лицензии в вашем кабинете нет, то, возможно, её приобретал кто-то другой и не передал все права на неё на ваш аккаунт. Обратитесь к тому, кто её приобретал.
Использование продукта без лицензии - серьёзное нарушение законодательства РФ.
У нас есть подробная инструкция по настройке Cron.
Если ничего не получается, то в большинстве случаев помогает поддержка вашего хостинга.
