Работа с GGsel

Lovsel подключается к магазину GGsel через официальный Seller API. Заказы, переписка, товары и автоматизация GGsel работают в кабинете рядом с другими площадками. Чтобы видеть только GGsel, выберите его в переключателе площадок вверху кабинета. Коротко о возможностях — на странице «Автоматизация GGsel».

Подключение

1. Войдите в Lovsel, выберите площадку GGsel в переключателе вверху и откройте раздел «Подключение».
2. Укажите email продавца GGsel или числовой ID магазина (Seller ID).
3. Вставьте API-ключ: кабинет продавца GGsel → «Настройки» → «API».
4. Нажмите «Подключить GGsel».

Lovsel сразу проверяет данные двумя настоящими запросами к GGsel: доступ к магазину и к истории продаж. Если ключ не подошёл, он не сохраняется, а кабинет показывает причину. После подключения загружаются заказы, и запускается автоматизация.

• API-ключ хранится только на сервере Lovsel. В кабинете он показывается скрытым (••••••••abcd), плагины его не получают.
• Кнопка «Проверить» на странице подключения повторяет проверку и показывает баланс продавца.
• «Отключить» удаляет ключ с сервера. Правила автоматизации, склад и история заказов сохраняются.

Пошагово, с ответами на частые ошибки, — в инструкции «Подключение GGsel».

Заказы

Раздел «Заказы» — продажи магазина: номер, товар, покупатель, сумма в валюте заказа, статус и дата. Статусы и подробности берутся из purchase/info — это тот же источник, что и кабинет GGsel.

• Поиск по номеру заказа, товару и покупателю, фильтры по статусам, пагинация 10/20/50/100.
• Карточка заказа: поля покупателя, варианты товара, история событий заказа и переписка.
• Выдать вручную — отправить покупателю товар из склада автовыдачи в диалог заказа, если автоматическая выдача не сработала.
• Проверить уникальный код — проверка кода покупки, который прислал покупатель.
• Ссылки «Открыть в GGsel» ведут в нужный раздел кабинета GGsel.
• История заказов накапливается в Lovsel с момента подключения, поэтому аналитика не ограничена последними продажами из API.

Подтверждение, отмена и возврат заказа в Seller API не предусмотрены — их выполняют в кабинете GGsel.

Сообщения

Сообщения покупателей GGsel приходят в центр событий: карточка показывает покупателя, товар, заказ и текст. Переписка загружается только для открытого заказа, поэтому лента работает быстро.

• Ответить можно прямо из ветки заказа; есть быстрые ответы по шаблонам.
• Ветка, в которой вы ответили, отмечается обработанной.

Товары

Раздел «Товары» — объявления магазина: цена в валюте оффера, остаток, статус публикации, продажи и выручка по истории Lovsel. Список поддерживает пагинацию, сортировки, поиск и фильтры «В продаже» и «Снятые».

В карточке товара можно изменить:

• цену (в валюте оффера);
• остаток или «без ограничений»;
• название, описание и инструкцию для покупателя;
• минимальное и максимальное количество в одном заказе.

Также доступны публикация, снятие с продажи и удаление объявления. Эти действия GGsel выполняет асинхронно: принимает задачу и применяет её через несколько секунд — статус в списке обновится после обработки. Изменение скидочной цены Seller API не поддерживает.

Автоматизация

Автоматизация GGsel работает на сервере круглосуточно, пока активна подписка.

Автоответы

Правило — ключевые слова и текст ответа. Если сообщение покупателя содержит ключевое слово, Lovsel отвечает текстом правила. Правило можно ограничить конкретными товарами (ID объявлений) и временно выключить.

Автовыдача

Правило автовыдачи связывает товар со складом:

• товар выбирается по ID объявления или по ключевым словам в названии;
• конечный склад — список строк (ключи, коды, ссылки): одна строка — одна выдача. Склад пополняется текстом или файлом .txt, строки можно заменить целиком;
• бесконечная выдача — один и тот же текст для каждого покупателя (например, инструкция или ссылка);
• порог низкого остатка — когда строк остаётся меньше порога, приходит предупреждение. После пополнения предупреждение снова включается.

Выданный товар уходит покупателю в диалог заказа. Если склад пуст, в центре событий появляется карточка «Требует внимания» — товар можно выдать вручную из карточки заказа.

Как создать правило, заполнить склад и выдать товар вручную — в инструкции «Автовыдача на GGsel».

Приветствие

Текст, который получает покупатель, впервые написавший в диалог. {name} в тексте заменяется именем покупателя. Приветствие можно выключить, не удаляя текст.

Отзывы и отчёты

• Ответы на отзывы — свой текст для каждой оценки от 1 до 5 звёзд. Seller API не позволяет публиковать ответ под отзывом, поэтому текст отправляется покупателю в чат заказа, а уведомление приходит вам.
• Запрос отзыва — сообщение покупателю через заданное число минут после того, как заказ выполнен.
• Ежедневный отчёт — сводка за день в Telegram и центр событий в выбранный час.

События

В центр событий с отметкой GGsel попадают:

Какие события приходят в Telegram, настраивается в «Настройках → Уведомления».

Аналитика

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

Ограничения Seller API

• Нет подтверждения, отмены и возврата заказа — это делается в кабинете GGsel.
• Нет изменения скидочной цены.
• Нет публикации ответа под отзывом — ответ уходит в чат заказа.
• Баланс продавца возвращается в WMT (эквивалент доллара США).
• Изменения товаров применяются асинхронно, через несколько секунд.

Если что-то не работает

• Ключ не принят — проверьте, что API включён в кабинете GGsel, ключ скопирован целиком и не был перевыпущен. После перевыпуска ключа подключите GGsel заново.
• Не приходят новые заказы — откройте «Подключение» и нажмите «Проверить». Автоматизация работает только при активной подписке.
• Автовыдача не сработала — проверьте, что правило включено, склад не пуст, а товар выбран по ID или ключевому слову из названия. Выдайте товар вручную из карточки заказа.
• Не помогло — напишите в поддержку и приложите текст ошибки из кабинета. Ключи присылать не нужно.

Плагины для GGsel и их API — на странице «Плагины для GGsel».