# RetailCRM

ИИ для интернет-магазина: заказы RetailCRM по статусам

E-commerce CRM — заказы, клиенты, товары, справочники, задачи, аналитика

## Как агент работает с RetailCRM

Агент ходит в API RetailCRM пятой версии на адресе вашего кабинета — retailcrm.ru или retailcrm.pro — и читает заказы, клиентов, товары, справочники, задачи и аналитику. На них строится сводка заказов по статусам, источникам и магазинам с выручкой за период, сегментация клиентов по частоте и давности покупок вместе с уснувшими постоянниками и разбор задач менеджеров с просрочкой по заказам в работе.

Начинает агент со справочника статусов, и это не формальность: статусы в RetailCRM настраиваются под магазин, названия у всех разные, а смысл несёт группа, к которой статус отнесён. Сравнивать заказы по подписи на кнопке бессмысленно — агент раскладывает их по группам и только потом считает. Так же он разделяет магазины и источники: общая цифра по аккаунту, где сложены несколько площадок, прячет ровно то, ради чего отчёт и заказывали.

Отменённые и невыкупленные заказы агент в выручку не кладёт, а показывает отдельной строкой — иначе сводка выглядит бодрее кассы. Что он умеет помимо чтения, решает набор методов, отмеченных у ключа: если изменение заказов ключу не разрешено, агент останется читающим и скажет об этом, а не будет гадать. Перед правкой заказа он перечитывает карточку — её параллельно двигают менеджеры и обмен с магазином, и затирать чужое изменение нельзя.

Доступ идёт API-ключом кабинета: он передаётся с каждым запросом, ограничен списком методов и списком магазинов и отзывается там же, где был создан. Сужение ключа до одного магазина агент читает как границу данных, а не как поломку, и так и объясняет цифру. Частоту запросов он выдерживает сам, длинные периоды забирает постранично, а если метод ключу не отмечен или заказов за период не было, говорит это прямо, а не показывает пустую таблицу.

## Сценарии интеграции

### Сводка заказов по статусам и магазинам
Агент соберёт заказы RetailCRM по статусам, источникам и магазинам, найдёт зависшие и посчитает выручку за период.

### Анализ повторных покупок
Агент сегментирует клиентов по частоте и давности покупок, найдёт уснувших постоянников и подготовит список для реактивации.

### Контроль просроченных задач
Агент проверит задачи менеджеров, выделит просроченные по заказам в работе и пришлёт список ответственным.

### Отмены и невыкупы
Агент разберёт отменённые и невыкупленные заказы за период, покажет их отдельно от выручки и назовёт магазины, где потери выше всего.

### Что на самом деле покупают
Агент сведёт состав заказов со справочником товаров и покажет, что берут чаще всего, а что лежит в каталоге без единой продажи за период.

### Правка карточки заказа
Агент перечитает карточку заказа и поставит новый статус или комментарий — если ключу разрешено изменение; иначе честно скажет, что остаётся читающим.

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

**Перед подключением**

- Права администратора в кабинете RetailCRM.
- Магазины, заказы которых нужны агенту, подключены в кабинете.

### Скопируйте поддомен из адреса кабинета
В «https://myshop.retailcrm.ru» поддомен — myshop, до первой точки, а «Домен аккаунта» — retailcrm.ru после неё. Иногда это retailcrm.pro.

### Откройте «Ключи доступа к API»
Шестерёнка настроек слева вверху → «Интеграция» → вкладка «Ключи доступа к API» → «Добавить». Значение ключа генерируется само, не короче 32 символов.

### Выдайте ключу доступ к нужным магазинам
В «Тип доступа» выберите «Доступ ко всем магазинам» либо отметьте нужные в поле «Магазины». По магазинам вне списка ключа заказы и клиенты не придут.

### Отметьте разрешённые методы и скопируйте ключ
В «Разрешённые методы API» включите заказы, клиентов, товары, справочники, задачи и пользователей, сохраните и скопируйте ключ.

## Частые вопросы

### Что нужно для подключения RetailCRM?
Адрес аккаунта — поддомен и домен, на котором открывается кабинет (retailcrm.ru или retailcrm.pro), — и API-ключ из «Настройки → Интеграция → Ключи доступа к API». Ключу можно выдать доступ только к нужным методам и магазинам.

### Какие данные агент читает?
Заказы, клиентов, товары, справочники, задачи и аналитику — по тем магазинам, к которым у ключа есть доступ.

### Можно ли ограничить доступ одним магазином?
Да, это настраивается прямо в RetailCRM на уровне API-ключа: агент увидит только выбранные магазины.

### Чем ИИ помогает интернет-магазину?
Считает заказы по статусам, источникам и магазинам с выручкой за период, отделяет отмены и невыкупы от кассы, сегментирует клиентов по частоте и давности покупок и поднимает уснувших постоянников, а по составу заказов показывает, что берут чаще всего и что лежит в каталоге без единой продажи.

[Открыть RetailCRM](https://www.retailcrm.ru)