Подключение Wildberries, Ozon и Яндекс Маркета к ИИ-боту

Маркетплейсы дают две разные вещи: товары - чтобы бот знал ваш ассортимент, и отзывы с вопросами - чтобы отвечать на них.

Прочитайте это до того, как пойдёте выпускать ключи. Ни токен Wildberries, ни ключ Ozon после выпуска не переделываются: отмеченные доступы к ним не добавляются, промахнулись - нужно выпускать новый. У Яндекс Маркета проще: доступы у выпущенного ключа меняются. Пять минут чтения экономят второй заход в кабинет площадки.

Wildberries

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

Галочку «Только на чтение» снимите. Чтением обходятся товары, а чтобы бот публиковал ответы под карточками, нужна запись: иначе ответы будут готовиться и ждать вас в кабинете, но наружу не уйдут.

Этот же ключ вставляется в единственное поле на экране Wildberries. Отдельного поля для отзывов больше нет - товары и отзывы это одно подключение.

Есть и третья категория - «Чат с покупателями». Отметьте и её, если хотите получать переписку с покупателями в «Диалоги»: чаты включаются на экране Wildberries отдельным выключателем. Отмечайте сразу: у выпущенного токена Wildberries категории не добавляются, для новой пришлось бы выпускать новый ключ.

Тип токена решает, насколько быстро всё будет работать

При выпуске Wildberries спрашивает тип токена. Это не формальность - от него зависит скорость в тысячи раз.

Базовый - пять запросов в час на весь аккаунт продавца. Сорок ответов уходят почти сутки.
Персональный - три запроса в секунду. Те же сорок ответов уходят за минуту.

У Базового лимит общий на весь ваш аккаунт продавца: в него укладываемся и мы, и другие ваши сервисы, и ваш собственный кабинет. Причём одно и то же окно тратится и на чтение отзывов, и на публикацию ответов - поэтому пока разгребается очередь, новые отзывы приезжают реже.

Про Персональный токен мы обязаны сказать прямо

Wildberries пишет о нём так: предназначен для собственных систем продавца, передача сторонним сервисам и приложениям запрещена, а токен, использованный в интеграции со сторонним сервисом, может быть отозван.

Мы - сторонний сервис. Это значит, что риск существует и что он ваш: отзовут не наш доступ, а ваш токен, и вместе с нами остановится всё, что этим ключом ходит в ваш кабинет.

Мы не уговариваем и не отговариваем: решение ваше, и мы просто не хотим, чтобы вы узнали об этом от площадки, а не от нас. На Базовом токене сервис работает и будет работать - просто медленнее.

Как поменять тип токена, если решили

Старый ключ удалять не нужно, настройки кабинета сохранятся - порог звёзд, автоответы, обучение. Меняется только ключ.

Выпустите в кабинете продавца новый токен нужного типа. Категории те же: «Контент» и «Вопросы и отзывы», галочку «Только на чтение» снять.
У нас: «Подключения» - Wildberries - в строке нужного кабинета нажать «Заменить ключ».
Вставить новый токен и сохранить.

Важно нажать именно «Заменить ключ», а не «+ Добавить кабинет». У Wildberries магазин нельзя опознать по токену - он непрозрачен, - поэтому кабинеты различаются только названием, которое дали вы. Кнопка «Заменить ключ» подставляет название сама, и ключ ложится в тот же кабинет. А «Добавить кабинет» с новым ключом и другим названием заведёт второй кабинет того же магазина: мы начнём ходить на площадку двумя ключами по очереди, деля одно и то же окно продавца, и станет медленнее, а не быстрее.

Скорость сервис определит сам: он смотрит, что площадка отвечает в заголовках, и подстраивает темп. Ничего переключать руками не нужно, а первые несколько минут после замены он ещё будет работать в прежнем ритме - пока не сделает первый запрос новым ключом.

Что из этого следует на практике на Базовом токене: отзывы приезжают порциями раз в двенадцать-пятнадцать минут, а не мгновенно, и массовая публикация идёт очередью. Если отзывы совсем перестали приходить - проверьте, не ходит ли этим же аккаунтом продавца другой сервис: окно у всех одно. На Персональном токене ни того, ни другого нет.

Маркетплейсы — Экран Wildberries: один ключ на товары, отзывы и вопросы.

Ozon

У Ozon два способа подключения, и они прямо так и подписаны на экране кабинета - «Вариант 1» и «Вариант 2».

Вариант 1 - через кабинет Ozon. Ключи не нужны. Нажимаете «Подключить через Ozon», в открывшейся вкладке выбираете магазин и подтверждаете доступ - и всё. Ничего не нужно выпускать, копировать и вставлять, и негде ошибиться с ролями: мы запрашиваем ровно те, что нужны для отзывов, вопросов, чатов и чтения товаров. Доступ вы в любой момент отзываете у себя в Ozon.

