Маркетплейсы и Авито
Все площадки подключаются в разделе «Интеграции», вкладка «Сервисы». Общие правила (виды подключения, статусы, «Только чтение», отключение) описаны на странице «Подключение сервисов», безопасные правки цен и остатков на странице «Как агент меняет данные». Здесь то, что у каждой площадки своё. Сценарии работы по каждой площадке собраны в каталоге маркетплейсов.
| Площадка | Как подключается | Что вставить |
|---|---|---|
| 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:
Войдите в seller.ozon.ru под нужной ролью
Выдать доступ приложению может только «Администратор» или «Управляющий». Другим ролям окно подтверждения Ozon не покажет.
Выберите компанию
Если на аккаунте несколько магазинов, Ozon попросит выбрать компанию: доступ выдаётся одному кабинету.
Проверьте права и нажмите «Разрешить»
Агент получит полный доступ, включая чаты, скидки и поставки. Оставить только чтение можно потом в карточке подключения, строка «Изменения».
Ключ с ролью «Финансы»:
Откройте форму ключа
В разделе «Интеграции» откройте Ozon и под кнопкой «Подключить через Ozon» нажмите «Ozon Seller API (API-ключ)». Откроется форма с полями «ID клиента» и «API-ключ».
Выпустите ключ в Ozon
На seller.ozon.ru откройте «Настройки» → «API-ключи» под Администратором или Управляющим и создайте ключ с нужными ролями.
Сразу скопируйте оба значения
Ozon показывает ключ один раз. Вставьте Client-Id в «ID клиента», Api-Key в «API-ключ» и только потом закройте окно Ozon.
Какие права выдать
Для начислений и финансовых отчётов нужна роль «Финансы». Подключение примет ключ с любой ролью, но агент увидит только то, что открывают отмеченные роли. Статистика рекламных кампаний идёт из отдельного рекламного API: это плитка «Ozon Реклама», о ней ниже.
Ограничения
Если кабинет уже подключён входом через Ozon у коллеги или в другой организации, там подключение перестанет работать и получит статус «Доступ у другого подключения». Чтобы работать с кабинетом из двух мест, подключите его ключом.
Как отозвать доступ
- Вход через Ozon: «Настройки» → «Приложения и разрешения» в кабинете Ozon.
- Ключ Seller API: удалите ключ в «Настройки» → «API-ключи».
Кнопка «Отключить» у нас удаляет только наше подключение, доступ в кабинете Ozon после неё остаётся.
Неполадки
- Нет финансовых данных: подключение сделано входом через Ozon или ключом без роли «Финансы». Подключите ключ с этой ролью через «Добавить ещё».
- Уведомления не приходят: если их уже получает другая интеграция, например CRM, адрес не меняется, пока вы не нажмёте «Заменить адрес».
Ozon Реклама
Рекламный кабинет Ozon (Performance API): кампании, статистика, ставки и продвижение. Отдельная плитка в каталоге со своими ключами.
Что умеет агент
Читает кампании и их статистику, меняет ставки и настройки продвижения.
Шаги
Откройте Performance API
В кабинете Ozon Seller: «Настройки» → «Performance API».
Выберите или создайте сервисный аккаунт
Для разграничения доступа приложений создайте отдельный аккаунт.
Добавьте ключ и вставьте его
В сервисном аккаунте нажмите «Добавить ключ». Значения вставьте в поля «ID клиента рекламного кабинета» и «Секрет клиента».
Ограничения
Роли у рекламного ключа не выбираются. Ключ Seller API здесь не подходит, и наоборот.
Как отозвать доступ
Удалите ключ в сервисном аккаунте Performance API и нажмите «Отключить» в карточке «Ozon Реклама».
Неполадки
«Ключи не приняты»: проверьте, что вставлены ключи сервисного аккаунта Performance API, а не Seller API.
Wildberries
Wildberries API: товары, заказы, цены, остатки, реклама, отзывы и финансы продавца. Страница интеграции.
Что умеет агент
Считает продажи, остатки на своих складах и складах WB, юнит-экономику и расходы на рекламу, отвечает на отзывы и вопросы, пишет в чат покупателю, меняет цены. Wildberries не присылает события сторонним сервисам, поэтому новые отзывы, вопросы и заказы проверяет задача по расписанию.
Что нужно заранее
Учётная запись владельца кабинета на seller.wildberries.ru: выпускать и удалять API-токены может только он, другим ролям раздел не виден. Искать наш сервис в каталоге решений WB не нужно: токен типа «Сервисный» WB выдаёт только сервисам из этого каталога, нам нужен «Базовый».
Шаги
Откройте «Доступ к API»
Наведите курсор на имя продавца в правом верхнем углу: «Настройки» → «Доступ к API» → «Создать новый токен».
Создайте токен «Базовый»
На вкладке «Ручная интеграция» задайте имя и выберите тип «Базовый».
Отметьте десять категорий и «Чтение и запись»
Список и назначение категорий в таблице ниже.
Скопируйте токен и вставьте его
Токен показывается один раз. Вставьте его в поле «API-токен» в карточке Wildberries. Строка токена начинается с eyJ.
Какие права выдать
Подключение принимает токен только со всеми десятью категориями. Добавить категорию к выпущенному токену Wildberries не даёт, только выпустить новый, поэтому недостающие названы сразу при подключении, а не посреди задачи.
| Категория | Для чего агенту |
|---|---|
| Контент | карточки товаров, фото и видео |
| Аналитика | воронка продаж, отчёты по карточкам и остаткам |
| Цены и скидки | чтение и изменение цен, скидки, акции |
| Маркетплейс | сборочные задания, свои склады и остатки на них |
| Статистика | продажи, заказы и остатки на складах WB |
| Продвижение | рекламные кампании, ставки, расходы |
| Вопросы и отзывы | ответы покупателям, закрепление отзывов |
| Чат с покупателями | переписка с покупателем |
| Возвраты покупателями | заявки на возврат |
| Финансы | отчёт о реализации: комиссии, логистика, хранение, выплаты |
«Рекомендации», «Поставки» и «Документы» подключению не нужны. Доступ «Чтение и запись» нужен для ответов, цен и ставок. Если выпустить токен только на чтение, агент будет только читать, а на изменение ответит, что нужен токен с записью.
Ограничения
Срок жизни токена ограничивает Wildberries. Когда он истечёт, подключение получит статус «Ключи не приняты».
Как отозвать доступ
Удалите токен в том же разделе «Доступ к API» и нажмите «Отключить» в карточке Wildberries.
Неполадки
- Токен не принимается при подключении: в отказе названы категории, которых не хватает. Выпустите новый токен со всеми десятью.
- «Ключи не приняты» у работавшего подключения: срок токена истёк или его удалили. Выпустите новый токен и нажмите «Ввести ключи заново».
Яндекс Маркет
Кампании, заказы, товары, цены и остатки продавца. Страница интеграции.
Что умеет агент
Работает с товарами, ценами, остатками и заказами магазинов, к которым есть доступ у подключённого логина, и с событиями Маркета через уведомления.
Что нужно заранее
Логин Яндекса, который останется у бизнеса надолго: доступ выдаётся логину, а не кабинету, и смена пароля, двухфакторной защиты или восстановление логина обнуляет доступ.
Шаги
Пригласите логин в кабинет и дайте роль
Владелец приглашает логин на partner.market.yandex.ru и назначает роль по каждому магазину.
Подключите
Нажмите «Подключить», затем «Скопировать код и открыть», введите код на странице Яндекса этим логином и возвращайтесь: подключение подхватится само.
Выберите кабинет
Если логин видит несколько кабинетов, выберите «Кабинет Яндекс Маркета» и нажмите «Подключить кабинет».
Включите уведомления
Скопируйте «Адрес вебхука» из карточки подключения. В кабинете Маркета нажмите на название кабинета → «Настройки» → «API и модули» → «API-уведомления» → «Подключить уведомления», вставьте адрес, отметьте нужные события и сохраните.
Если вход через Яндекс не подошёл, в том же окне есть «Яндекс Маркет (API-ключ)»: на partner.market.yandex.ru откройте «Настройки» → «API и модули», выпустите статический ключ Partner API для нужных бизнесов и магазинов и вставьте его в поле «API-ключ».
Какие права выдать
Раздел «API и модули» видят роли «Администратор кабинета», «Менеджер кабинета», «Администратор магазина», «Разработчик» и «Оператор»; «Контент-менеджер» его не видит. События чатов в уведомлениях может включить только владелец или менеджер кабинета.
Ограничения
Агент видит только магазины, к которым у логина есть доступ. Уведомления Маркета сами не включаются, их подключают в кабинете Маркета.
Как отозвать доступ
Уберите логин из кабинета на partner.market.yandex.ru или удалите статический ключ в «API и модули», затем нажмите «Отключить» в карточке.
Неполадки
- Подключение перестало работать после смены пароля логина: войдите заново кнопкой «Переподключить».
- Нет событий: проверьте, что адрес вебхука вставлен в «API-уведомления» целиком и нужные события отмечены.
Авито
Объявления, статистика, мессенджер, отзывы и автозагрузка. Страница интеграции. Рекламный кабинет подключается отдельной плиткой «Авито Реклама», о ней на странице «Реклама».
Что умеет агент
Читает объявления и статистику, отвечает клиентам в мессенджере Авито, работает с отзывами. Через вебхук приходят события: новое сообщение, новый чат, новый отзыв, отзыв обновлён.
Отвечает клиентам задача, которая запускается по событию. В форме задачи выберите запуск «По событию», «Сервис» Авито, «Тип события» «новое сообщение» и в строке «Результат» отметьте «Ответ собеседнику». В тексте задачи опишите, на что отвечать сразу, что передавать вам и чего не обещать. Выключить ответы: откройте задачу и нажмите «Поставить на паузу» или удалите её.
Создай задачу по событию «новое сообщение» в Авито: отвечай клиенту в его чат. На вопросы о наличии и цене отвечай по объявлению, о доставке пиши, что уточним и напишем в течение дня. Торг, жалобы и всё, чего нет в объявлении, не обещай: оставь клиенту короткое «передам менеджеру» и сообщи мне.
Что нужно заранее
Платный тариф Авито на том аккаунте, где лежат объявления: персональные ключи Авито выдаёт только таким аккаунтам.
Шаги
Откройте раздел интеграций на Авито
«Управление профилем» → «Настройки» → «Интеграции», или сразу avito.ru/professionals/api.
Нажмите «Получить ключи»
Появятся Client ID и Client secret. Если пусто, обновите страницу через минуту: ключи создаются не сразу.
Вставьте обе строки
Client ID в «ID клиента», Client secret в «Секрет клиента». Вебхук Авито регистрируется сам при подключении.
Ограничения
Ключи действуют только для того аккаунта, где выданы: второй аккаунт подключается своими ключами. Ответ задачи не мгновенный: каждое новое сообщение запускает задачу, и ответ уходит, когда агент закончит. Несколько сообщений клиента подряд попадают в один ответ, сообщения разных клиентов обрабатываются параллельно. На отзывы так ответить нельзя: «Ответ собеседнику» доступен только для событий с чатом.
Как отозвать доступ
Нажмите «Отключить» в карточке Авито. Ключи выдаёт раздел «Интеграции» профиля Авито, проверять и менять их нужно там.
Неполадки
- «Не получает сообщения»: регистрация вебхука на Авито не прошла. Нажмите «Проверить снова». Если после этого статус «Ключи не приняты», проверьте ключи на Авито и введите их заново.
- «Занят другим сервисом»: сообщения аккаунта уже уходят в другую интеграцию. «Заменить адрес» забирает их сюда, и та интеграция перестаёт их получать.
Мегамаркет
Товары, заказы, остатки, цены, FBO-поставки, DBS-доставка и отчёты. Страница интеграции.
Что нужно заранее
Учётная запись с правами администратора кабинета на partner.megamarket.ru: у пользователя с урезанными правами раздел с API не отображается.
Шаги
Откройте «Интеграция по API»
На partner.megamarket.ru: «Настройки» → «Интеграция по API».
Скопируйте «Авторизационный токен»
Возьмите токен рабочей среды кабинета и вставьте его в поле «API-токен».
Ограничения
Если пункта «Интеграция по API» нет, кабинет работает по FBO без API или не хватает прав: доступ включает поддержка Мегамаркета в чате.
Как отозвать доступ
Нажмите «Отключить» в карточке. Токен выдаёт страница «Интеграция по API» кабинета Мегамаркета, проверять и менять его нужно там.
Неполадки
«Ключи не приняты»: для тестовой и рабочей среды токены разные, тестовый на рабочих запросах не принимается.
Kaspi.kz
Казахстан: заказы, товары, отзывы, города и точки выдачи. Страница интеграции.
Что нужно заранее
Учётная запись руководителя компании в кабинете kaspi.kz/mc в браузере: токен выдаётся только руководителю, в мобильном приложении раздела с токеном нет.
Шаги
Откройте «Токен API»
В кабинете kaspi.kz/mc: «Настройки» → «Токен API».
Нажмите «Сформировать» и скопируйте
Вставьте токен в поле «API-токен».
Как отозвать доступ
Нажмите «Отключить» в карточке. Токен выдаёт страница «Токен API» кабинета Kaspi, проверять и менять его нужно там.
Неполадки
Нет пункта «Токен API»: вы вошли сотрудником, а не руководителем. Попросите руководителя выпустить токен.
Uzum Market
Uzum Market Seller API: товары, заказы, остатки и финансы продавца. Страница интеграции.
Что нужно заранее
Аккаунт на seller.uzum.uz, на который зарегистрирован магазин, с правами на настройки, и активный магазин.
Шаги
Выпустите токен Seller API
В настройках профиля откройте раздел API и интеграций и выпустите токен.
Скопируйте токен сразу
Вставьте строку в поле «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 выберите другую компанию или вставьте ключ из кабинета второго магазина.
Авито пишет «Не получает сообщения». Что делать?
Регистрация вебхука на Авито не прошла, и новые сообщения к нам не приходят. Нажмите «Проверить снова» в карточке Авито. Если статус «Занят другим сервисом», сообщения уходят в другую интеграцию: заберите их кнопкой «Заменить адрес».
Как включить и выключить ответы клиентам на Авито?
Ответы включает задача «По событию»: сервис Авито, событие «новое сообщение», результат «Ответ собеседнику». Выключить ответы: в этой задаче нажмите «Поставить на паузу» или удалите её.
Смотрите также
Не нашли ответ? Как связаться