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

Інтеграція з 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

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

Що надає інтеграція

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

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

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

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

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

Додавання до кошика - картки товарів у чаті можуть містити кнопку 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 - пошук статусу замовлення. У налаштуваннях дії доступні обмеження частоти запитів та маскування персональних даних.

Кожна дія має поле промпту, яке можна редагувати, а також назву дії, що показується в чаті під час роботи чатбота.

Крок 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. Вимкнені товари ніколи не повертаються у результатах.
  • Замовлення не знайдено - чатботу потрібна адреса електронної пошти, використана під час оформлення покупки, разом із номером замовлення, вказаним у листі з підтвердженням, включно з будь-яким префіксом або суфіксом, який ваш магазин додає до номерів замовлень.