Маркетплейсы и Авито

Все площадки подключаются в разделе «Интеграции», вкладка «Сервисы». Общие правила (виды подключения, статусы, «Только чтение», отключение) описаны на странице «Подключение сервисов», безопасные правки цен и остатков на странице «Как агент меняет данные». Здесь то, что у каждой площадки своё. Сценарии работы по каждой площадке собраны в каталоге маркетплейсов.

ПлощадкаКак подключаетсяЧто вставить
OzonВход через Ozon или ключ Seller APIНичего или «ID клиента» и «API-ключ»
WildberriesТокен из WB Partners«API-токен»
Яндекс МаркетКод подтверждения Яндекса или ключ APIНичего или «API-ключ»
АвитоКлючи из раздела «Интеграции» на Авито«ID клиента» и «Секрет клиента»
Мегамаркет, Kaspi.kz, Uzum MarketТокен из кабинета продавца«API-токен»

Ozon

Ozon Seller API: товары, заказы, остатки, цены, чаты, отзывы и аналитика продавца. Страница интеграции.

Что умеет агент

Читает товары, заказы, остатки и аналитику, отвечает в чатах и на отзывы, меняет цены, скидки и остатки, работает с поставками. Начисления и финансовые отчёты доступны только при подключении ключом с ролью «Финансы». Уведомления Ozon (новые отправления, отмены, сообщения в чатах) включаются сами при подключении, и по ним можно запускать задачи.

Что нужно заранее

Доступ в seller.ozon.ru с ролью «Администратор» или «Управляющий». У Ozon два способа подключения в одном окне: кнопка «Подключить через Ozon» и строка под ней «Другой способ подключения: Ozon Seller API (API-ключ)».

Вход через OzonКлюч Seller API
ПраваНабор Ozon для приложений: товары, заказы, остатки, чаты, отзывы, скидки, поставкиРоли, которые вы отметили при выпуске ключа
Финансы (начисления, финансовые отчёты)НетДа, с ролью «Финансы»
Один кабинет из двух мест (у коллеги, в другой организации)Нет: Ozon держит одно такое подключение на кабинетДа

Шаги

Вход через Ozon:

1

Войдите в seller.ozon.ru под нужной ролью

Выдать доступ приложению может только «Администратор» или «Управляющий». Другим ролям окно подтверждения Ozon не покажет.

2

Выберите компанию

Если на аккаунте несколько магазинов, Ozon попросит выбрать компанию: доступ выдаётся одному кабинету.

3

Проверьте права и нажмите «Разрешить»

Агент получит полный доступ, включая чаты, скидки и поставки. Оставить только чтение можно потом в карточке подключения, строка «Изменения».

Ключ с ролью «Финансы»:

1

Откройте форму ключа

В разделе «Интеграции» откройте Ozon и под кнопкой «Подключить через Ozon» нажмите «Ozon Seller API (API-ключ)». Откроется форма с полями «ID клиента» и «API-ключ».

2

Выпустите ключ в Ozon

На seller.ozon.ru откройте «Настройки» → «API-ключи» под Администратором или Управляющим и создайте ключ с нужными ролями.

3

Сразу скопируйте оба значения

Ozon показывает ключ один раз. Вставьте Client-Id в «ID клиента», Api-Key в «API-ключ» и только потом закройте окно Ozon.

Какие права выдать

Для начислений и финансовых отчётов нужна роль «Финансы». Подключение примет ключ с любой ролью, но агент увидит только то, что открывают отмеченные роли. Статистика рекламных кампаний идёт из отдельного рекламного API: это плитка «Ozon Реклама», о ней ниже.

Ограничения

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

Как отозвать доступ

  • Вход через Ozon: «Настройки» → «Приложения и разрешения» в кабинете Ozon.
  • Ключ Seller API: удалите ключ в «Настройки» → «API-ключи».

Кнопка «Отключить» у нас удаляет только наше подключение, доступ в кабинете Ozon после неё остаётся.

Неполадки

  • Нет финансовых данных: подключение сделано входом через Ozon или ключом без роли «Финансы». Подключите ключ с этой ролью через «Добавить ещё».
  • Уведомления не приходят: если их уже получает другая интеграция, например CRM, адрес не меняется, пока вы не нажмёте «Заменить адрес».

Ozon Реклама

Рекламный кабинет Ozon (Performance API): кампании, статистика, ставки и продвижение. Отдельная плитка в каталоге со своими ключами.

Что умеет агент

Читает кампании и их статистику, меняет ставки и настройки продвижения.

