> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/kanaly/marketpleisy/wildberries.md).

# Wildberries

## Что позволяет?

Данный канал предназначен для автоматизации ответов на вопросы или отзывы на площадке маркетплейса **Wildberries**.

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

Вам не придется больше заниматься рутиной и тратить время на типовые вопросы. Система в автоматическом режиме будет получать с площадки вопросы клиентов, в привязке к товарам, анализировать загруженную в нее обучающую базу знаний и формировать на ее основе ответы.

Так как агент работает на базе искусственного интеллекта, то ответы будут формироваться динамически, то есть даже если нет 100% совпадения вопроса с представленным в базе знаний, агент сможет проанализировать ответы на схожие вопросы по этому товару и на их основании сформировать релевантный ответ.

## Как подключить?

{% stepper %}
{% step %}

#### Создаем агента

<figure><img src="/files/3nhETOgGasOHEv8lk7lN" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Переходим на вкладку "Каналы" и выбираем канал "Wildberries"

<figure><img src="/files/j4sNsrCavOJzGssRVd6K" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Подключенные каналы будут выделяться <mark style="color:green;">зеленым цветом</mark>. Если вы еще не подключили канал, то у вас он может быть не выделен.
{% endhint %}
{% endstep %}

{% step %}

#### Получаем Токен в личном кабинете Wildberries

<figure><img src="/files/pkQtNHfgLQB5v00FNmGi" alt=""><figcaption></figcaption></figure>

Токен необходимо создать с категориями "**Контент**" и "**Вопросы и отзывы**".

{% hint style="warning" %}
Обратите внимание, что при подключении нового агента или включении канала с **базовым токеном** будет возникать ошибка.

Для корректной работы необходимо выпустить **Персональный** или **Сервисный** токены.

Клиентам с **Базовыми** токенами необходимо перевыпустить токен.
{% endhint %}
{% endstep %}

{% step %}

#### Вставляем полученный токен в поле "API Ключ" и нажимаем "Подключить"

<figure><img src="/files/MPBXccBfVW4jB4XxAQfO" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### После авторизации нам становятся доступны все настройки интеграции.

<figure><img src="/files/m7ZFEHXvUdUDRhORPiCf" alt=""><figcaption></figcaption></figure>

* **Получение вопросов/ответов с ВБ** - при включенном флаге в агента начинают поступать все вопросы и отзывы покупателей.
* **Отправка ответов агента на ВБ** - включает и отключает отправку ответов агента на вопросы и отзывы покупателей на ВБ. Эта настройка используется при наладке и тестировании работы агента на реальных вопросах и отзывах покупателей. При выключенном флаге вопросы и ответы поступают агенту, он генерирует ответы, но не отправляет их на ВБ. В тестовом чате ответы будут зачеркнуты:

<figure><img src="/files/i2TiVjNCffl2HDCgkvFn" alt=""><figcaption></figcaption></figure>

* **Отправлять уведомление, если агент не может найти ответ на отзыв/вопрос** - в случае, если Савви не найдет ответ на вопрос в карточке товара или таблице ответов, он не отправит ответ на вопрос в маркетплейс, а отправит уведомление в чат агента Telegram *(подробнее по ссылке ниже)* о том, что задан вопрос и агент не смог ответить (если не выполнены дополнительные настройки, раздел описан ниже).

{% content-ref url="/pages/NwYW7SXgdBTZpY34SZ8y" %}
[Оповещения от Савви](/ru/osnovnye-nastroiki/opovesheniya-ot-savvi.md)
{% endcontent-ref %}

* **Получать данные из карточки** - агент получает данные из карточки товара на Wildberries.
* **Использовать таблицу с доп. описанием товаров** - Савви может отвечать на вопросы и отзывы, опираясь только на описание товара. Поскольку в карточке товара на маркетплейсе информации может не быть достаточно для подробного ответа, можно использовать дополнительную таблицу с расширенным описанием товара, по которой Савви будет отвечать на вопросы и отзывы

<figure><img src="/files/t4c3gxp4M6pLulEljHKO" alt=""><figcaption></figcaption></figure>

