AdvantShop: ИИ-агент для заказов и КП

AdvantShop — платформа для интернет-магазина с публичным описанием API. Агент нужен отделу продаж магазина, где заказы, покупатели и корзины живут в админке, а письма и предложения пишутся вручную.

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

Три признака: работает в ваших сервисах, доводит до результата, работает без вас. Пока менеджер на встрече, заявки уже разобраны и разложены по воронке.

Коннектор — описание подключения: где взять ключ, как проверить связь и какие данные открыты. Не плагин и не доработка магазина: вы генерируете ключ в админке, и на этом установка заканчивается.

Пароль коннектор не хранит, в чужие руки не передаёт и работает только в рамках выданного ключа. Ключ отозван — доступ закрыт.

В описании API платформы, актуальном для версии магазина 15.0, два контура. Server API закрывает лиды, заказы, покупателей, менеджеров, группы покупателей, бонусную систему, грейды, категории, изображения и уведомления. Client API с авторизацией работает с покупателем, его контактами, заказом, каталогом, товаром, корзиной, купоном и оформлением заказа. Ответы постраничные: в них есть count, currentPage и totalCount, а параметр extended=true добавляет поля. Ключи генерируются в админке магазина.

### Заявки из личных сообщений: разбор и учёт

Агент читает обращение, вытаскивает контакт, товар и город, ищет покупателя по контактам через Client API и проверяет, нет ли уже открытого заказа. Дальше создаёт лид в Server API, подставляя найденные значения, и помечает поля, которых в сообщении не было. По правилам метода нужно хотя бы одно из полей: имя, почта или телефон; артикул товара должен существовать в магазине. Менеджеру отдаёт карточку с цитатой и списком незаполненного.

### КП в день запроса: зависшие сделки и письма

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

### КП из прайса: смета и письмо за один заход

Агент берёт товары из каталога, сверяет артикулы и единицы, считает смету и пишет текст предложения. Позицию, которой нет в каталоге, показывает отдельно, а не подставляет ближайшую. Итог — черновик письма и таблица позиций.

Скидка, окончательные условия и отправка — за менеджером. Агент не меняет статусы заказов без подтверждения и не правит прайс в каталоге.

В админке магазина открывается раздел «Настройки — API», где на вкладках «API» и «API с авторизацией» кнопкой «Сгенерировать новый api ключ» создаётся ключ; готовый виден в поле «API ключ». Дальше ключ передаётся агенту. Достаточно ключа, списка товаров и периода выгрузки.

Не оформляет заказ за клиента и не проводит оплату. Не меняет настройки магазина. Не удаляет заказы и покупателей — только читает и создаёт черновики там, где это разрешено ключом.

Что такое агент, если коротко? Программа, которая выполняет работу до результата: находит, проверяет и приносит готовые данные, а не совет.

Что такое коннектор? Описание подключения: где взять ключ, как проверить связь, какие данные доступны. Ключ выдаёте вы и можете отозвать.

Чем Server API отличается от Client API? Server API работает с внутренними объектами магазина: лидами, заказами, покупателями, менеджерами. Client API с авторизацией — с тем, что видит покупатель: каталог, корзина, купон, оформление.