Шаги

1

Откройте Performance API

В кабинете Ozon Seller: «Настройки» → «Performance API».

2

Выберите или создайте сервисный аккаунт

Для разграничения доступа приложений создайте отдельный аккаунт.

3

Добавьте ключ и вставьте его

В сервисном аккаунте нажмите «Добавить ключ». Значения вставьте в поля «ID клиента рекламного кабинета» и «Секрет клиента».

Ограничения

Роли у рекламного ключа не выбираются. Ключ Seller API здесь не подходит, и наоборот.

Как отозвать доступ

Удалите ключ в сервисном аккаунте Performance API и нажмите «Отключить» в карточке «Ozon Реклама».

Неполадки

«Ключи не приняты»: проверьте, что вставлены ключи сервисного аккаунта Performance API, а не Seller API.

Wildberries

Wildberries API: товары, заказы, цены, остатки, реклама, отзывы и финансы продавца. Страница интеграции.

Что умеет агент

Считает продажи, остатки на своих складах и складах WB, юнит-экономику и расходы на рекламу, отвечает на отзывы и вопросы, пишет в чат покупателю, меняет цены. Wildberries не присылает события сторонним сервисам, поэтому новые отзывы, вопросы и заказы проверяет задача по расписанию.

Что нужно заранее

Учётная запись владельца кабинета на seller.wildberries.ru: выпускать и удалять API-токены может только он, другим ролям раздел не виден. Искать наш сервис в каталоге решений WB не нужно: токен типа «Сервисный» WB выдаёт только сервисам из этого каталога, нам нужен «Базовый».

Шаги

1

Откройте «Доступ к API»

Наведите курсор на имя продавца в правом верхнем углу: «Настройки» → «Доступ к API» → «Создать новый токен».

2

Создайте токен «Базовый»

На вкладке «Ручная интеграция» задайте имя и выберите тип «Базовый».

3

Отметьте десять категорий и «Чтение и запись»

Список и назначение категорий в таблице ниже.

4

Скопируйте токен и вставьте его

Токен показывается один раз. Вставьте его в поле «API-токен» в карточке Wildberries. Строка токена начинается с eyJ.

Какие права выдать

Подключение принимает токен только со всеми десятью категориями. Добавить категорию к выпущенному токену Wildberries не даёт, только выпустить новый, поэтому недостающие названы сразу при подключении, а не посреди задачи.

КатегорияДля чего агенту
Контенткарточки товаров, фото и видео
Аналитикаворонка продаж, отчёты по карточкам и остаткам
Цены и скидкичтение и изменение цен, скидки, акции
Маркетплейссборочные задания, свои склады и остатки на них
Статистикапродажи, заказы и остатки на складах WB
Продвижениерекламные кампании, ставки, расходы
Вопросы и отзывыответы покупателям, закрепление отзывов
Чат с покупателямипереписка с покупателем
Возвраты покупателямизаявки на возврат
Финансыотчёт о реализации: комиссии, логистика, хранение, выплаты

«Рекомендации», «Поставки» и «Документы» подключению не нужны. Доступ «Чтение и запись» нужен для ответов, цен и ставок. Если выпустить токен только на чтение, агент будет только читать, а на изменение ответит, что нужен токен с записью.

Ограничения

Срок жизни токена ограничивает Wildberries. Когда он истечёт, подключение получит статус «Ключи не приняты».

Как отозвать доступ

Удалите токен в том же разделе «Доступ к API» и нажмите «Отключить» в карточке Wildberries.

Неполадки

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

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

Кампании, заказы, товары, цены и остатки продавца. Страница интеграции.

Что умеет агент

Работает с товарами, ценами, остатками и заказами магазинов, к которым есть доступ у подключённого логина, и с событиями Маркета через уведомления.

Что нужно заранее

Логин Яндекса, который останется у бизнеса надолго: доступ выдаётся логину, а не кабинету, и смена пароля, двухфакторной защиты или восстановление логина обнуляет доступ.

Шаги

1

Пригласите логин в кабинет и дайте роль

Владелец приглашает логин на partner.market.yandex.ru и назначает роль по каждому магазину.

2

Подключите

Нажмите «Подключить», затем «Скопировать код и открыть», введите код на странице Яндекса этим логином и возвращайтесь: подключение подхватится само.

3

Выберите кабинет

Если логин видит несколько кабинетов, выберите «Кабинет Яндекс Маркета» и нажмите «Подключить кабинет».

4

Включите уведомления

