Внешняя синхронизация коммерции

Обзор

Каналы и интеграции → Внешняя коммерция (/ru/integrations/commerce) сохраняет оформление на Shopify или WooCommerce, одновременно синхронизируя поддерживаемые данные в OrderInChat. Виджет, WhatsApp и Instagram ИИ, автоматизации и необязательные транспортные ярлыки используют зеркалированные данные.

Эта интеграция не клонирует исходную тему и не заменяет внешний процесс оформления заказа.

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

OrderInChat использует OAuth Shopify, поэтому вам не нужно вручную копировать токены.

1. В панели партнеров Shopify создайте приложение с названием Order in Chat.
2. Добавьте URL обратного вызова https://app.orderinchat.com/api/store/commerce/shopify/oauth/callback в Разрешенные URL-адреса перенаправления.
3. Предоставьте следующие области API администратора: read_products, write_products, read_inventory, write_inventory, read_orders, read_customers, read_content, read_legal_policies, read_discounts, read_shipping, read_files, read_locales, read_locations, read_script_tags, write_script_tags.
4. В OrderInChat перейдите в Каналы и интеграции → Внешняя коммерция, выберите Shopify, введите HTTPS URL магазина (например, https://your-store.myshopify.com) и нажмите Подключиться к Shopify.
5. Подтвердите разрешения в Shopify. Вы автоматически вернетесь в OrderInChat. Затем нажмите Проверить соединение, Зарегистрировать вебхуки и Синхронизировать сейчас.

Если вы не можете использовать OAuth, разверните раздел Ручная настройка токена и вставьте токен доступа API администратора и секретный ключ API пользовательского приложения. Секрет API необходим для проверки HMAC-подписей вебхуков Shopify. OrderInChat шифрует учетные данные и больше никогда их не отображает.

Официальные руководства: Пользовательские приложения Shopify и Токены доступа API администратора.

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

В WordPress откройте WooCommerce → Настройки → Дополнительно → REST API, создайте ключ с правами на чтение для синхронизации только зеркалирования или с правами на чтение/запись, если изменения в Bulk Editor должны быть записаны обратно в WooCommerce, и введите HTTPS URL магазина, ключ потребителя и секрет потребителя. Чтобы синхронизировать страницы и записи WordPress, также введите имя пользователя WordPress и Пароль приложения из Пользователи → Профиль.

Официальное руководство: REST API WooCommerce.

Некоторые хосты отклоняют HTTP Basic аутентификацию. Коннектор может повторно отправлять запросы WooCommerce с аутентификацией через строку запроса; учетные данные скрываются из логов.

Поведение синхронизации

1. Сохраните и протестируйте соединение.
2. Зарегистрировать вебхуки — создает подписки на внешнем магазине, чтобы изменения товаров, заказов и клиентов уведомляли OrderInChat почти в реальном времени. OrderInChat также регулярно проверяет изменения на случай, если вебхук будет пропущен.
3. Выберите ресурсы для зеркалирования.
4. Запустите начальную синхронизацию.

В целях безопасности OrderInChat проверяет каждый вебхук и повторно сверяет данные с Shopify или WooCommerce перед сохранением. Регулярные проверки находят пропущенные вебхуки только пока включена опция Использовать как источник коммерции. Если статус вебхука показывает ошибку и соединение неактивно, используйте Зарегистрировать вебхуки и Синхронизировать сейчас после изменений в исходном магазине; одна только проверка соединения не обновляет товары. Повторные обновления не создают дублирующие записи.

Вес доставки варианта Shopify импортируется из веса варианта в Shopify; редактор товара показывает его в настроенной единице веса магазина. Метаполя размерности с именами length, width или height преобразуются в сантиметры. Описания товаров Shopify берутся из собственного описания товара, а не из общих секций темы или баннеров; текст темы не становится специфическим описанием товара. Черновики и архивные товары не отображаются клиентам.

Если ваш магазин использует внешнюю коммерцию, клиенты покупают по URL исходного товара. Оформление заказа через корзину OrderInChat и сценарии оформления в WhatsApp для этого магазина отключены.

Локации инвентаря

Локации Shopify и уровни инвентаря по вариантам зеркалируются в записи склада/локации OrderInChat. Остатки товаров и вариантов показывают сумму по всем локациям для чата и оформления заказа. Основной WooCommerce предоставляет одно общее значение остатка, поэтому оно зеркалируется в виртуальную локацию по умолчанию; остатки по нескольким локациям из плагинов WooCommerce требуют поддерживаемого плагина.

Вы можете добавлять собственные локации OrderInChat в разделе Каталог → Склад. Ячейки остатка в Bulk Editor расширяются по локациям. Передача инвентаря в Shopify обновляет только выбранную локацию и требует права доступа write_inventory. Заблокированные поля остатка не перезаписываются при последующей синхронизации инвентаря.

Транспортные ярлыки

Транспортные ярлыки OrderInChat по умолчанию отключены. Включайте их только если OrderInChat должен быть единственным местом, где создаются ярлыки. Даже при включении OrderInChat не покупает ярлык, когда внешний заказ уже имеет информацию о выполнении или отслеживании.

Фрагмент виджета

Shopify: Регистрация вебхуков также пытается автоматически установить виджет чата в вашем магазине Shopify. Вы все равно можете вставить фрагмент в Custom Liquid, если это необходимо. Предоставьте write_script_tags в пользовательском приложении, если автоматическая установка не удалась.

WooCommerce: REST API не может внедрять скрипты темы. Скопируйте фрагмент JavaScript или PHP со страницы интеграции в нижний колонтитул темы или functions.php.

Страницы → База знаний

Когда включены Страницы и записи, страницы/статьи/политики Shopify и страницы/записи WooCommerce добавляются в Базу знаний OrderInChat (или обновляются в ней) для ответов ИИ. Соответствующие заголовки политик Shopify также заполняют поля возврата/условий магазина. Это не полное клонирование темы/CMS.

Ограничения API

Интеграция сообщает о неподдерживаемых или недоступных данных вместо того, чтобы выдумывать значения. Общие ограничения включают:

• Shopify не предоставляет все настройки платежей через API администратора.
• Цены на доставку, рассчитанные перевозчиком, остаются рассчитанными на внешнем оформлении заказа.
• WooCommerce REST не включает страницы WordPress без пароля приложения WordPress.
• Отзывы и бронирования требуют платформы или API приложения, которые предоставляют эти ресурсы.
• Дополнения к товарам зеркалируются только тогда, когда исходный API имеет реальный эквивалент.