* **Ответы на вопросы/Ответы на отзывы** - можно отдельно выбрать, агент будет отвечать только на вопросы или отзывы.
* **Использовать таблицу Вопрос-Ответ** - помимо того, что Савви получает данные из карточки товара, можно настроить его ответы по подготовленным заранее шаблонам ответов.
* **Процент сходства** – это уровень сходства, при котором Савви находит ответ в таблице. Чем меньше значение порога срабатывания (ближе к 0) – тем чаще агент будет находить в таблице информацию, т.е. тем менее точным будет совпадение относительно запроса. Чем больше значение порога срабатывания (ближе к 100%) – тем агент будет искать более точное совпадение. Значение 100% означает, что агент будет искать только абсолютно точное совпадение запроса и вопроса в таблице. Рекомендуемый порог срабатывания: 50%.
* **Автоматическая генерация вопросов/отзывов** - генерация ответов позволяет собрать типовые ответы на типовые вопросы/отзывы на основе предыдущих ответов, которые были ранее по вашим товарам. Инструкцию по созданию Базы знаний на основе истории вопросов/ответов смотрите в разделе: [Автоматическая генерация вопросов/отзывов](#avtomaticheskaya-generaciya-voprosov-otzyvov).
* **Отвечать на отзывы с текстом** - агент будет отвечать только на отзывы, в которых помимо оценки был оставлен и текстовый отзыв.
* **Оценки для ответов на отзывы с текстом** - позволяет выбирать именно для каких оценок с тестовым отзывам агент будет генерировать ответ.
* **Отвечать на отзывы без текста с преимуществами/недостатками** - агент будет отвечать на отзывы без текста, но в которых отмечены преимущества или недостатки товара.
* **Отвечать на отзывы без текста (только оценка)** - агент будет отправлять отзыв на оценки без текста.

#### Раздел - Настройки

<figure><img src="/files/og48xCefthHzbz7EdW7a" alt=""><figcaption></figcaption></figure>

API ключ

<figure><img src="/files/qg2F66kq4BAxVBnuaICT" alt=""><figcaption></figcaption></figure>

* Здесь, всегда можно посмотреть используемый API ключ.

<figure><img src="/files/Lj4TVpYKUmO12tQPc8gz" alt=""><figcaption></figcaption></figure>

* **Режим ответа на видео в отзывах** - выбирается режим ответа, если в отзыве покупатель прислал видео.

<figure><img src="/files/1IbIi4mPN3BbNUPAeqI8" alt=""><figcaption></figcaption></figure>

*

<figure><img src="/files/e7X9IZk3tJ9VSfhMSW8C" alt=""><figcaption></figcaption></figure>

* **Дополнительные инструкции для ответа на вопрос/отзыв** - служебные инструкции для обработки вопросов/ответов от покупателей.
  {% endstep %}
  {% endstepper %}

### Загрузка базы знаний в формате "Вопрос-Ответ".

{% stepper %}
{% step %}

#### Скачиваем шаблон

<figure><img src="/files/yNUp8XFSPd4QRpeQybcD" alt=""><figcaption></figcaption></figure>

Необходимо подготовить файл в формате **xlsx** (Excel) или Google таблицу по специальному шаблону, который можно скачать, нажав на кнопку "**Скачать шаблон**".

Таблица должна иметь следующий вид:

<figure><img src="/files/QGdt1NIELIIHmiU952KR" alt=""><figcaption><p>Шаблон</p></figcaption></figure>

{% hint style="info" %}
В колонке "**Артикул**" можно указать несколько артикулов, разделяя их пробелом или запятой - это позволит привязать типовой вопрос/ответ сразу к нескольким товарам.\
\
Если вопрос относится ко всем товарам, то поле "**Артикул**" необходимо оставить пустым.
{% endhint %}
{% endstep %}

{% step %}

#### Переходим в раздел Таблицы.

<figure><img src="/files/cemkUP9CspinAlGLMOio" alt=""><figcaption></figcaption></figure>

[Импортируем созданный по шаблону файл или подключаемся к Google таблице.](/ru/rabota-s-tablicami/tablicy-csv-xls-google.md)

Обратите внимание, настройки для получения, изменения и добавления данных в таблицы должны быть отключены:

<figure><img src="/files/DDPcya04w0KXpJFZnvom" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### После загрузки, выбираем соответствующую таблицу

<figure><img src="/files/RrYRE1SjOJJM5FApJO7a" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### **Автоматическая генерация вопросов/отзывов**

{% stepper %}
{% step %}

#### Для создания Базы знаний имеющиеся вопросы и отзывы с ответами загружаются из Wildberries. Для этого нажмите Запустить генерацию

<figure><img src="/files/9UMuLOSjJ58IUas9zbmX" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### В открывшемся окне выбираем соответственно необходимый вариант генерации: ответы на вопросы или на отзывы и нажимаем "Далее"

Можно выбрать одновременную генерацию для вопросов и отзывов.

<figure><img src="/files/KjblKjCELW4fG4dK6Osa" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Откроется окно для выбора количества пар вопрос-ответ/отзыв-ответ для генерации

<figure><img src="/files/eZhsAHa9JVVomHWpWMAb" alt=""><figcaption></figcaption></figure>

Для справки указана средняя стоимость генерации и текущий баланс.

{% hint style="warning" %}
При регистрации аккаунта, во время тестового периода, можно сгенерировать 100 пар вопрос-ответ или отзыв-ответ бесплатно.
{% endhint %}

Выбираем **Количество вопросов** и нажимаем - **Сгенерировать базу знаний**.
{% endstep %}

{% step %}

#### Процесс генерации состоит из нескольких стадий:

<figure><img src="/files/z6u7nYqyFXljpjEP45pT" alt=""><figcaption></figcaption></figure>

1\. **Обработка** - постановка задачи в очередь, задача добавляется в систему.

2\. **Скачивание контента с маркетплейса** — система запрашивает вопросы/отзывы.

3\. **Обработка и генерация** — AI обрабатывает полученные данные.

4\. **Подключение к агенту** — результаты интегрируются в агента.

{% hint style="warning" %}
**Продолжительность**: Процесс может занять значительное время (несколько минут), особенно при генерации большого объёма.
{% endhint %}

**Отслеживание статуса:**

· Генерация может выполняться в фоне. При необходимости вы можете покинуть этот экран и вернуться к процессу позже из раздела «Инструкции агента».

{% hint style="danger" %}
Генерацию можно отменить, но только до определённого момента:

· ✅ Отмена доступна до начала обработки данных.

· ❌ После того как процесс перейдёт в стадию обработки, отмену выполнить невозможно, и средства будут списаны.
{% endhint %}

**Если возникла ошибка:**

1\. Система выдаёт соответствующее сообщение об ошибке.

2\. Пользователю предоставляется возможность повторно запустить генерацию.

**Дополнительная генерация:**

После успешной генерации пользователь может:

· Сгенерировать дополнительный контент (например, ещё 500 вопросов, если первый раз было 100).

· Повторить процесс неограниченное количество раз (при наличии средств).
{% endstep %}

{% step %}

<figure><img src="/files/kywHXEPlvV4snkcyKhmd" alt=""><figcaption></figcaption></figure>

#### После завершения генерации мы видим следующую информацию:

* Сколько вопросов/отзывов было обработано.
* Сколько загружено в базу знаний.

{% hint style="warning" %}
При обработке вопросов они оптимизируются и объединяются по смыслу, поэтому загруженных обычно меньше, чем изначально анализируется.
{% endhint %}

* Фактическая стоимость генерации
  {% endstep %}

{% step %}

#### Дальше можно скачать результат в виде таблицы Excel

<figure><img src="/files/UZJjZTCPhxtJxx9rjsqY" alt=""><figcaption></figcaption></figure>

Таблица содержит следующие столбцы: Дату и время создания вопроса-ответа на МП, Вопросы, Ответы, Артикул. Таблицу можно редактировать для дальнейшего использования.
{% endstep %}

{% step %}

#### Или перейти к тестированию

<figure><img src="/files/uqEXgowCynIzpKmOGpTS" alt=""><figcaption></figcaption></figure>

Так как диалоги на МП не имеют длительного контекста, а состоят только из одного вопроса/отзыва и одного ответа, каждый новый вопрос или отзыв здесь открывается как отдельный диалог.

Выберите артикул и напишите внизу вопрос или отзыв по нему, ИИ-агент должен дать ответ.

Формируется ответ на основании информации содержащейся в полученной таблице:

<figure><img src="/files/ZRCJZCXsVESQN2BacuAK" alt=""><figcaption></figcaption></figure>

Если нажать на значок "i" мы увидим всю информацию по данному артикулу которая есть в базе:

<figure><img src="/files/UtXCnHo47Q695IY8u14l" alt=""><figcaption></figcaption></figure>

Также можно подписаться на ИИ-агента, чтобы получать уведомления в Telegram, например в случае, если агент не найдет ответ в базе знаний.

<figure><img src="/files/dQ0U0s61sOWaJzNZ0s2U" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### После тестов можно:

<figure><img src="/files/TFRecsOMgkBkvH23WOZq" alt=""><figcaption></figcaption></figure>

* Активировать подключение агента для ответов на МП.
* Сгенерировать дополнительную базу знаний.
* Перейти к другим настройкам - осуществляется переход в раздел: **Инструкция**
  {% endstep %}

{% step %}

#### Сгенерированные таблицы Базы знаний отображаются в разделе Таблицы:

<figure><img src="/files/8YXfIjqlZBmMW4d0UfS8" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Алгоритм обработки вопросов и отзывов:

* Первым этапом система проверяет входящий вопрос (отзыв) по системе "вопрос - ответ", если ответа в таблице найти не удалось, система может получить описание товара из карточки товара и дать ответ на вопрос на основании описания товара;
* После получения описания товара из WB, агент проверит наличие дополнительного описания в соответствующей таблице, если она подключена.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.suvvy.ai/ru/kanaly/marketpleisy/wildberries.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.