Как настроить работу бота @NotifyOrdersBot для получения оперативных заказов с Wildberries(WB) и Ozon и почему он безопасен

Бот @NotifyOrdersBot присылает уведомление о новом заказе, как только видит его через API маркетплейса. Для этого ему нужен ключ доступа — для Wildberries это токен, для Ozon — пара Client-Id и Api-Key. У обоих маркетплейсов можно (и нужно) выдать боту доступ только на чтение заказов, без прав менять что-либо в магазине — разница между «дать ключ с правом на изменение» и «дать ключ только на чтение» решает, может ли посторонний сервис навредить, даже если ключ утечёт.

Wildberries: токен с категориями «Маркетплейс» и «Контент»

1. Личный кабинет WB → Профиль → Интеграции по API (seller.wildberries.ru/api-integrations).
2. Кнопка [+ Создать токен].
3. Вкладка [Для интеграции вручную], тип токена [Базовый токен].
4. Любое имя токена, например «Заказы FBS».
5. Отметьте галочки у категорий доступа [Маркетплейс] и [Контент]. Категория «Контент» опциональна: без неё бот тоже присылает уведомления, но не может показать комиссию за размещение в сообщении о заказе — это единственное, для чего ему нужен доступ к «Контенту».
6. Уровень доступа — [Только чтение].
7. [Создать токен], скопировать и отправить боту @NotifyOrdersBot командой /set_wb_token.

Тот же скриншот бот @NotifyOrdersBot присылает по команде /instruction.

Ozon: ключ с ролью «Admin read only»

1. Личный кабинет Ozon Seller → Настройки → Seller API (seller.ozon.ru/app/settings/api-keys).
2. Кнопка [Сгенерировать ключ] (или использовать существующий).
3. Любое имя ключа, например «OzonOrdersBot».
4. Роль доступа — [Admin read only] (только чтение).
5. Скопировать Client-Id и Api-Key.
6. Отправить боту @NotifyOrdersBot командой /set_ozon_token — сначала Client-Id, затем Api-Key.

Тот же скриншот бот @NotifyOrdersBot присылает по команде /instruction.

У Ozon нет отдельных категорий методов, как у WB: гранулярность — на уровне роли ключа целиком. Роль «Admin read only» даёт доступ на чтение к данным кабинета (включая заказы и комиссии), но не позволяет ничего менять — это ozon-эквивалент того же принципа «только чтение».

Что токены физически не могут сделать

Независимо от маркетплейса, ключ с доступом только на чтение не даёт боту @NotifyOrdersBot возможности:

• изменить цену товара;
• изменить остатки на складе;
• отменить, создать или изменить заказ;
• что-либо ещё записать в карточку товара или в кабинет.

Он может только запросить список заказов, их статусы и (если у WB-токена включена «Контент») размер комиссии — ровно то, что нужно для текста уведомления. Это ограничение задаёт сама площадка на уровне API, а не обещание бота: даже при утечке такого ключа максимум, что получит посторонний — просмотр заказов, не управление магазином.

Если токен или ключ Ozon перестали работать

Бот @NotifyOrdersBot сам присылает уведомление, если WB отклонил токен или Ozon — пару Client-Id/Api-Key (например, при отзыве в кабинете или истечении). В этом случае нужно создать новый ключ тем же способом, что выше, и отправить его повторно: /set_wb_token для WB, /set_ozon_token для Ozon. До этого уведомления о заказах на соответствующем маркетплейсе не приходят.

Когда ключ стоит отозвать

• если он больше не используется (отключили бота на этом маркетплейсе, сменили сервис);
• если возникло подозрение на утечку — отозвать в кабинете WB или Ozon и выпустить новый;
• периодически, если в кабинете накопились старые ключи от сервисов, которыми уже не пользуетесь.

Уведомления в любой момент можно остановить без отзыва ключей командой /stop_notifications, включить обратно — /start_notifications. Что ещё умеет бот — на странице @NotifyOrdersBot; а если токены нужны для нового товара, который ещё не закупили, пригодится чек-лист проверки перед закупкой.

Итог одной строкой

WB — токен с категориями «Маркетплейс» (+опционально «Контент» для комиссии), уровень «Только чтение» → Ozon — ключ с ролью «Admin read only» → оба передаются боту @NotifyOrdersBot командами /set_wb_token и /set_ozon_token → утечка такого ключа не даёт доступа к изменению магазина ни на одном из маркетплейсов.