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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Что предоставляет интеграция

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

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

Поиск товаров по фразе - простой поиск по ключевым словам в вашем каталоге BigCommerce. Поиск товаров с помощью ИИ заменяет его автоматически сразу после завершения индексации каталога.

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

Добавление в корзину - карточки товаров в чате могут содержать кнопку Add to cart (Добавить в корзину). На витрине вашего магазина BigCommerce эта кнопка помещает товар прямо в корзину клиента, а счетчик корзины в шапке страницы обновляется. Для товаров с вариантами (например, размер или цвет) клиент сначала выбирает нужный вариант в чате. Для товаров с параметрами, которые нельзя заполнить в чате (например, обязательное текстовое поле для гравировки), кнопка открывает страницу товара.

Виджет чата на вашей витрине - ChatLab самостоятельно добавляет виджет чата на вашу витрину через BigCommerce Script Manager, поэтому вам не придется вручную вставлять код.

Пример работы с корзиной

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Что интеграция не предоставляет

  • Оформление заказа в чате. Клиент завершает покупку в вашем магазине BigCommerce.
  • Уведомления об остатках в реальном времени. Цены и наличие считываются из BigCommerce в момент ответа чат-бота, но чат-бот не уведомляет клиентов о последующих изменениях.
  • Добавление в корзину на headless-витринах. Кнопка добавления в корзину работает на витринах, созданных на базе тем BigCommerce. На headless-витрине она открывает страницу товара, а виджет чата необходимо добавить на такой сайт вручную.

Требования

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

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

Вариант А: Установка приложения ChatLab

  1. В панели управления BigCommerce перейдите в Apps (Приложения), найдите ChatLab и нажмите Install (Установить).
  2. Проверьте разрешения и нажмите Confirm (Подтвердить). ChatLab запрашивает доступ только для чтения к товарам, заказам, клиентам и информации о магазине, а также доступ к контенту витрины для добавления виджета чата.
  3. Страница ChatLab откроется внутри вашей панели управления. Нажмите Continue setup (Продолжить настройку). Процесс подключения ChatLab откроется в новой вкладке браузера.
  4. Войдите в свою учетную запись ChatLab или создайте новую, если у вас ее еще нет.
  5. Выберите существующего чат-бота или создайте нового для этого магазина.

На этом все. ChatLab подключит магазин к выбранному чат-боту, включит действия поиска товаров и проверки статуса заказов, начнет индексировать каталог и добавит виджет чата на вашу витрину. Вы можете открыть ChatLab снова в любое время из меню Apps в вашей панели управления.

Удаление приложения в BigCommerce отключает интеграцию в ChatLab и удаляет виджет чата с вашей витрины. Ваш чат-бот и история диалогов сохраняются в вашей учетной записи ChatLab.

Вариант Б: Подключение через учетную запись API на уровне магазина

Используйте этот вариант, если вы предпочитаете настроить доступ самостоятельно или хотите подключить чат-бота без установки приложения.

Шаг 1: Создание учетной записи API в BigCommerce

  1. В панели управления BigCommerce перейдите в Settings (Настройки), затем в Store-level API accounts (Учетные записи API на уровне магазина).
  2. Нажмите Create API account (Создать учетную запись API) и укажите имя, например ChatLab.
  3. Настройте права доступа:
    • Products (Товары) - только чтение (read-only)
    • Orders (Заказы) - только чтение (read-only)
    • Customers (Клиенты) - только чтение (read-only)
    • Information & settings (Информация и настройки) - только чтение (read-only)
    • Content (Контент) - изменение (modify)
  4. Нажмите Save (Сохранить). BigCommerce покажет учетные данные один раз и скачает их в виде текстового файла.
  5. Скопируйте API path (Путь к API) и Access token (Токен доступа).

Путь к API выглядит как api.bigcommerce.com/stores/abc123/v3/. Часть между stores/ и /v3/ - это хэш вашего магазина (store hash).

Храните токен доступа в тайне. Вы можете отозвать его в любой момент, удалив учетную запись API в BigCommerce.

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

  1. Откройте вашего чат-бота в ChatLab и перейдите в раздел Shop (Магазин).
  2. Нажмите на плитку BigCommerce.
  3. Вставьте путь к API (или только хэш магазина) в поле Store hash or API path (Хэш магазина или путь к API), а токен - в поле Access token (Токен доступа).
  4. Нажмите Check connection (Проверить подключение). ChatLab считает профиль магазина и отобразит название магазина, адрес витрины и валюту.
  5. Нажмите Connect (Подключить).

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

