Отзывы о товарах

Раздел описывает интеграцию сервиса отзывов о товарах. Клиент оценивает купленный товар по шкале от 1 до 5 и, если хочет, дополняет оценку текстом. Опубликованные отзывы и сводная оценка выводятся на карточке товара.

Оценка обязательна, текст отзыва — нет. То есть клиент может оставить либо просто оценку, либо оценку вместе с отзывом.

Привязка к заказу

Отзыв всегда привязан к заказу, в котором клиент купил товар. Это дает два свойства:

1. Отзыв оставляет тот, кто действительно покупал товар.
2. Один клиент может оценить один и тот же товар несколько раз — если покупал его в разных заказах. Повторный отзыв на один товар в рамках одного заказа создать нельзя.

Таким образом, отзыв однозначно определяется тройкой: товар + заказ + клиент.

Идентификация клиента

Отзывы принимаются только с серверной стороны магазина, поэтому идентификатор устройства did в методах этого раздела не используется. Клиент передается одним или несколькими идентификаторами:

Параметр	Описание
email	Email клиента
phone	Телефон клиента
loyalty_id	Идентификатор участника программы лояльности
external_id	Внешний идентификатор клиента в системе магазина
telegram_id	Идентификатор клиента в Telegram

Обязателен хотя бы один из них. Если клиента с такими данными в CDP еще нет, он будет создан.

Если передано сразу несколько идентификаторов — например, email и phone — нужный клиент определяется алгоритмом realtime-матчинга по настроенным для проекта ключам склейки. Поэтому не нужно выбирать «главный» идентификатор на своей стороне: передавайте все, что знаете о клиенте.

Статусы и модерация

Каждый отзыв имеет статус модерации:

Статус	Описание
moderation	Отзыв ожидает модерации. Начальный статус любого нового отзыва
published	Отзыв опубликован и отдается в методе reviews/product
rejected	Отзыв отклонен и нигде не публикуется

Новый отзыв всегда создается в статусе moderation. Правка оценки или текста возвращает отзыв на модерацию.

Модерировать отзывы можно двумя способами:

1. В личном кабинете, в разделе «Опросы и формы → Отзывы о товарах → Отчет».
2. На стороне магазина, методами раздела Модерация.

Методы

Метод	Назначение
reviews/create	Сохранить отзыв
reviews/update	Обновить оценку и текст отзыва
reviews/delete	Удалить отзыв
reviews/product	Опубликованные отзывы и сводная оценка товара
Модерация	Публикация, отклонение и возврат на модерацию
Импорт отзывов	Перенос и синхронизация отзывов из другой системы

Авторизация

Все методы, кроме reviews/product, требуют API-ключ shop_id и секретный ключ shop_secret. Метод reviews/product публичный — он вызывается с карточки товара и требует только shop_id.

Сервис отзывов о товарах должен быть подключен в тарифе. Если услуга не подключена, методы отвечают ошибкой 403 Service is not enabled.

Структура ответа

Все методы раздела отдают ответ в стандартном формате: полезная нагрузка и текст ошибки всегда лежат в payload.

{
  "status": "success",
  "payload": { }
}

{
  "status": "error",
  "payload": {
    "message": "..."
  }
}