Интеграция с Shopify: AI Search, поиск по магазину в реальном времени и статус заказа

Подключите чат-бот ChatLab к вашему магазину Shopify, чтобы клиенты могли находить товары и проверять свои заказы прямо в чате. Поиск товаров осуществляется через функцию AI Search, которая ищет по смыслу в проиндексированном каталоге Shopify, или через прямой поиск в магазине, отправляющий запросы к API магазина.

Пример диалога

Этот пример показывает взаимодействие с точки зрения клиента. Доступные действия и возвращаемые данные зависят от этой интеграции и ваших настроек.

Перед началом работы

Сначала создайте или выберите чат-бота. Вам потребуются права на управление его интеграциями и доступ к настройкам подключения внешнего аккаунта. Если на карточке подключения отображается предложение перейти на другой тариф или связаться с нами, убедитесь, что ваша подписка включает эту интеграцию. Храните учетные данные API в секрете; никогда не вставляйте их в код виджета для сайта.

Важно: рекомендации для электронной коммерции

После завершения интеграции ознакомьтесь с подробным руководством по оптимизации чат-бота для интернет-магазинов: Как настроить ChatLab для вашего интернет-магазина

Как чат-бот находит товары в Shopify: AI Search и поиск по магазину в реальном времени

Чат-бот ChatLab может искать товары в магазине Shopify двумя способами. Бот использует либо один, либо другой - никогда оба сразу.

AI Search (рекомендуется) - ChatLab ведет собственный индекс вашего каталога Shopify, и чат-бот ищет в нем товары по смыслу.

• Покупатели задают вопросы простыми словами, например: «красное платье до 300». Диапазон цен применяется как строгий фильтр, а точные коды товаров (SKU, EAN) также успешно сопоставляются.
• Цена, остатки и варианты считываются напрямую из Shopify в режиме реального времени в момент ответа, поэтому клиенты видят актуальные данные даже между обновлениями индекса.
• Результаты отображаются в чате в виде карточек товаров, до 5 штук в одном ответе.
• Индексация запускается автоматически сразу после подключения магазина. Каталог не расходует символы для обучения.
• Необходимый тариф: функция входит во все планы E-commerce (Free 100 товаров, Start 2 000, Grow 5 000, Scale 20 000). На тарифе Universal добавьте дополнение «Интеграции e-commerce» (E-commerce integrations, $30 в месяц) и пакет товаров AI Search ($29 в месяц, 5 000 товаров), назначенный чат-боту.

Поиск по магазину в реальном времени (Live store search) - чат-бот передает запрос покупателя во встроенный поиск Shopify через API магазина и возвращает то, что нашел магазин.

• Ничего не индексируется и не требует синхронизации. Данные всегда актуальны.
• Это поиск по ключевым словам: он находит только то, что нашел бы собственный поиск вашего магазина по этой фразе. Он не понимает описания потребностей, синонимы или опечатки так, как это делает AI Search.
• Необходимый тариф: тариф Universal с дополнением «Интеграции e-commerce» (E-commerce integrations, $30 в месяц). Пакет товаров не требуется.

Когда функция AI Search включена, она заменяет поиск по магазину в реальном времени. Проверка статуса заказа работает одинаково в обоих случаях. Третий вариант - обучение на просканированных страницах магазина - доступен на любом тарифе и предназначен для информационных страниц (например, о доставке и возврате), а не для каталога товаров. Полное сравнение читайте в статье AI Search: как ваш чат-бот находит товары, а информацию о лимитах товаров смотрите в статье Тарифы E-commerce и лимиты.

Что дает интеграция

Поиск по магазину в реальном времени (поиск товаров по фразе) - чат-бот отправляет фразу клиента в поиск Shopify. Поиск выполняется по названиям, описаниям, типам товаров, тегам и поставщикам, возвращая подходящие активные товары со следующими данными:

• Название, описание и тип товара
• Поставщик и теги
• Цена или диапазон цен (для товаров с несколькими вариантами)
• Доступные варианты с артикулом (SKU), исходной ценой до скидки (compare-at price), количеством на складе и статусом наличия
• Изображение товара и прямая ссылка на ваш магазин

Вы можете настроить поиск товаров так, чтобы показывать только товары в наличии. Если эта опция включена, позиции не на складе исключаются из результатов. Дополнительная настройка позволяет показывать товары, доступные для предзаказа, даже при активном фильтре наличия на складе. Подробности см. в разделе Шаг 4.

