Интеграция с Shopify

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

Важно: рекомендации для сферы e-commerce

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

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

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

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

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

Детали заказа - клиенты могут проверять статус заказа, указав номер заказа и адрес электронной почты. Оба значения сверяются с данными вашего магазина Shopify. Чат-бот возвращает:

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

Шаг 1: Создайте учетные данные Shopify API

Важно для агентств и партнеров Shopify: приложение Shopify ДОЛЖНО создаваться в панели Dev Dashboard той организации, которой принадлежит магазин - всегда начинайте из панели администратора самого магазина (Settings > Apps > Develop apps > Build apps in Dev Dashboard). Приложение, созданное другой организацией (например, агентством или партнером Shopify в собственной панели Dev Dashboard) и установленное в магазин по специальной ссылке установки, НЕ будет работать с ChatLab, даже если установка завершилась успешно и приложение отображается в списке установленных приложений магазина с нужными разрешениями. Причина: ChatLab подключается с использованием Client ID и Secret (авторизация через client credentials grant в Shopify), а Shopify разрешает этот тип авторизации только для приложений, разработанных организацией - владельцем магазина: "Client credentials is only available for apps developed by your own organization and installed in stores that you own" (документация Shopify). Это ограничение со стороны Shopify, а не ChatLab. Симптом - ошибка подключения в ChatLab с сообщением "The app cannot access this store. Create the app in the Dev Dashboard of the organization that owns this store" (вызывается ошибкой OAuth shop_not_permitted со стороны Shopify), даже если Client ID, Secret и поддомен магазина указаны правильно, а приложение установлено. Характерный признак приложения от другой организации - в панели администратора магазина отображается сообщение: "This custom app was built by a Shopify partner for your store." Решение для агентств: вам не нужно привлекать разработчика со стороны продавца - попросите продавца добавить вашего пользователя в СВОЮ организацию с ролью App developer ("To give a user in a merchant store access to the Dev Dashboard, assign them the App developer role" - документация Shopify), после чего создайте приложение, находясь в организации продавца. Одного доступа Collaborator недостаточно - приложения, созданные в вашей собственной организации, остаются закрепленными за ней.

1. Войдите в панель администратора Shopify
2. Перейдите в Settings > Apps
3. Нажмите Develop apps
4. На странице разработки приложений нажмите Build apps in 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: Найдите поддомен вашего магазина

Ваш поддомен - это часть URL перед .myshopify.com в адресе панели администратора Shopify. Например, если адрес панели администратора https://pizza-delicious.myshopify.com/admin, то ваш поддомен - pizza-delicious.

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

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

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

7. Нажмите Connect (Подключить)

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

Шаг 4: Настройте действия Shopify

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

Доступны два действия:

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

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

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

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

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

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

После активации действий откройте виджет чат-бота и попробуйте отправить:

• "Покажи кроссовки для бега" (проверка поиска товаров)
• "Какой статус у моего заказа #1001?" (проверка информации о заказе)

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

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

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

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

В завершение убедитесь, что включены действия ИИ, доступные для Shopify: детали заказа (Order details) и поиск товаров (Product Search).