> 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/yandeks.market.md).

# Яндекс.Маркет

В данном разделе представлена информация о порядке подключения канала Яндекс.Маркет.

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

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

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

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

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

1. ### Создайте агента <a href="#sozdaite-bota" id="sozdaite-bota"></a>

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FEMyZH9d2lkIFwkSnffUT%2F%D0%AF%D0%9C1.png?alt=media&amp;token=287dbd88-9a2b-4599-bb53-895b5f007d65" alt=""><figcaption></figcaption></figure>

2. ### Переходим на вкладку "Каналы" и выбираем канал "Яндекс.Маркет"

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FpVCX5GUTzN6PueRooPEW%2F%D0%AF%D0%9C2.png?alt=media&amp;token=1215f0c2-8aeb-48f5-bb81-a9772d21bb22" alt=""><figcaption></figcaption></figure>

3. ### Создайте API ключ с нужными правами в личном кабинете Яндекс.Маркета:

Переходим во вкладку **Модули и API**

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F3HRSZTcysBoNf092iczn%2F%D0%AF%D0%9C3.png?alt=media&amp;token=0eab2671-6b69-4b93-8701-c8c553f8a483" alt=""><figcaption></figcaption></figure>

Создаем новый токен, нажатием на кнопку **Выбрать доступы**

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FC5H24xFPyrCV9roXhtI9%2F%D0%AF%D0%9C4.png?alt=media&amp;token=e8649c26-328a-4ae9-b180-ce2817aa77ad" alt=""><figcaption></figcaption></figure>

#### Придумываем любое название, выбираем нужные доступы:

**Общение с покупателями — communication**\
**Просмотр товаров и карточек — offers-and-cards-management:read-only**

И нажимаем сохранить!

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FoD0ImTvDOmJCHNMJ7crp%2F%D0%AF%D0%9C5.png?alt=media&amp;token=4bffdac7-2f5f-461d-b3de-d061786e6919" alt=""><figcaption></figcaption></figure>

#### Получаем наш токен и вставляем его в окошко интеграции канала Яндекс.Маркета в Савви.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FZDGcRpwEh075BPKkS5DB%2F%D0%AF%D0%9C6.png?alt=media&amp;token=6f578bac-4d23-4416-a9b6-737733eff39f" alt=""><figcaption></figcaption></figure>

#### После того, как вы подключите токен ЯМ к Савви - нажмите на кнопку **Скопировать URL для получения уведомлений.**

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F4mmlGCk4LFfJRuvQV5Lh%2F%D0%AF%D0%9C7.png?alt=media&amp;token=c16d3c57-dafa-4649-b6e0-e45836b11c89" 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%2FLBBsbFp21HZYrLEu6Z6W%2F%D0%AF%D0%9C8.png?alt=media&amp;token=57bf14a1-3f02-4d16-961e-8c2b124a625b" alt=""><figcaption></figcaption></figure>

#### Нажимаем **Подключить**

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FU8R8u61AUbKgiYRjWjwW%2F%D0%AF%D0%9C9.png?alt=media&amp;token=ea68caad-4f3b-446a-9a6c-90c879fa2f8a" alt=""><figcaption></figcaption></figure>

* Придумываем любое название.
* Выбираем **для кабинета**.
* Выбираем нужные типы уведомлений - **новый отзыв, новое сообщение в чате.**
* **Вставляем URL, который мы скопировали из Савви.**

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F5P05TyIeb6rMFg8nw1aC%2F%D0%AF%D0%9C10.png?alt=media&amp;token=b95a06f1-e90f-41dd-bef0-b5ade47cbb8d" alt=""><figcaption></figcaption></figure>

Готово, все успешно подключено!

### Настройки интеграции

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F8pHBJOW4eRZtKozst8OA%2Fimage.png?alt=media&amp;token=7cb08d99-a5e8-41ba-9987-edb31b12e575" alt=""><figcaption></figcaption></figure>

* **Включить отбор по списку артикулов** - Список артикулов, на которые нужно отвечать. Если список пуст, ответы будут на все артикулы. Если в списке есть артикулы, ответы будут только на них. Список артикулов надо составлять через запятую.
* **Дополнительные инструкции для ответа на вопрос/отзыв** - служебные инструкции для обработки вопросов/ответов от покупателей.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F0fjigoKlxmlGg8ejYmRZ%2Fimage.png?alt=media&amp;token=f3c7bf26-5049-4ca8-9445-4fbaf81ca295" alt=""><figcaption></figcaption></figure>

* **Получение вопросов/ответов с Яндекс.Маркет** - при включенном флаге в агента начинают поступать все вопросы и отзывы покупателей.
* **Отправлять уведомление, если агент не может найти ответ на отзыв/вопрос** - в случае, если Савви не найдет ответ на вопрос в карточке товара или таблице ответов, он не отправит ответ на вопрос в маркетплейс, а отправит [уведомление в чат агента Telegram](/ru/osnovnye-nastroiki/opovesheniya-ot-savvi.md) о том, что задан вопрос и агент не смог ответить (если не выполнены дополнительные настройки, раздел описан ниже).
* **Получать данные из карточки** - агент получает данные из карточки товара на Яндекс.Маркет.
* **Использовать таблицу с доп. описанием товаров** - Савви может отвечать на вопросы и отзывы, опираясь только на описание товара. Поскольку в карточке товара на маркетплейсе информации может не быть достаточно для подробного ответа, можно использовать дополнительную таблицу с расширенным описанием товара, по которой Савви будет отвечать на вопросы и отзывы.

{% hint style="warning" %}
Инструкция для создания Базы знаний в формате Вопрос-Ответ полностью аналогичная **Wildberries**: [**Загрузка базы знаний в формате "Вопрос-Ответ"**](/ru/kanaly/marketpleisy/wildberries.md#zagruzka-bazy-znanii-v-formate-vopros-otvet).
{% endhint %}

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Ff2L2xy8nzWRpmubRDwip%2Fimage.png?alt=media&amp;token=38aca8a2-a09a-4334-abb0-fb9d6ad97943" alt=""><figcaption></figcaption></figure>

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

{% hint style="warning" %}
Инструкцию по автоматическому формированию Базы знаний на основе истории вопросов/ответов смотрите в разделе для **Wildberries**: [**Автоматическая генерация вопросов/отзывов**](/ru/kanaly/marketpleisy/wildberries.md#avtomaticheskaya-generaciya-voprosov-otzyvov).
{% endhint %}


---

# 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/yandeks.market.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.