Использование собственной формы отзыва

В редких случаях может возникнуть необходимость использовать свою форму отзыва. Для этого существует специальное Submissions API, с помощью которого вы можете отправлять отзывы с вашего сайта или мобильного приложения в Aplaut.

Настройка формы под категорию товара

В личном кабинете можно настроить форму под категорию товара. Чтобы использовать эти настройки в собственной форме, получите их через специальный ресурс в Submissions API.

Внимание: чтобы ваша собственная форма работала корректно в связке с UGC-кампаниями Aplaut, а именно, при сборе отзывов вместо формы Aplaut открылась ваша форма и в интерфейсе Aplaut работала связка отзыв—>заказ—>клиент, вам нужно:

• Установить базовую часть нашего скрипта на сайте (см. Установка скрипта Aplaut раздел "Базовая часть скрипта - загрузчик");

• Перехватить специальное событие при переходе пользователя по клику "Оставить отзыв" в письме с приглашением оставить отзыв;

• Получить из него ID приглашения invitation_id;

• Открыть собственную форму;

• При отправке отзыва после заполнения формы пользователем отправить invitation_id в параметрах запроса:  https://s-api.aplaut.io/v2/reviews?invitation_id=123456789123456789 .

Пример перехвата события:

function showMyOwnReviewForm(invitation_id) {
  // Открываем форму, добавляем invitation_id к отзыву при сабмите
}

_shoppilot.push([
  '_setOnReady',
  function(Shoppilot) {
    Shoppilot.require('events').on('omnibox.command', function(event) {
      var command = event.data.command;
      if (command.name == 'showReviewForm') {
        event.preventDefault();
        showMyOwnReviewForm(command.params.invitation_id);
      }
    });
  }
]);

Пример cURL POST запроса для отправки отзыва с invitation_id:  

curl --location 'https://s-api.aplaut.io/v2/reviews?invitation_id=123456789123456789'
--header 'Authorization: Bearer token=<APLAUT_AUTH_TOKEN>'
--header 'Content-Type: application/json'
--data '{
     "review": {
         "rating": 5,
         "product_id": "123456789",
         "body": "Текст отзыва",
         "pros": "Достоинства",
         "cons": "Недостатки",
         "author_name": "Алексей",
         ...
     }
 }'