Подключение Ozon

EasyChat объединяет чаты покупателей и товарные обращения Ozon в общей операторской панели. Вопросы, отзывы и возвраты не превращаются в обычные сообщения: оператор видит допустимые действия для конкретного потока.

Что Подготовить

• Действующий кабинет продавца Ozon.
• Client-Id и Api-Key Seller API.
• Для полной работы EasyChat — роли Admin, Chat, Question, Review, Returns и Company.
• Подходящий тариф Ozon для доступа к чатовым методам.
• Работающий основной cron EasyChat и публичный HTTPS.

По текущим правилам Ozon чатовые методы могут требовать Premium Plus или Premium Pro. Корректный ключ без нужного тарифа может работать с товарами, но не получить доступ к переписке.

Как Создать Ключ

1. Откройте настройки Seller API Ozon.
2. Нажмите Сгенерировать ключ, укажите понятное название, например EasyChat, и выберите использование для внешнего сервиса или приложения.
3. В списке ролей выберите Admin — полный доступ. Не выбирайте только Admin read only: он подходит для чтения, но не позволяет EasyChat автоматически настроить уведомления и выполнять ответы.
4. Если Ozon показывает отдельные роли, также отметьте Chat, Question, Review, Returns и Company.
5. Сразу скопируйте созданный ключ: Ozon показывает его только один раз.

Используйте отдельный ключ только для EasyChat и не отправляйте его в чатах, письмах или тикетах. Для автоматической настройки уведомлений нужен именно полный Admin. Вариант Admin read only безопаснее, но тогда уведомления придётся настраивать вручную в Ozon, а EasyChat будет работать через резервную сверку.

Подробности о Seller API и сроке действия новых ключей смотрите в официальном сообщении Ozon для разработчиков.

После вставки ключа EasyChat дополнительно показывает дату его окончания. За 30 дней до этой даты появляется спокойное предупреждение и рекомендация заранее выпустить новый ключ; после окончания срока предупреждение становится срочным. То же состояние доступно в карточке кабинета, на вкладке Ozon и в сайдбаре.

Подключить Кабинет

1. Откройте EasyChat → Интеграции.
2. В общем ряду каналов выберите вкладку Ozon. Вы останетесь на странице интеграций и увидите только кабинеты Ozon.
3. Введите Client ID и API key.
4. Нажмите Проверить и подключить.
5. Оставьте включенными нужные потоки.

EasyChat проверяет учетные данные до сохранения, шифрует ключ локально и пытается включить быстрые уведомления Ozon. Если уведомления недоступны, карточка честно показывает Работает резервная сверка: cron продолжает забирать изменения через Seller API.

Чтобы подключить еще один кабинет Ozon, используйте ту же форму сверху. Подключение и переключатели сохраняются сразу, отдельная общая кнопка Сохранить интеграции на этой вкладке не требуется. Сводка канала, безопасное подключение и список кабинетов расположены сверху вниз в одном порядке, поэтому нужный статус и следующий шаг видны без перехода на дополнительные страницы.

Рабочие Потоки

• Чаты покупателей: текст, поддерживаемые вложения и отметка прочтения.
• Вопросы о товарах: ответ и доступные статусы обработки.
• Отзывы: ответ, редактирование и обработка только когда это разрешает API.
• Возвраты: причины и варианты решения приходят с сервера; EasyChat не предлагает неподдерживаемое действие.

Для нового чата оператор вводит номер отправления. Ozon не позволяет открыть произвольный чат с любым покупателем без контекста заказа.

Как Работают Уведомления

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

Ozon может прислать в buyer-чате системную рассылку или сообщение бота. EasyChat показывает такие записи как Уведомления Ozon или Бот Ozon и не предлагает отвечать на них. Имя Покупатель Ozon используется только для сообщений клиентского типа.

Если Ozon передал техническое событие без текста и вложения, EasyChat показывает для пустого шага бота нейтральную отметку Служебный шаг бота без отображаемого содержимого, а не оставляет пустое сообщение. Это означает, что площадка сама передала шаг сценария без текста; EasyChat не удалял и не подменял его картинку. Если площадка заявила изображение, но не передала его адрес, это будет отмечено отдельно как проблема содержимого ответа Ozon.

При подключении EasyChat автоматически проверяет callback Ozon специальным TYPE_PING: ответ содержит обязательный result, версию, имя сервиса и UTC-время с миллисекундами. Поэтому после сохранения ключа отдельная ручная настройка уведомлений Ozon не требуется.

Проверить В Обе Стороны

1. Отправьте сообщение покупателя из Ozon.
2. Убедитесь, что диалог появился с меткой Ozon.
3. Ответьте из web-панели и проверьте доставку.
4. Откройте тот же диалог на Android и отправьте второй ответ.
5. Проверьте изображение или файл, если они доступны вашему аккаунту.
6. Откройте диалог и убедитесь, что прочтение синхронизировалось.

Для нового диалога используйте Новый → Ozon и укажите настоящий номер отправления. EasyChat проверяет уже открытый чат и защищает запуск серверной блокировкой: быстрые повторные клики или действия двух операторов не создают второй диалог и не отправляют первое сообщение повторно.

Безопасность И AI

Client-Id и Api-Key хранятся зашифрованными на сервере установки и не передаются в центральный EasyChat. Служебные уведомления не показываются как реплики покупателя, не вызывают AI и не расходуют токены. Первичная история также импортируется без автоответов и лишних push.

Частые Ситуации

• Ключ верный, но чаты недоступны. Проверьте роль Chat и тариф Ozon.
• Уведомления не включились автоматически. Убедитесь, что выбран полный Admin, а не Admin read only. Также проверьте публичный HTTPS.
• Быстрые уведомления не включились. Убедитесь, что сайт доступен по HTTPS; резервный polling продолжит работу.
• Не удаётся начать чат. Проверьте формат и принадлежность номера отправления текущему кабинету.
• Действие по возврату недоступно. Оно не разрешено текущим состоянием заявки или правами ключа.
• После действия показана неопределённая доставка. Не повторяйте решение вручную: EasyChat сначала сверит актуальное состояние с Ozon и только затем безопасно разрешит новое действие.
• Запуск чата прервался или результат неизвестен. Не создавайте его заново: EasyChat ищет фактически открытый чат по номеру отправления. После сверки он откроется без повторной отправки первого сообщения.
• Сообщение появилось с задержкой. Проверьте основной cron и последнюю сверку кабинета.

Мини-Чеклист

• Client-Id и Api-Key прошли проверку.
• Выбран полный Admin, а также роли Chat, Question, Review, Returns и Company.
• Тариф Ozon разрешает нужные методы переписки и обращений.
• Кабинет показывает статус Подключен.
• Основной cron выполняется регулярно.
• Входящее и исходящее сообщения проверены в Ozon, web и Android.
• Специальное действие выполнено только после подтверждения оператора.