> 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/crm-sistemy/retailcrm.md).

# RetailCRM

* **Управлять клиентской базой:** собирает данные о клиентах из всех каналов (сайт, мессенджеры, соцсети, телефон, маркетплейсы) в едином профиле.
* **Обрабатывать заказы:** позволяет обрабатывать заказы, менять их статусы и управлять товарами в одном окне.
* **Автоматизировать продажи и маркетинг (**рассылки, программы лояльности, автоматические цепочки**)**

## Подключение

{% stepper %}
{% step %}

### Заходим в Настройки RetailCRM.

Для подключения необходимо зайти в раздел настоек RetailCRM, он находится внизу на боковой панели.

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

{% step %}

### Переходим к подключению через Маркетплейс.

Нажмите на **"Маркетплейс"** на боковой панели, затем введите в поиске **"Савви"**, нажмите на иконку приложения и следуйте инструкциям.

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

{% step %}

### Авторизуйтесь на платформе.

После перехода из RetalCRM потребуется авторизация на платформе Suvvy. Введите свой логин и пароль.

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

{% step %}

### Переходим в настройки каналов агента, к которому подключаем RetailCRM.

Нажимаем на вкладку **"Каналы"**, переходим в раздел **"CRM-системы"**, выбираем RetailCRM.

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

{% step %}

### Подключаем нужный аккаунт.

В выпадающем списке выбираем нужный аккаунт и нажимаем на **"Подключить из списка"**.

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

{% step %}

### Завершение настройки.

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

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

## Действия в RetailCRM

### Выполнение действий

При работе с RetailCRM агент может проставлять теги и менять ответственного. Для выполнения этих действий необходимо создать файл в [Прямых вопросах](/ru/baza-znanii/baza-znanii/pryamye-voprosy.md) и настроить необходимое действие на вкладке **"Действия в RetailCRM"**. Для выполнения действия необходимо прописать в инструкции агента условия при которых будет выполняться это действие, затем прописать вызов функции get\_file\_text, либо вызвать файл другим доступным способом.

```
После подтверждения покупки клиентом вызови функцию get_file_text("Purchase").
```

При выполнении условий будет вызван файл и выполнено действие.

### Установка тегов

В RetailCRM нет механизма смены статусов, которые представлены в некоторых других CRM, но их заменяет возможность установки тегов.

При активном подключении RetailCRM в файле прямых вопросов будет доступна вкладка Действия в RetailCRM. Настройка тегов выполняется на вкладке **"Установка тегов"**.

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

Для установки тега необходимо активировать флаг **"Добавить тэг к диалогу"**. Далее необходимо создать тег нажатием на кнопку **"Добавить тег"**.\
При необходимости установки только новых тегов активируйте флаг **"Очищать список текущих тэгов перед установкой новых"**.

### Смена ответственного

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

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

## Смена статуса заказа

В RetailCRM можно настроить смену статуса заказа. Для этого нужно перейти в раздел **Заказы:**

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

Перед Вами откроется таблица. Каждая строка представляет собой **поле из RetailCRM**

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

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

* **Создание** — бот запрашивает значение этого поля у клиента при оформлении нового заказа.
* **Редактирование** — бот может вносить изменения в это поле уже существующего заказа.
* **Получение** — содержимое поля выводится боту при запросе списка заказов.
* **Инструкция** — данные из поля автоматически добавляются в системный промпт (инструкцию) перед генерацией каждого ответа.

Отметим напротив поля status флажками: **Создание, Редактирование, Получение и Инструкция:**

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

После чего внизу таблицы  у нас сразу появятся настройки:

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

**Допустимые статусы для создания** — здесь указываем статусы, в которых будет создаваться заказ

**Допустимые статусы для редактирования** — здесь указываем статусы, которые можно редактировать

**Лимит заказов в инструкции** — тут можно указать допустимое количество заказов в инструкции

Флаг **Отмена заказа** позволяет отменять заказы

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

Также можно отметить, с заказами каких именно товаров будет работа

<figure><img src="/files/5WopyzmvfeD5zDnnYDhe" alt=""><figcaption></figcaption></figure>

### Примеры инструкций для работы с заказами и статусами:

В **RetailCRM** реализованы следующие сценарии:

1. **Получение списка заказа клиентов**

Вариант инструкции: Если клиент просит получить список своих заказов, вызови функцию `retailcrm_get_orders`

2. **Создание нового заказа**

Вариант инструкции: Если клиент просит создать новый заказ, вызови функцию `retailcrm_create_order`

3. **Редактирование заказа**

Вариант инструкции: Измени количество товаров в заказе, используя функцию `retailcrm_edit_order`&#x20;

или:

Убери/добавь наименование\_товара, используя функцию `retailcrm_edit_order`&#x20;

{% hint style="info" %}
Редактируются только те поля, которые включены в retailcrm\_edit\_order. Например если включены только status и comment, то при вызове функции бот сможет изменить статус заказа или добавить комментарий. Остальные поля он не сможет редактировать.
{% endhint %}

4. **Отмена заказа**

Вариант инструкции: Если клиент хочет отменить заказ, вызови функцию <kbd>retailcrm\_cancel\_order</kbd>&#x20;

5. **Изменение статуса заказа**

Чтобы изменить статус остаточно прописать только бизнес-логику, например:

Если клиент написал, что хочет отменить заказ,  измени поле  status на cancel.


---

# 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/crm-sistemy/retailcrm.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.