Подключите ваш магазин Ecwid by Lightspeed к чатботу ChatLab. После подключения чатбот сможет искать ваши товары, индексировать весь каталог для AI Search и проверять статус заказов клиентов напрямую в магазине Ecwid.
Пример диалога
Проверить заказ
Требуется подключенный магазин и включенное действие для работы с заказами. Доступные поля зависят от интеграции. Совпадение адреса эл. почты не является подтверждением личности.
Посетитель: Где мой заказ?
Запустите пример или прочитайте его ниже. Реальные данные клиентов не используются.Клиент спрашивает о существующем заказе.
Воспроизведение приостанавливается, когда пример пропадает с экрана. Это симуляция, а не живой чат. Элементы управления виджетом во время воспроизведения неинтерактивны.Прочитать пример полностью
- Клиент спрашивает о существующем заказе.
Посетитель: Где мой заказ?
- По умолчанию для поиска требуются оба идентификатора.
Ассистент: Пожалуйста, укажите номер заказа и адрес эл. почты, использованный при оформлении.
- В этом примере используются вымышленные данные.
Посетитель: 41982, anna@example.com
- Действие отправляет запрос в подключенный магазин.
Проверяю заказ 41982...
- Сообщайте только те данные, которые вернул магазин.
Ассистент: Заказ 41982 отмечен как отправленный. Служба доставки - DPD. Статус доставки можно отслеживать на странице трекинга.
Этот пример демонстрирует взаимодействие с точки зрения покупателя. Доступные действия и возвращаемая информация зависят от данной интеграции и ваших настроек.
Важно: рекомендации для e-commerce
После завершения настройки интеграции ознакомьтесь с подробным руководством по оптимизации чатбота для интернет-магазинов: Как настроить ChatLab для вашего интернет-магазина
Возможности интеграции
AI product search - клиенты описывают то, что ищут, своими словами, а чатбот находит подходящие товары в вашем каталоге. Ответ содержит:
- Название и описание товара
- Текущую цену в валюте вашего магазина, а для товаров со скидкой - также стандартную цену и размер скидки
- Изображение товара
- Прямую ссылку на страницу товара в вашем магазине
- Наличие, артикул (SKU), категории и варианты товара (размеры, цвета), если они настроены
Поиск товаров по фразе - простой поиск по ключевым словам через встроенный поисковый движок Ecwid. AI product search автоматически заменяет его сразу после индексации каталога.
Статус заказа - клиент указывает номер заказа и адрес электронной почты, использованный при оформлении, а чатбот сообщает статус оплаты, статус выполнения, способ доставки, трек-номер и список заказанных позиций. Заказы всегда сопоставляются с e-mail клиента, поэтому угаданный номер заказа никогда не раскроет чужие данные.
Категории - чатбот может сузить область поиска до конкретной категории, используя дерево категорий вашего магазина.
Добавление в корзину - карточки товаров в чате могут содержать кнопку Add to cart (Добавить в корзину). Если чатбот работает на вашем Instant Site или на сайте, куда встроен магазин Ecwid, нажатие кнопки сразу добавляет товар в корзину Ecwid покупателя. Для товаров с вариантами (например, размер или цвет) клиент сначала выбирает нужный вариант прямо в чате. Во всех остальных случаях, а также для товаров с параметрами, которые нельзя заполнить в чате (например, текстовое поле для гравировки), кнопка открывает страницу товара.
Как выглядит работа с корзиной
Пример работы корзины и инструкции по тестированию на витрине см. в статье Добавление товаров в корзину. Приведенная ниже последовательность носит демонстрационный характер и не выполняет реальных операций с корзиной Ecwid.
Выберите вариант перед добавлением в корзину
Примерная последовательность: внешний вид кнопок корзины и выбора вариантов зависит от платформы и витрины магазина. В этой демонстрации действие с корзиной не выполняется.
Изумрудное платье с запахом, $79. Вискоза, длина миди.
Запустите пример или прочитайте его ниже. Реальные данные клиентов не используются.В поддерживаемых магазинах результаты поиска содержат карточку товара с кнопкой добавления в корзину.
Воспроизведение приостанавливается, когда пример пропадает с экрана. Это симуляция, а не живой чат. Элементы управления виджетом во время воспроизведения неинтерактивны.Прочитать пример полностью
- В поддерживаемых магазинах результаты поиска содержат карточку товара с кнопкой добавления в корзину.
Изумрудное платье с запахом, $79. Вискоза, длина миди.
- Покупатель выбирает товар и размер с помощью поддерживаемых элементов корзины.
Посетитель: Изумрудное платье с запахом, размер 38.
- Подтверждайте успешное действие только после того, как витрина магазина примет операцию с корзиной.
Ассистент: Пример результата: выбранный вариант добавлен в корзину вашего магазина.
- Оплата и оформление заказа остаются на стороне магазина.
Ассистент: Проверьте корзину в магазине, чтобы подтвердить количество, цену и условия доставки, а затем перейдите к оформлению заказа.
Ограничения интеграции
- Оформление заказа в чате. Покупатель завершает покупку непосредственно в вашем магазине Ecwid.
- Уведомления об остатках в реальном времени. Цены и наличие считываются из Ecwid в момент ответа чатбота, но чатбот не оповещает клиентов о последующих изменениях.
Требования
- Магазин Ecwid на тарифном плане Venture, Business или Unlimited. Ecwid открывает доступ к API начиная с плана Venture; подключить план Starter невозможно.
- Интеграция с Ecwid, включенная в ваш тарифный план ChatLab.
- Для поиска товаров через AI: достаточный лимит AI Search, выделенный чатботу, покрывающий количество включенных товаров. Проверить доступный объем можно в разделе Shop > Products (Магазин > Товары).
- Отсутствие других интеграций с магазинами у этого же чатбота.
Шаг 1: Получение Store ID и секретного токена в Ecwid
- Войдите в панель управления Ecwid.
- В левом меню нажмите Apps (Приложения), затем My Apps (Мои приложения) и перейдите в Develop apps (Разработка приложений) или откройте напрямую
https://my.ecwid.com/#develop-appsпосле авторизации. - Если пользовательские приложения еще не созданы, нажмите Create app (Создать приложение). Ecwid создаст приложение с правами, необходимыми чатботу: чтение профиля магазина, чтение каталога и чтение заказов. Если отображается список разрешений, убедитесь, что эти три пункта отмечены.
- Откройте страницу Details (Подробности) приложения и нажмите Show secret token (Показать секретный токен). Скопируйте токен. Он начинается с
secret_. Не используйте публичный токен, который начинается сpublic_. - Запишите ваш Store ID (Идентификатор магазина). Это число отображается в подвале каждой страницы панели Ecwid и в адресной строке браузера.
Храните секретный токен в тайне. Он предоставляет доступ к просмотру каталога и заказов. Вы можете отозвать его в любой момент, удалив приложение в разделе Apps > My Apps; повторная установка сгенерирует новый токен.
Шаг 2: Подключение магазина в ChatLab
- Откройте вашего чатбота в ChatLab и перейдите в Shop (Магазин).
- Нажмите на плитку Ecwid.
- Вставьте Store ID и Secret token.
- Нажмите Check connection (Проверить подключение). ChatLab считает профиль магазина и отобразит его название, адрес витрины и валюту.
- Если ваш магазин поддерживает несколько языков, выберите Shop Language (Язык магазина), который чатбот должен использовать для названий и описаний товаров.
- Нажмите Connect (Подключить).
ChatLab проверит соединение и активирует действия для поиска товаров и проверки статуса заказов. Если чатботу выделен лимит AI Search, индексация каталога начнется незамедлительно, о чем появится уведомление в окне подтверждения. Секретный токен сохраняется в зашифрованном виде и больше никогда не отображается; оставьте поле токена пустым, если вам нужно только изменить язык.
Шаг 3: Настройка действий
Перейдите в Settings > AI Actions (Настройки > AI Действия). Для Ecwid доступны три действия:
- Ecwid - AI product search - семантический поиск по проиндексированному каталогу. В его параметрах можно включить отображение полной карточки товара в ответе, ограничить результаты товарами в наличии и включить кнопку Add to cart.
- Ecwid - product search - поиск по ключевым словам через поисковый механизм Ecwid, используемый, когда AI Search недоступен для чатбота. Его также можно ограничить товарами в наличии и включить кнопку Add to cart.
- Ecwid - order details - проверка статуса заказа. В настройках действия доступны ограничение частоты запросов и маскирование персональных данных.
У каждого действия есть редактируемый prompt и метка действия, которая отображается в чате во время обработки запроса.
Шаг 4: Проверка каталога
Откройте Training > E-commerce catalog (Обучение > Каталог e-commerce), чтобы отслеживать прогресс индексации, просматривать проиндексированные товары и запускать переобучение каталога после крупных изменений в магазине. Повторно индексируются только те товары, которые изменились со времени последней проверки. Отключенные товары автоматически удаляются из индекса.
Товары без описания индексируются только по названию, категориям и атрибутам. Если у ваших товаров в Ecwid нет описаний, добавление даже краткого текста заметно улучшит результаты поиска.
Шаг 5. Добавьте чат-бота на витрину магазина
Интеграция с Ecwid связывает чат-бота с данными вашего магазина. Чтобы показывать чат-бота покупателям, добавьте скрипт ChatLab на сайт, где размещен магазин:
Instant Site (требуется тарифный план Venture, Business или Unlimited):
- В ChatLab откройте своего чат-бота, перейдите в раздел Test & Deploy (Тестирование и развертывание), выберите Ecwid и скопируйте код.
- В панели управления Ecwid перейдите в Website > Overview (Сайт > Обзор).
- Прокрутите вниз до Advanced website settings (Расширенные настройки сайта) и нажмите Add Code (Добавить код) в блоке Custom JavaScript code (Пользовательский код JavaScript).
- Вставьте код в открывшееся поле и нажмите Save (Сохранить).
- Обновите страницу вашего Instant Site - чат-бот появится в нижнем углу на каждой странице.
Ecwid рекомендует использовать секцию body (Custom JavaScript code) для виджетов чата. Не используйте поле Header meta tags and site verification (Метатеги заголовка и подтверждение сайта) в настройках SEO - оно предназначено только для тегов верификации.
Магазин, встроенный на сторонний сайт (WordPress, Wix, Squarespace и другие): добавьте код на этот сайт в точности так, как описано в руководстве Добавление чат-бота на ваш сайт. После этого чат-бот появится на всех страницах этого сайта, а не только на странице магазина.
Устранение неполадок
- "Ecwid rejected the secret token" - токен был скопирован не полностью, либо приложение было удалено или переустановлено в Ecwid, из-за чего сгенерировался новый токен. Снова откройте страницу Details приложения и вставьте актуальный токен.
- "The Ecwid store plan does not include API access" - магазин использует тарифный план Starter. Перейдите на план Venture или выше в Ecwid.
- Чатбот не находит товары - проверьте статус индексации в Training > E-commerce catalog и убедитесь, что товары включены в Ecwid. Отключенные товары никогда не возвращаются в результатах.
- Заказ не найден - чатботу требуется адрес электронной почты, указанный при оформлении заказа, вместе с номером заказа из письма с подтверждением, включая любые префиксы или суффиксы, которые ваш магазин добавляет к номерам заказов.