Скопируйте «Адрес вебхука» из карточки подключения. В кабинете Маркета нажмите на название кабинета → «Настройки» → «API и модули» → «API-уведомления» → «Подключить уведомления», вставьте адрес, отметьте нужные события и сохраните.

Если вход через Яндекс не подошёл, в том же окне есть «Яндекс Маркет (API-ключ)»: на partner.market.yandex.ru откройте «Настройки» → «API и модули», выпустите статический ключ Partner API для нужных бизнесов и магазинов и вставьте его в поле «API-ключ».

Какие права выдать

Раздел «API и модули» видят роли «Администратор кабинета», «Менеджер кабинета», «Администратор магазина», «Разработчик» и «Оператор»; «Контент-менеджер» его не видит. События чатов в уведомлениях может включить только владелец или менеджер кабинета.

Ограничения

Агент видит только магазины, к которым у логина есть доступ. Уведомления Маркета сами не включаются, их подключают в кабинете Маркета.

Как отозвать доступ

Уберите логин из кабинета на partner.market.yandex.ru или удалите статический ключ в «API и модули», затем нажмите «Отключить» в карточке.

Неполадки

  • Подключение перестало работать после смены пароля логина: войдите заново кнопкой «Переподключить».
  • Нет событий: проверьте, что адрес вебхука вставлен в «API-уведомления» целиком и нужные события отмечены.

Авито

Объявления, статистика, мессенджер, отзывы и автозагрузка. Страница интеграции. Рекламный кабинет подключается отдельной плиткой «Авито Реклама», о ней на странице «Реклама».

Что умеет агент

Читает объявления и статистику, отвечает клиентам в мессенджере Авито, работает с отзывами. Через вебхук приходят события: новое сообщение, новый чат, новый отзыв, отзыв обновлён.

Отвечает клиентам задача, которая запускается по событию. В форме задачи выберите запуск «По событию», «Сервис» Авито, «Тип события» «новое сообщение» и в строке «Результат» отметьте «Ответ собеседнику». В тексте задачи опишите, на что отвечать сразу, что передавать вам и чего не обещать. Выключить ответы: откройте задачу и нажмите «Поставить на паузу» или удалите её.

Создай задачу по событию «новое сообщение» в Авито: отвечай клиенту в его чат. На вопросы о наличии и цене отвечай по объявлению, о доставке пиши, что уточним и напишем в течение дня. Торг, жалобы и всё, чего нет в объявлении, не обещай: оставь клиенту короткое «передам менеджеру» и сообщи мне.

Открыть в чате

Что нужно заранее

Платный тариф Авито на том аккаунте, где лежат объявления: персональные ключи Авито выдаёт только таким аккаунтам.

Шаги

1

Откройте раздел интеграций на Авито

«Управление профилем» → «Настройки» → «Интеграции», или сразу avito.ru/professionals/api.

2

Нажмите «Получить ключи»

Появятся Client ID и Client secret. Если пусто, обновите страницу через минуту: ключи создаются не сразу.

3

Вставьте обе строки

Client ID в «ID клиента», Client secret в «Секрет клиента». Вебхук Авито регистрируется сам при подключении.

Ограничения

Ключи действуют только для того аккаунта, где выданы: второй аккаунт подключается своими ключами. Ответ задачи не мгновенный: каждое новое сообщение запускает задачу, и ответ уходит, когда агент закончит. Несколько сообщений клиента подряд попадают в один ответ, сообщения разных клиентов обрабатываются параллельно. На отзывы так ответить нельзя: «Ответ собеседнику» доступен только для событий с чатом.

Как отозвать доступ

Нажмите «Отключить» в карточке Авито. Ключи выдаёт раздел «Интеграции» профиля Авито, проверять и менять их нужно там.

Неполадки

  • «Не получает сообщения»: регистрация вебхука на Авито не прошла. Нажмите «Проверить снова». Если после этого статус «Ключи не приняты», проверьте ключи на Авито и введите их заново.
  • «Занят другим сервисом»: сообщения аккаунта уже уходят в другую интеграцию. «Заменить адрес» забирает их сюда, и та интеграция перестаёт их получать.

Мегамаркет

Товары, заказы, остатки, цены, FBO-поставки, DBS-доставка и отчёты. Страница интеграции.

Что нужно заранее

Учётная запись с правами администратора кабинета на partner.megamarket.ru: у пользователя с урезанными правами раздел с API не отображается.

Шаги

1

Откройте «Интеграция по API»

На partner.megamarket.ru: «Настройки» → «Интеграция по API».

2

Скопируйте «Авторизационный токен»