Если Ozon предложит выбрать магазин - выберите тот, чьи отзывы должен вести бот. У одного аккаунта продавца магазинов бывает несколько, и доступ выдаётся тому, который вы выбрали. Второй магазин подключается так же, отдельным кабинетом.

Вариант 2 - ключом Seller API. Прежний способ, он никуда не делся и работает по-прежнему.

Нужны Client-Id и Api-Key из раздела «Настройки - Seller API» в кабинете продавца. Пара одна и на товары, и на отзывы, но при создании ключа важно отметить роли: Product для товаров, Review для отзывов, Question для вопросов покупателей.

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

Api-Key показывается один раз - при создании. Не скопировали сразу, значит нужен новый ключ: посмотреть старый в кабинете нельзя.

Есть и роль Chat - переписка с покупателями. Отметьте и её, если хотите получать чаты в «Диалоги»: включаются они на экране Ozon отдельным выключателем. Подписка для чатов не нужна. Бывает и ключ «только чат» - роль Chat без остальных: он подключается, но товары и отзывы им не читаются, и экран честно об этом скажет.

Вопросы покупателей работают на подписке Premium Plus. Отзывы на ней недоступны - для них нужна Premium Pro либо отдельная подписка «Управление отзывами», она заводится сама по себе и стоит процент с проданного. Без подписки товары и вопросы приедут, а отзывы вернутся отказом - мы покажем это словами, а не пустой лентой.

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

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

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

Номер кабинета вводить не нужно - мы спросим его у Маркета сами тем же ключом и покажем название кабинета на экране, чтобы вы убедились, что подключили тот.

Включать API отдельно не нужно. Выпустили ключ - он работает: у Маркета нет галочки «разрешить API», которую надо не забыть поставить. Доступ бывает закрыт, но только если у магазина что-то не так: нет действующего договора с Маркетом, не выбрана программа размещения, магазин больше 90 дней не размещал товары или интеграцию выключили вручную. Мы назовём причину словами, каждую свою; её же видно в кабинете продавца в разделе «API и модули».

Доступ к API Маркета бесплатный: отдельной подписки, чтобы читать отзывы и вопросы, здесь не требуется. Это главное отличие от Ozon.

Второе отличие - лимит. Маркет пускает к отзывам тысячи раз в час, а не раз в двенадцать минут, как Wildberries. Поэтому отзывы приезжают целиком, а не порциями, и очереди на публикацию здесь нет.

Третье - ответ обратим. Ответ под отзывом и ответ на вопрос на Маркете можно удалить в кабинете продавца. Подтверждение перед публикацией мы всё равно спрашиваем: пока ответ висит, его читают.

Ещё Маркет отмечает отзывы, написанные за баллы. Такие записи мы помечаем в ленте - это не значит «нечестный отзыв», это значит «написан за вознаграждение», и решать, как к нему относиться, вам.

Чаты с покупателями

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

Чаты есть у всех трёх площадок. Переписка приходит в раздел «Диалоги» с подписью своей площадки - «Чат Яндекс Маркета», «Чат Wildberries», «Чат Ozon» - туда же, где разговоры с сайта, из Telegram и из MAX. Отдельного раздела нет нарочно: искать переписку с покупателем в двух местах, в зависимости от того, откуда он написал, неудобно.

На экране каждой площадки в «Подключениях» два выключателя, и они разные:

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

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

Если площадка не примет ответ - вы увидите причину словами на экране этой площадки в «Подключениях». Молча ответ не пропадёт.

Подписка для чатов не нужна ни на одной из трёх площадок - в отличие от отзывов, где Ozon без подписки не отдаёт ничего. Достаточно, чтобы у ключа был доступ к чатам: у Ozon это роль Chat, у Wildberries - категория «Чат с покупателями», у Яндекс Маркета - доступ «Общение с покупателями».

Ответы, которые вы уже писали в этих чатах сами, тоже попадают в «Диалоги» - помеченными как ответ человека, без счётчика токенов: их писала не модель.

Чем площадки отличаются: Маркет пускает к чатам часто - переписка обновляется каждые несколько минут; для чата Wildberries у токена должна быть категория «Чат с покупателями», а пускает площадка с Базовым ключом один раз в час - сообщения приходят порциями, это её ограничение, а не наше (с Персональным ключом ограничения нет). Важно: окно чатов у Wildberries отдельное - переписка не отнимает попытки у отзывов и наоборот. Для чата Ozon у ключа должна быть роль Chat, на ответ площадка даёт 48 часов с сообщения покупателя; забираем только переписку с покупателями - служебные чаты с самой площадкой в «Диалоги» не попадают.

Чат начинает покупатель. Написать первым продавец не может - это ограничение площадок, а не наше.

Выгрузка товаров

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

На экране площадки видно, сколько товаров забрано и когда обновлялось. Первая выгрузка занимает от минуты; если площадка отказала, отказ написан там же словами.

Данные берутся только по официальному API продавца - витрину мы не парсим.