Как подключить кабинет Ozon: Client-Id и Api-Key
Сверено с сервисом: 15.10.2026
Кабинет Ozon подключается в отдельном Ozon-боте в Telegram: создайте в кабинете Ozon ключ с ролью Admin read only, затем пришлите боту Client-Id и API-ключ двумя сообщениями. Сервис только читает данные и ничего не меняет в кабинете.
Где найти Ozon-бота
Ozon подключается не в основном боте FenixWB, а в отдельном Ozon-боте. Он работает только в личных сообщениях и только в Telegram. Ссылка на него есть на сайте на странице отчётов, когда выбран кабинет Ozon, и в приглашении в Ozon-кабинет. Имя бота можно уточнить у поддержки. Откройте бота и нажмите /start.
Какой ключ создать в кабинете Ozon
- Откройте кабинет продавца на
seller.ozon.ru: Настройки - API интеграции - Seller API. - Client ID стоит вверху страницы. Его можно скопировать кнопкой справа от числа.
- Нажмите «Сгенерировать ключ». Название ключа любое, цель использования - «Для личного использования».
- В списке «Типы токена» отметьте только Admin read only. Это доступ на чтение: бот видит заказы и возвраты, но ничего не меняет.
- Вкладку «Разрешенные сети» оставьте пустой, иначе Ozon не пустит сервер бота.
- Нажмите «Сгенерировать» и сразу скопируйте ключ: Ozon показывает его один раз.
Бот проверяет не название роли, а доступ ключа к методам Ozon, нужным для заказов, возвратов и данных кабинета. Ключ с ролью Admin read only проходит проверку.
Как подключить в боте
- В Ozon-боте нажмите «🔗 Подключить кабинет Ozon». Кнопка «Как получить ключ» покажет ту же инструкцию прямо в чате.
- Пришлите Client-Id. Это только цифры.
- Пришлите API-ключ отдельным сообщением.
Сообщение с ключом бот сразу удаляет из чата. Название кабинета берётся из Ozon. Если по кабинету ещё не было пробного периода, бот напишет, до какого числа он действует. Там же указан срок действия ключа, если Ozon его сообщил. Условия подписки - в статье Как оплатить, где чек и история платежей и на экране «💳 Подписка и оплата» в боте.
Если этот кабинет уже подключён другим человеком, бот добавит вас участником: «Этот кабинет уже подключён. Вы добавлены участником.» Подробнее про участников - в статье Команда и места.
Если ключ не принимается
| Что пишет бот | Что сделать |
|---|---|
| «Ozon не принял ключ. Проверьте Client-Id и ключ.» | Проверьте, что Client-Id тот же, что в Seller API, и состоит только из цифр, а ключ скопирован целиком. Если ключ отозван, создайте новый. |
| «У ключа не хватает прав: ... Создайте ключ с ролью Admin read only.» | Создайте новый ключ с типом токена Admin read only. После слов «не хватает прав» бот перечисляет методы Ozon, к которым у ключа нет доступа. |
| «Ozon сейчас не отвечает, попробуйте через пару минут. Пришлите ключ ещё раз.» | Подождите и пришлите ключ ещё раз. |
| «Слишком много попыток подключения. Попробуйте через час.» | Подождите и повторите позже. |
| «Это ключ другого кабинета. Подключите его как новый кабинет.» | Появляется при замене ключа: Client-Id должен совпадать с кабинетом, у которого меняете ключ. |
| «В кабинете заняты все места. Попросите владельца освободить место или увеличить тариф.» | Это ответ кабинета, к которому вы присоединяетесь по ключу. Обратитесь к его владельцу. |
| «Этот кабинет удалён владельцем, подключиться к нему нельзя.» | Обратитесь к владельцу кабинета. |
| «Сервис временно недоступен, попробуйте позже.» | Повторите позже. |
Если вы прислали ключ не на том шаге, бот удалит сообщение и попросит начать заново: «Подключить кабинет Ozon», затем Client-Id и ключ по очереди. Если ключ отправлен в группу, бот попробует удалить сообщение и попросит создать новый ключ: в группе его видят все.
Второй кабинет и замена ключа
Второй кабинет Ozon подключается так же, отдельным ключом: в главном меню бота нажмите «➕ Подключить ещё кабинет» и пройдите те же шаги.
Когда ключ перестал работать, бот пишет «Ozon перестал принимать ключ кабинета», и уведомления по кабинету приостанавливаются. Создайте новый ключ в Seller API и замените его: /menu - «🔔 Настройки кабинета» - «🔑 Ключ Ozon» - «Заменить ключ». После замены бот ответит «Ключ обновлён, уведомления возобновлены». Если подписка кабинета не оплачена, ключ сохранится, а уведомления придут после оплаты. Кнопки «Настройки кабинета» в меню при неоплаченной подписке нет: нажмите «Заменить ключ» под уведомлением о ключе или «➕ Подключить ещё кабинет» и пришлите тот же Client-Id с новым ключом.
Срок действия ключа ограничен. Пока подписка действует, бот заранее напомнит о замене. Дату окончания видно на экране «🔑 Ключ Ozon», если Ozon сообщил срок действия ключа.
Когда кабинет подключён, смотрите, что делает бот: Меню Ozon-бота и отчёты и Уведомления Ozon-бота.