Центр помощи
Интеграции чат-бота

Интеграция с Ecwid by Lightspeed

Последнее обновление:

Подключите ваш магазин Ecwid by Lightspeed к чатботу ChatLab. После подключения чатбот сможет искать ваши товары, индексировать весь каталог для AI Search и проверять статус заказов клиентов напрямую в магазине Ecwid.

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

Посмотрите на примере диалога

Проверить заказ

Требуется подключенный магазин и включенное действие для работы с заказами. Доступные поля зависят от интеграции. Совпадение адреса эл. почты не является подтверждением личности.

Пример ChatLabНаглядный диалог

Посетитель: Где мой заказ?

Запустите пример или прочитайте его ниже. Реальные данные клиентов не используются.
1 / 5

Клиент спрашивает о существующем заказе.

Воспроизведение приостанавливается, когда пример пропадает с экрана. Это симуляция, а не живой чат. Элементы управления виджетом во время воспроизведения неинтерактивны.
Прочитать пример полностью
  1. Клиент спрашивает о существующем заказе.

    Посетитель: Где мой заказ?

  2. По умолчанию для поиска требуются оба идентификатора.

    Ассистент: Пожалуйста, укажите номер заказа и адрес эл. почты, использованный при оформлении.

  3. В этом примере используются вымышленные данные.

    Посетитель: 41982, anna@example.com

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

    Проверяю заказ 41982...

  5. Сообщайте только те данные, которые вернул магазин.

    Ассистент: Заказ 41982 отмечен как отправленный. Служба доставки - DPD. Статус доставки можно отслеживать на странице трекинга.

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

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

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

Возможности интеграции

AI product search - клиенты описывают то, что ищут, своими словами, а чатбот находит подходящие товары в вашем каталоге. Ответ содержит:

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

Поиск товаров по фразе - простой поиск по ключевым словам через встроенный поисковый движок Ecwid. AI product search автоматически заменяет его сразу после индексации каталога.

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

Категории - чатбот может сузить область поиска до конкретной категории, используя дерево категорий вашего магазина.

Добавление в корзину - карточки товаров в чате могут содержать кнопку Add to cart (Добавить в корзину). Если чатбот работает на вашем Instant Site или на сайте, куда встроен магазин Ecwid, нажатие кнопки сразу добавляет товар в корзину Ecwid покупателя. Для товаров с вариантами (например, размер или цвет) клиент сначала выбирает нужный вариант прямо в чате. Во всех остальных случаях, а также для товаров с параметрами, которые нельзя заполнить в чате (например, текстовое поле для гравировки), кнопка открывает страницу товара.

Как выглядит работа с корзиной

Пример работы корзины и инструкции по тестированию на витрине см. в статье Добавление товаров в корзину. Приведенная ниже последовательность носит демонстрационный характер и не выполняет реальных операций с корзиной Ecwid.

Посмотрите на примере диалога

Выберите вариант перед добавлением в корзину

Примерная последовательность: внешний вид кнопок корзины и выбора вариантов зависит от платформы и витрины магазина. В этой демонстрации действие с корзиной не выполняется.

Пример ChatLabНаглядный диалог

Изумрудное платье с запахом, $79. Вискоза, длина миди.

Запустите пример или прочитайте его ниже. Реальные данные клиентов не используются.
1 / 4

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

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

    Изумрудное платье с запахом, $79. Вискоза, длина миди.

  2. Покупатель выбирает товар и размер с помощью поддерживаемых элементов корзины.

    Посетитель: Изумрудное платье с запахом, размер 38.

  3. Подтверждайте успешное действие только после того, как витрина магазина примет операцию с корзиной.

    Ассистент: Пример результата: выбранный вариант добавлен в корзину вашего магазина.

  4. Оплата и оформление заказа остаются на стороне магазина.

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

Ограничения интеграции

  • Оформление заказа в чате. Покупатель завершает покупку непосредственно в вашем магазине Ecwid.
  • Уведомления об остатках в реальном времени. Цены и наличие считываются из Ecwid в момент ответа чатбота, но чатбот не оповещает клиентов о последующих изменениях.

Требования

  • Магазин Ecwid на тарифном плане Venture, Business или Unlimited. Ecwid открывает доступ к API начиная с плана Venture; подключить план Starter невозможно.
  • Интеграция с Ecwid, включенная в ваш тарифный план ChatLab.
  • Для поиска товаров через AI: достаточный лимит AI Search, выделенный чатботу, покрывающий количество включенных товаров. Проверить доступный объем можно в разделе Shop > Products (Магазин > Товары).
  • Отсутствие других интеграций с магазинами у этого же чатбота.

Шаг 1: Получение Store ID и секретного токена в Ecwid

  1. Войдите в панель управления Ecwid.
  2. В левом меню нажмите Apps (Приложения), затем My Apps (Мои приложения) и перейдите в Develop apps (Разработка приложений) или откройте напрямую https://my.ecwid.com/#develop-apps после авторизации.
  3. Если пользовательские приложения еще не созданы, нажмите Create app (Создать приложение). Ecwid создаст приложение с правами, необходимыми чатботу: чтение профиля магазина, чтение каталога и чтение заказов. Если отображается список разрешений, убедитесь, что эти три пункта отмечены.
  4. Откройте страницу Details (Подробности) приложения и нажмите Show secret token (Показать секретный токен). Скопируйте токен. Он начинается с secret_. Не используйте публичный токен, который начинается с public_.
  5. Запишите ваш Store ID (Идентификатор магазина). Это число отображается в подвале каждой страницы панели Ecwid и в адресной строке браузера.

Храните секретный токен в тайне. Он предоставляет доступ к просмотру каталога и заказов. Вы можете отозвать его в любой момент, удалив приложение в разделе Apps > My Apps; повторная установка сгенерирует новый токен.

Шаг 2: Подключение магазина в ChatLab

  1. Откройте вашего чатбота в ChatLab и перейдите в Shop (Магазин).
  2. Нажмите на плитку Ecwid.
  3. Вставьте Store ID и Secret token.
  4. Нажмите Check connection (Проверить подключение). ChatLab считает профиль магазина и отобразит его название, адрес витрины и валюту.
  5. Если ваш магазин поддерживает несколько языков, выберите Shop Language (Язык магазина), который чатбот должен использовать для названий и описаний товаров.
  6. Нажмите 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):

  1. В ChatLab откройте своего чат-бота, перейдите в раздел Test & Deploy (Тестирование и развертывание), выберите Ecwid и скопируйте код.
  2. В панели управления Ecwid перейдите в Website > Overview (Сайт > Обзор).
  3. Прокрутите вниз до Advanced website settings (Расширенные настройки сайта) и нажмите Add Code (Добавить код) в блоке Custom JavaScript code (Пользовательский код JavaScript).
  4. Вставьте код в открывшееся поле и нажмите Save (Сохранить).
  5. Обновите страницу вашего 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. Отключенные товары никогда не возвращаются в результатах.
  • Заказ не найден - чатботу требуется адрес электронной почты, указанный при оформлении заказа, вместе с номером заказа из письма с подтверждением, включая любые префиксы или суффиксы, которые ваш магазин добавляет к номерам заказов.