# Wildberries

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

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

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

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

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

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

{% stepper %}
{% step %}

#### Создаем бота

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F3Sb7J6vRIKG8rpYppF31%2Fimage.png?alt=media&#x26;token=3dd60c08-b8e2-459a-9a05-88da61a82043" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FKqkXQviKC2pJQDBoMKyd%2Fimage.png?alt=media&#x26;token=abd2eb27-cc7c-418b-a178-65a10be45ba0" alt=""><figcaption></figcaption></figure>

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

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FyZHuOzyehXc4RMj0RRwQ%2Fimage.png?alt=media&#x26;token=0d3503b3-6ca8-4641-a8e4-f1500dc74b5a" alt=""><figcaption></figcaption></figure>

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

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fbbogq5AhvZnQgFgw9Ap4%2Fimage.png?alt=media&#x26;token=2a33ca97-3561-4ff4-bea4-77037177fbb5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FZXT0DhLBT7pCVp1Hn5Ls%2Fimage.png?alt=media&#x26;token=ba13a7ca-78e8-404f-9ec9-29b30bc0fa1c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FUwXMBrWVBTmQ8AFqkeT3%2Fimage.png?alt=media&#x26;token=2c783839-38ea-445c-8752-2738d1566eda" alt=""><figcaption></figcaption></figure>

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

{% content-ref url="../../osnovnye-nastroiki/opovesheniya-ot-savvi" %}
[opovesheniya-ot-savvi](https://docs.suvvy.ai/ru/osnovnye-nastroiki/opovesheniya-ot-savvi)
{% endcontent-ref %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F6ysqnSC7cpY4pV69hn5j%2Fimage.png?alt=media&#x26;token=46aacdc7-050b-48ad-9bff-0723ce472a2a" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FRTFfS6zeQqxhunCgMXP7%2Fimage.png?alt=media&#x26;token=52d67e8a-fee2-41b7-a23c-1909d24ec467" alt=""><figcaption></figcaption></figure>

API ключ

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FeKnSBXYTEzuu7znb7vxM%2Fimage.png?alt=media&#x26;token=e931d7e2-bc43-4bda-8649-e02370444403" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FFFYe9Cf42fyNQv5Qjd0J%2Fimage.png?alt=media&#x26;token=87ecc31d-e77e-4021-9bfe-4cdf5783a7e9" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F37JWDJSX6RJ2UkTvmnPh%2Fimage.png?alt=media&#x26;token=df31441f-a17b-4678-87ac-8362a8f5582b" alt=""><figcaption></figcaption></figure>

*

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F2JHgroHb5IOyRy6ie3jq%2Fimage.png?alt=media&#x26;token=244c8ccf-e464-4e8d-846d-222694f86e16" alt=""><figcaption></figcaption></figure>

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

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

{% stepper %}
{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F0XKYenscgQK3eogYMoVC%2Fimage.png?alt=media&#x26;token=98f2eefe-ec74-46db-92c2-f602ff51a197" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fg4yefBwadIBzEEQ0HgiD%2Fimage.png?alt=media&#x26;token=41d712c0-e1f9-4f5b-a4b2-38d58283bf30" alt=""><figcaption><p>Шаблон</p></figcaption></figure>

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

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FSHt8OGIUdyFSVGdJgHsP%2Fimage.png?alt=media&#x26;token=e1a27252-d7d1-4d40-a463-9410902c8516" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F5igY0u7swyGc7iZZn5gp%2Fimage.png?alt=media&#x26;token=ce5cb69f-897a-4034-abb7-3d5390cbf7b3" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FDpcqfGocpA50XOU3727H%2Fimage.png?alt=media&#x26;token=8761da6b-66b5-4155-b1dd-8b27a6d671b6" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fb1gQj2rtUWUyNKsBYUoX%2Fimage.png?alt=media&#x26;token=f7cab083-9da7-4451-abfa-2720f2979c92" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FlDK59YaHZoLNlO1oaPAq%2Fimage.png?alt=media&#x26;token=27c66d64-dca5-430b-9593-f0909996c7e0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F9kryhJD0UQWOhrnmyyFS%2Fimage.png?alt=media&#x26;token=346f9f98-50f1-4e23-aca6-5661f28ae04c" alt=""><figcaption></figcaption></figure>

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

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

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

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FM57risJgRPNPijXQx7Ts%2Fimage.png?alt=media&#x26;token=276f6dac-adb2-4cf2-8648-7905daa691b1" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{% step %}

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F897h51rJC2rpmfHwFXEx%2Fimage.png?alt=media&#x26;token=332d9bef-92db-45cb-ba22-a4a1bb5907df" alt=""><figcaption></figcaption></figure>

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

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

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

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

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FFaSSNDM2AxxnEvDmFmJs%2Fimage.png?alt=media&#x26;token=a1c80ec7-bd01-4e3f-ac8d-7d83f466865a" alt=""><figcaption></figcaption></figure>

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

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FfL9ibAeUGjRYqsoJ0k2Q%2Fimage.png?alt=media&#x26;token=d5704194-a77b-4ad5-b7a9-775900dfe69a" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fp3Cnun72DG1DpndWkmR4%2Fimage.png?alt=media&#x26;token=725dab76-ac4e-40e3-9f39-e748094731bc" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FSkN9ZWti9Sumw7tcoa6k%2Fimage.png?alt=media&#x26;token=77008ce9-84e0-4e4a-8660-e9b2c16dbbd3" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FODVuwsIZak9z1V7WR4ht%2Fimage.png?alt=media&#x26;token=9088896f-3d68-400b-adad-536440bff60e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fs5nXNhPuOef0YQLCgu0S%2Fimage.png?alt=media&#x26;token=c0d6b8b5-61df-474d-8539-5e806f106ca9" alt=""><figcaption></figcaption></figure>

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

{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F21B4XHXfW1uedxXBIAw0%2Fimage.png?alt=media&#x26;token=ced633a8-0c92-47a8-839e-c305c9603625" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}

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

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