Настройка действий

Перейдите в Settings > AI Actions (Настройки > Действия ИИ). Для BigCommerce доступны три действия:

  • BigCommerce - AI product search - семантический поиск по проиндексированному каталогу. В его настройках можно включить отображение полной карточки товара в ответе, ограничить результаты товарами в наличии и включить кнопку Add to cart.
  • BigCommerce - product search - поиск по ключевым словам в каталоге BigCommerce, используемый в случаях, когда AI Search недоступен для чат-бота. Его также можно ограничить товарами в наличии и включить кнопку Add to cart.
  • BigCommerce - order details - проверка статуса заказа. В настройках действия доступны ограничение частоты запросов и маскирование персональных данных.

У каждого действия есть редактируемый промпт и метка действия, которая отображается в чате во время работы чат-бота.

Проверка каталога

Откройте Training > E-commerce catalog (Обучение > Каталог e-commerce), чтобы следить за процессом индексации, просматривать проиндексированные товары и запускать повторное обучение каталога после масштабных изменений в магазине. Товары, скрытые на витрине вашего магазина, не индексируются.

Товары без описания индексируются только по названию, бренду, категориям и характеристикам. Если у ваших товаров в BigCommerce нет описаний, добавление хотя бы краткого текста заметно улучшит результаты поиска.

Если вы также обучаете чат-бота на страницах вашего сайта, ChatLab распознает магазин BigCommerce и пропустит страницы товаров, категорий и брендов. Данные о товарах поступают из каталога, поэтому считывать их со страниц повторно не требуется.

Виджет чата на вашей витрине

Если магазин подключен через приложение или через учетную запись API с правами на изменение раздела Content, ChatLab добавит виджет автоматически. Вы можете увидеть его в разделе Storefront > Script Manager (Витрина > Менеджер скриптов) под именем ChatLab chatbot. Он размещается в футере всех страниц витрины в категории согласия Functional (Функциональные) и удаляется при отключении магазина.

Если учетная запись API была создана без доступа к Content, создайте новую учетную запись API с необходимыми правами и подключитесь снова либо добавьте виджет вручную:

  1. В ChatLab откройте вашего чат-бота, перейдите в Test & Deploy (Тестирование и развертывание), выберите BigCommerce и скопируйте код.
  2. В панели управления BigCommerce перейдите в Storefront > Script Manager.
  3. Нажмите Create a Script (Создать скрипт) и укажите название, например ChatLab.
  4. Установите Placement (Размещение) на Footer (Футер), Location (Расположение) на Storefront pages (Страницы витрины), а Script category (Категория скрипта) на Functional.
  5. Выберите Script type (Тип скрипта) Script и вставьте код в поле Script contents (Содержимое скрипта).
  6. Нажмите Save (Сохранить) и обновите страницу витрины. Чат-бот появится в нижнем углу каждой страницы.

Устранение неполадок

  • "Failed to connect to the BigCommerce store. Check the store hash and the access token." - токен скопирован не полностью, учетная запись API была удалена или хэш магазина принадлежит другому магазину. Скопируйте оба значения заново из файла, скачанного BigCommerce при создании учетной записи API.
  • Виджет чата не добавился автоматически - у учетной записи API нет прав на изменение раздела Content. Создайте новую учетную запись API с этим доступом и выполните подключение заново либо добавьте виджет вручную через Script Manager, как описано выше.
  • Чат-бот не появляется на витрине - убедитесь, что скрипт присутствует в списке в разделе Storefront > Script Manager. Если в вашем магазине используется баннер согласия на использование файлов cookie, виджет загрузится после того, как посетитель примет категорию Functional.
  • Чат-бот не находит товары - проверьте статус индексации в Training > E-commerce catalog и убедитесь, что товары доступны для просмотра в вашем магазине.
  • Заказ не найден - чат-боту требуется адрес электронной почты, указанный при оформлении, вместе с номером заказа из письма с подтверждением.
  • Нажатие на кнопку добавления в корзину открывает страницу товара - у товара есть обязательный параметр, который нельзя выбрать в чате (например, текстовое поле), либо чат-бот запущен за пределами витрины BigCommerce.