Главная · Блог · Как подключить Ozon к боту: ключ Seller API, отправления FBS и отзывы
Как подключить Ozon к боту: ключ Seller API, отправления FBS и отзывы
Магазин на Ozon можно подключить к боту ЧБТ за пару минут: нужны два значения из кабинета продавца — Client-Id и Api-Key. После этого ЧБТ сам следит за новыми отправлениями FBS и отзывами без ответа и сообщает о них. Но у подключения Ozon есть честные границы: вопросы покупателей и ответы на отзывы через него не работают, а товары по API пока не загружаются. Разбираем по шагам, что вы получите, чего нет и как закрыть пробелы.
Что даёт подключение Ozon
- Новые отправления FBS. ЧБТ раз в 10 минут находит необработанные отправления — то, что нужно собрать и отгрузить со своего склада.
- Отзывы без ответа. Оценка, текст и товар нового отзыва попадают в счётчик и в письмо-сводку.
- Данные по запросу в сценарии. Действие «Данные маркетплейса» умеет для Ozon заказы, остатки и отзывы — так собирается служебный бот для себя.
Чего подключение не даёт:
- Вопросов покупателей. Метода вопросов в нашем подключении Ozon нет, раздел помечен как неподдерживаемый.
- Ответов на отзывы. Отвечать нужно в кабинете продавца Ozon.
- Переписки с покупателями внутри площадки. Чатов площадок в ЧБТ нет.
- Каталога по API. Товары Ozon с площадки пока не загружаются — ниже расскажем, как дать боту ассортимент другим способом.
Где взять Client-Id и Api-Key
Оба значения выдаёт кабинет продавца Ozon: «Настройки» → «Seller API». Client-Id — номер вашего магазина в API, Api-Key — сам ключ, который вы создаёте там же.
Подсказка в форме ЧБТ говорит, какие права нужны: на чтение товаров, заказов и отзывов. В отличие от Wildberries, у Ozon права ключа устроены через роль ключа, а не через список галочек-категорий, поэтому ЧБТ не называет конкретные пункты — неверное название хуже отсутствующего. Ориентир простой: ключу должно быть доступно чтение отправлений FBS и отзывов.
Ключ не пересылайте в переписке и не отправляйте в поддержку. Его место — только форма подключения: там он хранится в зашифрованном виде и не показывается повторно.
Подключение по шагам
- Откройте бота → «Маркетплейсы» → «Подключить площадку» и выберите Ozon.
- Вставьте «Client-Id» и «Api-Key» в соответствующие поля.
- Если у вас несколько магазинов Ozon, задайте каждому понятное название — оно поможет различать магазины в списке и в сценариях.
- Нажмите «Подключить». ЧБТ сразу проверит ключ лёгким запросом — списком ваших складов — и сохранит подключение.
Если ключ не принят, ЧБТ скажет об этом сразу, а не через час. Если такой магазин уже подключён к этому боту, второй раз его не добавить — кабинет так и напишет: «Такой магазин уже подключён к этому боту.». Подключать и отключать магазины могут владелец и администратор проекта.
Первый опрос пройдёт автоматически в ближайшие минуты и посмотрит события за последние 3 дня.
Отзывы и Premium Plus
Отзывы через API Ozon может отдавать только магазинам с подпиской Premium Plus. Если подписки нет, площадка отвечает на запрос отзывов отказом по правам — и ЧБТ показывает это честно, а не делает вид, что отзывов просто нет:
- если отправления в том же опросе пришли, ключ рабочий, а раздел «Отзывы» получает пометку «нет прав у ключа»;
- заказы при этом продолжают приходить, подключение считается живым;
- письмо «обновите ключ» в такой ситуации не уходит — ключ не виноват.
Если подписку подключили позже, нажмите «Проверить сейчас» на карточке: при успешном ответе раздел сам вернётся в «Работает». Ключ менять не нужно.
И ещё раз: даже с Premium Plus ЧБТ отзывы только читает. Ответ покупателю пишется в кабинете Ozon.
Какие заказы ЧБТ видит
ЧБТ читает необработанные отправления FBS — то есть заказы со склада продавца, которые ждут сборки. Окно запроса строится по сроку отгрузки: он всегда в будущем относительно создания заказа, поэтому ЧБТ смотрит и на несколько дней вперёд — иначе свежие заказы с длинной сборкой не попали бы в выборку.
В событии есть номер отправления, время, названия товаров, количество и цена — эти данные попадают в письмо-сводку. Каждое отправление учитывается один раз, повторные опросы его не дублируют.
Чего нет: отправлений FBO (товар на складе Ozon), смены статусов уже собранных отправлений и сборки из ЧБТ. Собрать и отгрузить отправление нужно в кабинете Ozon. Отдельного сообщения в мессенджер о новых заказах Ozon тоже нет — такие уведомления сейчас есть только у Wildberries; для Ozon источник — письмо-сводка и служебный бот.
Письмо-сводка по Ozon
Когда опрос нашёл новые отправления или отзывы, владельцу и администраторам проекта приходит письмо с заголовком вида «Ozon: 3 новых заказа». Внутри — блоки по разделам с примерами (до 5 на раздел) и строкой «Что делать»: собрать и отгрузить заказ в кабинете Ozon, ответить на отзыв в кабинете Ozon.
Письмо приходит только тогда, когда появилось новое: пустых ежедневных отчётов «ничего не произошло» ЧБТ не шлёт. Если за опрос пришли и отправления, и отзывы, они придут одним письмом, а не двумя.
Письмо приходит, только если у получателя в настройках аккаунта включены «Email-уведомления». Оператор проекта сводку не получает — только владелец и администраторы. Если хотите, чтобы письма читал менеджер по маркетплейсам, добавьте его в команду администратором.
Каталог Ozon: как дать боту ассортимент
Загрузка товаров Ozon по API в ЧБТ пока не подключена. На карточке магазина это написано прямо: «Товары с площадки пока не загружаются», и тут же два способа, как дать боту ассортимент уже сейчас:
- Прайс файлом. Выгрузите товары из учётной системы или таблицы и загрузите файл в каталог ЧБТ.
- Фид интернет-магазина. Если у вас есть свой сайт, подключите ссылку на товарный фид — YML, Google Merchant или CSV. Тогда каталог будет обновляться сам.
Каталог нужен для ИИ-продавца, который отвечает покупателям по вашим товарам в Telegram, MAX, ВКонтакте и на сайте, — он доступен с тарифа Базовый. Для счётчика отзывов, письма-сводки и служебного бота каталог не нужен: они работают по ключу Ozon сами по себе. Что такое фид и где его взять — в статье про YML-фид.
Служебный бот для Ozon
Действие «Данные маркетплейса» с площадкой Ozon отвечает на три запроса:
- «Заказы» — «Новых заказов: N» по необработанным отправлениям FBS или «Новых заказов нет.».
- «Остатки» — до 15 строк: артикул и данные по складам в том виде, как их отдаёт Ozon. Это технический список, но для быстрой проверки «что кончается» его хватает.
- «Отзывы» — до 10 строк «★оценка: начало текста». Без Premium Plus здесь будет «Не удалось получить данные маркетплейса.».
Сценарий запускается ключевым словом, а результат подставляется в «Сообщение» переменной, например {{mp_result}}. Закройте такой сценарий «Условием» по тегу команды — иначе данные увидит любой, кто напишет кодовое слово. Подробная сборка — в статье про бота для продавца маркетплейса.
Как читать карточку подключения
В блоке «Подробнее: что умеет это подключение» у Ozon такая картина:
| Раздел | Состояние |
|---|---|
| Заказы | Работает |
| Отзывы | Работает или «нет прав у ключа» без Premium Plus |
| Вопросы | Не поддерживается |
| Чаты | Не поддерживается |
| Каталог, цены и остатки | «не проверено на вашем ключе» |
«Работает» у заказов и отзывов сразу после подключения — это значение по умолчанию; что данные действительно приходят, видно по строке «Получено за последнюю проверку». Если площадка отклонила ключ целиком, кабинет предложит проверить ключ и права доступа, а владелец получит письмо «обновите ключ» — не чаще раза в сутки.
Чем подключение Ozon отличается от Wildberries
| Ozon | Wildberries | |
|---|---|---|
| Что вставлять | «Client-Id» и «Api-Key» | «API-токен продавца» |
| Права ключа | Роль ключа; отзывы — с Premium Plus | Галочки категорий: «Контент», «Статистика», «Вопросы и отзывы» и другие |
| Заказы | Необработанные отправления FBS | Новые заказы без отмен |
| Отзывы | Без ответа | Без ответа |
| Вопросы | Нет | Без ответа — счётчик и письмо |
| Каталог по API | Пока нет — прайс файлом или фид | Карточки и цены |
| Уведомление о заказе в мессенджер | Нет | Тип «Заказы WB» |
Общее у обеих площадок: опрос раз в 10 минут, письмо-сводка, действие «Данные маркетплейса» в сценарии и честная матрица разделов на карточке. Если вы продаёте на обеих, подключите оба магазина в одном боте — у каждого будет своя карточка. Про ключ Wildberries подробно — в статье о правах ключа API Wildberries.
Частые проблемы
- Перепутаны поля. Client-Id — короткий номер, Api-Key — длинный ключ. Если поменять их местами, площадка ключ не примет.
- Ключ от другого магазина. Client-Id и Api-Key должны быть из одного кабинета.
- Пустые отзывы. Проверьте подписку Premium Plus и пометку «нет прав у ключа» на карточке.
- Ждёте вопросы. Вопросов Ozon в ЧБТ нет — их читают в кабинете Ozon.
- Ключ отозвали. Выпустите новый и вставьте его через «Заменить ключ»: данные и история останутся.
- Хочется обновить прямо сейчас. «Проверить сейчас» опрашивает заказы и отзывы не чаще раза в 2 минуты.
Бот для продавца маркетплейсаПрава ключа API WildberriesЧто такое YML-фидКаталог товаров