Центр допомоги
Інтеграції чатбота

Інтеграція з BigCommerce

Останнє оновлення:

Підключіть свій магазин BigCommerce до чатбота ChatLab. Після підключення чатбот шукає ваші товари, індексує весь каталог для AI Search, дозволяє покупцям додавати товари до кошика безпосередньо з чату та перевіряє статус їхніх замовлень безпосередньо у вашому магазині.

Приклад розмови

Подивіться, як це працює в розмові

Перевірити замовлення

Потрібно підключити магазин і ввімкнути дію замовлення. Доступні поля залежать від інтеграції. Збіг адреси електронної пошти не є підтвердженням особи.

Приклад ChatLabПоказова розмова

Відвідувач: Де моє замовлення?

Запустіть приклад або прочитайте його нижче. Справжні дані клієнтів не використовуються.
1 / 5

Клієнт запитує про наявне замовлення.

Відтворення призупиняється, коли цей приклад зникає з екрана. Це симуляція, а не живий чат. Елементи керування віджетом під час відтворення не є інтерактивними.
Прочитати приклад повністю
  1. Клієнт запитує про наявне замовлення.

    Відвідувач: Де моє замовлення?

  2. Для стандартного пошуку потрібні обидва ідентифікатори.

    Асистент: Будь ласка, вкажіть номер замовлення та адресу електронної пошти, зазначену під час оформлення.

  3. Використовуйте вигадані дані в цьому прикладі.

    Відвідувач: 41982, anna@example.com

  4. Дія надсилає запит до підключеного магазину.

    Перевіряю замовлення 41982...

  5. Повідомляйте лише ту інформацію, яку надав магазин.

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

Цей приклад ілюструє взаємодію з клієнтом. Доступні дії та надана інформація залежать від цієї інтеграції та ваших налаштувань.

Важливо: рекомендації щодо електронної комерції

Після завершення інтеграції нижче ознайомтеся з докладним посібником щодо оптимізації чатбота для електронної комерції: Як налаштувати ChatLab для вашого інтернет-магазину

Що забезпечує інтеграція

AI-пошук товарів - клієнти описують потрібне власними словами, а чатбот знаходить відповідні товари у вашому каталозі. Відповідь містить:

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

Пошук товарів за фразою - простий пошук за ключовими словами у вашому каталозі BigCommerce. AI-пошук товарів автоматично замінює його після завершення індексації каталогу.

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

Додавання до кошика - картки товарів у чаті можуть відображати кнопку 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-пошуку товарів: виділений обсяг AI Search для чатбота, достатній для всіх ваших видимих товарів. Перевірте доступний обсяг у розділі Shop > Products (Магазин > Товари).
  • Відсутність інших підключених інтеграцій магазинів для цього ж чатбота.

Оберіть один із двох способів нижче. Обидва ведуть до однакового результату.

Варіант A: Встановлення застосунка ChatLab

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

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

Видалення застосунка в BigCommerce вимикає інтеграцію в ChatLab і видаляє віджет чату з вашої вітрини. Чатбот та історія його розмов залишаються у вашому обліковому записі ChatLab.

Варіант B: Підключення за допомогою облікового запису 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 (Налаштування > Дії AI). Для 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, створіть новий обліковий запис із цим дозволом і підключіться знову або додайте віджет власноруч:

  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." (Не вдалося підключитися до магазину BigCommerce. Перевірте хеш магазину та токен доступу.) - токен скопійовано неповністю, обліковий запис API видалено або хеш належить іншому магазину. Скопіюйте обидва значення ще раз із файлу, завантаженого BigCommerce під час створення облікового запису API.
  • Віджет чату не додано автоматично - обліковий запис API не має доступу на внесення змін до Content. Створіть новий обліковий запис API з відповідними правами та виконайте підключення знову або додайте віджет у Script Manager, як описано вище.
  • Чатбот не з'являється на вітрині - переконайтеся, що скрипт є у списку в Storefront > Script Manager. Якщо у вашому магазині використовується банер згоди на використання файлів cookie, віджет завантажується лише після того, як відвідувач прийме категорію Functional.
  • Чатбот не знаходить товари - перевірте стан індексації в Training > E-commerce catalog і переконайтеся, що товари відкриті для відображення у вашому магазині.
  • Замовлення не знайдено - чатботу потрібна електронна пошта, використана під час оформлення замовлення, разом із номером замовлення, вказаним у листі з підтвердженням.
  • Додавання до кошика відкриває сторінку товару - товар має обов'язковий параметр, який неможливо вибрати в чаті (наприклад, текстове поле), або чатбот працює за межами вашої вітрини BigCommerce.