Детали заказа (Order Details) - по умолчанию клиенты указывают номер заказа и соответствующий адрес электронной почты. Дополнительные режимы позволяют искать заказ только по номеру или находить недавние заказы только по адресу электронной почты. Это сопоставление данных, а не подтверждение личности посетителя. Чат-бот возвращает:

• Номер заказа, дату, общую сумму и валюту
• Заказанные позиции с названиями, количеством, ценами, SKU, названием варианта и поставщиком
• Статус выполнения и информацию для отслеживания (номер, курьерская служба, URL)
• Адрес доставки и адрес плательщика
• Способ и стоимость доставки
• Контактные данные клиента (электронная почта, имя, телефон)
• Причину и дату отмены (для отмененных заказов)

Шаг 1: создание учетных данных Shopify API

Важно для агентств и партнеров Shopify: создавайте и устанавливайте приложение в той организации, которой принадлежит магазин. Подключение ChatLab по Client ID и Secret использует тип авторизации client credentials grant от Shopify, который не поддерживает приложения, принадлежащие другой организации. Если вы видите ошибку "The app cannot access this store", проверьте организацию и установку приложения, прежде чем менять учетные данные. Ознакомьтесь с требованиями Shopify к client credentials.

1. Войдите в панель управления Shopify
2. Перейдите в Settings > Apps (Настройки > Приложения)
3. Нажмите Develop apps (Разработка приложений)
4. На странице разработки приложений нажмите Build apps in Dev Dashboard (Создавать приложения в Dev Dashboard) - откроется dev.shopify.com/dashboard
5. Нажмите Create app (Создать приложение) и введите название (например, "ChatLab Integration")

6. После создания прокрутите страницу до раздела Access (Доступ) и нажмите Select scopes (Выбрать области доступа)

7. В блоке областей доступа Admin API найдите и включите следующие разрешения:
   • read_products
   • read_orders
8. Нажмите Done (Готово)

9. Нажмите кнопку Release (Выпустить), чтобы опубликовать приложение
10. Перейдите в App settings (Настройки приложения) и скопируйте Client ID и Secret - сохраните их в надежном месте, они понадобятся для подключения к ChatLab

11. Перейдите в раздел Home (Главная) и нажмите кнопку для установки приложения в ваш магазин

12. Выберите свой магазин и подтвердите действие, нажав Install (Установить)

Шаг 2: определение поддомена вашего магазина

Найдите домен магазина myshopify.com в разделе Settings > Domains (Настройки > Домены) в Shopify, затем скопируйте только ту часть, которая идет перед .myshopify.com. Например, для pizza-delicious.myshopify.com введите pizza-delicious - не используйте собственный домен витрины или адрес панели управления admin.shopify.com. См. руководство Shopify по доменам.

Шаг 3: Подключите Shopify в ChatLab

1. Войдите в ChatLab и выберите своего бота
2. Перейдите на вкладку Connect (Подключение)

3. Нажмите Connect на карточке Shopify
4. Введите ваш Client ID (из шага 1)
5. Введите ваш Secret (из шага 1)
6. Введите ваш Shopify subdomain (поддомен Shopify из шага 2)

7. Нажмите Connect

ChatLab автоматически протестирует подключение, проверив наличие необходимых областей доступа у ваших учетных данных API. В случае успеха вы увидите подтверждающее сообщение.

Шаг 4: настройка действий Shopify

После подключения вы можете активировать и настроить отдельные действия ИИ. Перейдите в Settings > Actions (Настройки > Действия) и отфильтруйте список по платформе Shopify.

Стандартные действия включают в себя:

• Shopify - product search - позволяет чат-боту искать товары по каталогу
• Shopify - order details - позволяет чат-боту проверять данные о заказах

При настройке подключения стандартные действия включаются автоматически. Проверьте их статус и отключите те, доступ к которым клиентам предоставлять не нужно. Откройте действие для редактирования, затем используйте кнопку Enable (Включить) или Update (Обновить) в диалоговом окне. Вы также можете настроить название действия (сообщение, которое видят пользователи во время его выполнения) и инструкции, определяющие, как именно ИИ должен использовать каждое действие.

Поиск товаров - настройки складского учета

Действие поиска товаров включает параметры фильтрации по остаткам на вкладке Product Search Settings (Настройки поиска товаров):