Возьмите токен рабочей среды кабинета и вставьте его в поле «API-токен».

Ограничения

Если пункта «Интеграция по API» нет, кабинет работает по FBO без API или не хватает прав: доступ включает поддержка Мегамаркета в чате.

Как отозвать доступ

Нажмите «Отключить» в карточке. Токен выдаёт страница «Интеграция по API» кабинета Мегамаркета, проверять и менять его нужно там.

Неполадки

«Ключи не приняты»: для тестовой и рабочей среды токены разные, тестовый на рабочих запросах не принимается.

Kaspi.kz

Казахстан: заказы, товары, отзывы, города и точки выдачи. Страница интеграции.

Что нужно заранее

Учётная запись руководителя компании в кабинете kaspi.kz/mc в браузере: токен выдаётся только руководителю, в мобильном приложении раздела с токеном нет.

Шаги

1

Откройте «Токен API»

В кабинете kaspi.kz/mc: «Настройки» → «Токен API».

2

Нажмите «Сформировать» и скопируйте

Вставьте токен в поле «API-токен».

Как отозвать доступ

Нажмите «Отключить» в карточке. Токен выдаёт страница «Токен API» кабинета Kaspi, проверять и менять его нужно там.

Неполадки

Нет пункта «Токен API»: вы вошли сотрудником, а не руководителем. Попросите руководителя выпустить токен.

Uzum Market

Uzum Market Seller API: товары, заказы, остатки и финансы продавца. Страница интеграции.

Что нужно заранее

Аккаунт на seller.uzum.uz, на который зарегистрирован магазин, с правами на настройки, и активный магазин.

Шаги

1

Выпустите токен Seller API

В настройках профиля откройте раздел API и интеграций и выпустите токен.

2

Скопируйте токен сразу

Вставьте строку в поле «API-токен» без слова Bearer и пробелов по краям. Прежний токен восстановить нельзя.

Как отозвать доступ

Нажмите «Отключить» в карточке и отзовите токен в разделе API и интеграций профиля Uzum.

Неполадки

Агент не видит заказов: без активного магазина список магазинов аккаунта пуст.

Несколько магазинов и кабинетов

Каждый магазин или кабинет подключается отдельно: откройте подключённую площадку и нажмите «Добавить ещё».

  • Ozon: при входе через Ozon выберите другую компанию или вставьте ключ из кабинета второго магазина.
  • Wildberries: токен выпускается в кабинете каждого продавца.
  • Яндекс Маркет: один логин может видеть несколько кабинетов, тогда в карточке есть строка «Кабинет по умолчанию»; другой кабинет агент берёт, если вы назвали его в запросе.
  • Авито: второй аккаунт подключается своими ключами.

В запросе называйте магазин словами: «по кабинету „Основной“ на Ozon». Одна задача по расписанию на один кабинет: так у каждой своя история запусков, подробнее в разделе «Задачи».

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

Куда вставить ключ Ozon с ролью «Финансы»?

В разделе «Интеграции» откройте Ozon. Под кнопкой «Подключить через Ozon» есть строка «Другой способ подключения: Ozon Seller API (API-ключ)». Нажмите её: откроется форма с полями «ID клиента» и «API-ключ». Финансы открывает только ключ, вход через Ozon их не даёт.

В каталоге решений Wildberries нет вашего сервиса. Как подключить?

Искать нас в каталоге WB не нужно. Выпустите в WB Partners токен типа «Базовый» на вкладке «Ручная интеграция» и вставьте его в поле «API-токен» в карточке Wildberries в разделе «Интеграции».

Зачем токену Wildberries все десять категорий?

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

Можно подключить второй магазин Ozon в тот же аккаунт?

Да. Откройте подключённый Ozon и нажмите «Добавить ещё». Каждый магазин подключается отдельно: через вход в Ozon выберите другую компанию или вставьте ключ из кабинета второго магазина.

Авито пишет «Не получает сообщения». Что делать?

Регистрация вебхука на Авито не прошла, и новые сообщения к нам не приходят. Нажмите «Проверить снова» в карточке Авито. Если статус «Занят другим сервисом», сообщения уходят в другую интеграцию: заберите их кнопкой «Заменить адрес».

Как включить и выключить ответы клиентам на Авито?

Ответы включает задача «По событию»: сервис Авито, событие «новое сообщение», результат «Ответ собеседнику». Выключить ответы: в этой задаче нажмите «Поставить на паузу» или удалите её.

Смотрите также

Была ли страница полезна?

Не нашли ответ? Как связаться