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