• Products in stock only (Только товары в наличии) - при включении чат-бот возвращает только те товары, которые сейчас есть на складе. Отсутствующие позиции исключаются из результатов поиска.
• Show products available for pre-order (Показывать товары, доступные для предзаказа) - эта опция появляется при включении параметра "Products in stock only". Если она активна, товары, которых нет на складе, но для которых в Shopify настроена возможность продолжать продажи (предзаказ), по-прежнему будут появляться в результатах поиска с отметкой о доступности по предзаказу.

Конфиденциальность при поиске заказов

В настройках Order Lookup Configuration (Конфигурация поиска заказов) действия для работы с заказами опции Allow order lookup without email verification (Разрешить поиск заказа без проверки email) и Allow order lookup by email address only (Разрешить поиск заказа только по email) по умолчанию выключены. Режим поиска только по email по умолчанию возвращает 1 недавний заказ (можно настроить от 1 до 3). Включение поиска только по идентификатору отключает режим поиска только по email. Любой пользователь, знающий выбранный идентификатор, сможет получить данные о заказе, поэтому перед включением любой из этих опций проверьте права доступа и маскирование персональных данных.

AI Search для Shopify: каталог, переиндексация и настройки

На тарифе E-commerce или на тарифе Universal при подключении пакета продуктов AI Search к чатботу функция AI Search включена и заменяет поиск по магазину в реальном времени. Индексация запускается автоматически при подключении магазина.

• Проверьте каталог - откройте Обучение > Каталог e-commerce (Training > E-commerce catalog) и просмотрите вкладки Товары (Products) и Категории (Categories). В разделе Магазин > Товары (Shop > Products) отображаются панель Каталог товаров (Product catalog) и карточка Пакеты AI Search на этом чатботе (AI Search packs on this chatbot).
• Настройте расписание переиндексации - используйте Расписание автопереобучения (Schedule auto-retrain) в разделе Обучение > Каталог e-commerce (Training > E-commerce catalog). Переиндексация может выполняться ежедневно и доступна на каждом тарифе E-commerce, а также с каждым пакетом продуктов. Кнопка Обучить сейчас (Train now) или Переобучить (Retrain) запускает процесс по запросу. Обновления происходят инкрементально: неизмененные товары пропускаются, а удаленные товары удаляются из индекса.
• Проверьте действие - в разделе Настройки > Действия (Settings > Actions) откройте Shopify - AI поиск товаров (Shopify - AI product search). Доступны параметры: Включать карточку товара (Include product card), Только товары в наличии (Products in stock only) и Количество возвращаемых товаров (Number of products to return).
• Показывайте карточки товаров - включите Включить Offer Cards (Enable Offer Cards) в разделе Настройки > Модель и расширенные (Settings > Model & Advanced). См. Offer Cards.

Если каталог превышает лимит товаров, индексация останавливается на лимите, а владелец чатбота получает электронное письмо. Параметры описанного выше действия поиска по магазину в реальном времени не обязательно применимы к AI Search.

Тестирование интеграции

После активации действий перейдите в Overview (Обзор) и попробуйте отправить запросы:

• "Покажи беговые кроссовки" (проверяет поиск товаров)
• "Какой статус у моего заказа #1001?" (проверяет сведения о заказе; укажите соответствующий email для заказа, к которому у вас есть доступ)

Убедитесь, что ответы соответствуют данным из вашего магазина Shopify, а ссылки на товары открываются корректно.

Установка чат-бота в магазин Shopify

Чтобы добавить чат-виджет на витрину Shopify:

1. В ChatLab откройте вкладку Deploy (Развертывание) для вашего бота
2. Выберите вкладку платформы Shopify
3. Выберите Widget (Виджет) и скопируйте фрагмент кода
4. В панели управления Shopify перейдите в Online Store > Themes (Интернет-магазин > Темы)
5. Нажмите меню с тремя точками у активной темы и выберите Edit code (Редактировать код)
6. Откройте файл theme.liquid в папке Layout
7. Вставьте скопированный код внутрь тега <head>
8. Нажмите Save (Сохранить)

Откройте опубликованную витрину магазина, чтобы убедиться, что виджет загружается. Подключение к API и установка на витрину выполняются раздельно; проверьте список активных действий в Settings > Actions.

Похожие статьи

• AI Search: как ваш чат-бот находит товары
• Планы и лимиты для e-commerce
• Руководство по настройке e-commerce
• Добавление чат-бота на ваш сайт