Интеграция с Shopify: AI Search, търсене в магазина в реално време и статус на поръчка

Свържете Вашия ChatLab чатбот с Вашия Shopify магазин, за да могат клиентите да намират продукти и да проверяват поръчките си директно в чата. Продуктите се намират чрез търсене с изкуствен интелект (AI Search), което претърсва Вашия индексиран Shopify каталог по значение, или чрез търсене в магазина на живо, което изпраща заявки към API на магазина.

Пример за разговор

Примерът илюстрира потребителското изживяване. Наличните действия и върнатата информация зависят от тази интеграция и от Вашата конфигурация.

Преди да започнете

Първо създайте или изберете чатбот. Нуждаете се от разрешение за управление на неговите интеграции и от достъп до настройките за връзка на външния акаунт. Ако плочката Свързване (Connect) показва съобщение за надграждане на плана или за контакт, проверете дали абонаментът Ви включва тази интеграция. Пазете данните за достъп до API поверителни - никога не ги поставяйте в кода за вграждане (embed код) на уебсайта.

Важно: Най-добри практики за електронна търговия

След като завършите интеграцията по-долу, прочетете подробното ръководство за оптимизиране на Вашия чатбот за електронна търговия: Как да настроите ChatLab за Вашия e-commerce магазин

Как чатботът намира продукти в Shopify: AI Search и търсене на живо в магазина

Има два начина, по които чатботът на ChatLab намира продукти в магазин на Shopify. Чатботът използва единия или другия, никога и двата едновременно.

AI Search (препоръчително) - ChatLab поддържа собствен индекс на Вашия каталог в Shopify, а чатботът търси в него по смисъл.

• Клиентите питат на естествен език, например „червена рокля под 300“. Ценовият диапазон се прилага като строг филтър, като се съпоставят и точните продуктови кодове (SKU, EAN).
• Цената, наличността и вариантите се четат на живо от Shopify в момента на отговора, така че клиентите виждат актуални данни дори между опресняванията на индекса.
• Резултатите се показват като продуктови карти в чата, до 5 на отговор.
• Индексирането започва автоматично при свързване на магазина. Каталогът не използва символи за обучение.
• Необходим план: всеки план E-commerce го включва (Free 100 продукта, Start 2 000, Grow 5 000, Scale 20 000). При план Universal добавете добавката E-commerce integrations ($30 на месец) плюс продуктов пакет за AI Search ($29 на месец, 5 000 продукта), назначен към чатбота.

Търсене на живо в магазина - чатботът предава фразата на клиента към търсачката на Shopify чрез API на магазина и отговаря с това, което магазинът връща.

• Нищо не се индексира и не е необходимо да се синхронизира. Данните винаги са в реално време.
• Това е търсене по ключови думи: намира това, което собственото търсене на магазина би намерило за тази фраза. То не разбира описания на нужди, синоними или печатни грешки по начина, по който го прави AI Search.
• Необходим план: план Universal с добавката E-commerce integrations ($30 на месец). Не е необходим продуктов пакет.

Когато AI Search е включен, той заменя търсенето на живо в магазина. Проверката на статуса на поръчката работи по един и същи начин и при двата подхода. Трета опция, обучение чрез сканирани страници на магазина, е налична при всеки план и е предназначена за информационно съдържание като доставка и връщане, а не за продукти. За пълно сравнение вижте AI Search: как Вашият чатбот намира продукти, а за лимитите на продуктите вижте Планове и лимити за E-commerce.

Какво предоставя интеграцията

Търсене в реално време в магазина (търсене на продукти по фраза) - Чатботът изпраща фразата на клиента към търсачката на Shopify. Той търси в заглавията, описанията, типовете, етикетите и производителите на продуктите, като връща съответстващи активни продукти с:

• Име, описание и тип на продукта
• Производител и етикети
• Цена или ценови диапазон (за продукти с множество варианти)
• Налични варианти със SKU, цена за сравнение, налично количество и статус на наличност
• Изображение на продукта и директна връзка към Вашия магазин

Можете да настроите търсенето на продукти да показва само налични артикули. Когато функцията е активирана, изчерпаните артикули се изключват от резултатите. Допълнителна опция Ви позволява да включите продукти, налични за предварителна поръчка, дори когато филтърът за наличност е активен. Вижте Стъпка 4 за подробности.

Детайли за поръчката - По подразбиране клиентите предоставят номера на поръчката си и съответстващия имейл адрес. Допълнителните режими позволяват търсене само по номер на поръчката или търсене на скорошни поръчки само по имейл. Това са съвпадения на данни, а не доказателство за самоличността на посетителя. Чатботът връща:

• Номер на поръчката, дата, обща сума и валута
• Поръчани артикули с имена, количества, цени, SKU, име на варианта и производител
• Статус на изпълнение и информация за проследяване (номер, куриер, URL)
• Адрес за доставка и адрес за фактуриране
• Метод на доставка и цена
• Данни за контакт с клиента (имейл, име, телефон)
• Причина и дата на анулиране (за анулирани поръчки)

Стъпка 1: Създаване на идентификационни данни за Shopify API

Важно за агенции и партньори на Shopify: Създайте и инсталирайте приложението в организацията, която притежава магазина. Връзката на ChatLab чрез Client ID и Secret използва механизма за предоставяне на клиентски идентификационни данни (client credentials grant) на Shopify, който не поддържа приложение, притежавано от друга организация. Ако видите съобщението „The app cannot access this store“, проверете организацията на приложението и инсталацията, преди да подменяте данните за достъп. Вижте изискванията на Shopify за клиентски идентификационни данни.

1. Влезте във Вашия административен панел на Shopify
2. Отидете на Settings > Apps (Настройки > Приложения)
3. Кликнете върху Develop apps
4. На страницата App Development кликнете върху Build apps in Dev Dashboard - това отваря dev.shopify.com/dashboard
5. Кликнете върху Create app и въведете име (напр. „ChatLab Integration“)

6. След създаването превъртете до секцията Access и кликнете върху Select scopes

7. Под обхватите на достъп за Admin API намерете и активирайте следните разрешения:
   • read_products
   • read_orders
8. Кликнете върху Done

9. Кликнете върху бутона Release, за да публикувате Вашето приложение
10. Отидете на App settings и копирайте Client ID и Secret - съхранявайте ги сигурно, ще Ви трябват за връзка с ChatLab

11. Отидете в секцията Home и кликнете, за да инсталирате приложението във Вашия магазин

12. Изберете Вашия магазин и потвърдете, като кликнете върху Install

Стъпка 2: Намерете поддомейна на Вашия магазин

Намерете домейна myshopify.com на магазина в Settings > Domains (Настройки > Домейни) в Shopify, след което въведете само частта преди .myshopify.com. За pizza-delicious.myshopify.com въведете pizza-delicious, а не Вашия персонализиран домейн на магазина или URL адреса на таблото за управление admin.shopify.com. Вижте ръководството за домейни на Shopify.

Стъпка 3: Свързване на Shopify в ChatLab

1. Влезте в ChatLab и изберете Вашия бот
2. Отидете в раздела Connect (Свързване)

3. Кликнете върху Connect на плочката за Shopify
4. Въведете Вашия Client ID (от Стъпка 1)
5. Въведете Вашия Secret (от Стъпка 1)
6. Въведете Вашия поддомейн на Shopify (от Стъпка 2)

7. Кликнете върху Connect

ChatLab автоматично тества връзката, като проверява дали Вашите API идентификационни данни имат необходимите нива на достъп (scopes). При успех ще видите съобщение за потвърждение.

Стъпка 4: Конфигурирайте действията на Shopify (Shopify Actions)

След като се свържете, можете да активирате и персонализирате отделни AI действия. Отидете на Settings > Actions (Настройки > Действия) и филтрирайте по платформата Shopify.

Стандартните действия включват:

• Shopify - product search - позволява на чатбота да търси във Вашия продуктов каталог
• Shopify - order details - позволява на чатбота да проверява информация за поръчки

Настройването на връзката активира стандартните действия. Прегледайте състоянието им и деактивирайте тези, които не желаете клиентите да използват. Отворете дадено действие, за да го редактирате, след което използвайте Enable (Активиране) или Update (Обновяване) в неговия диалогов прозорец. Можете също така да персонализирате етикета на действието (съобщението, което се показва на потребителите, докато действието се изпълнява) и инструкциите, които определят как AI да използва всяко действие.

Product Search - Inventory Settings (Търсене на продукти - Настройки на наличностите)

Действието за търсене на продукти включва опции за филтриране по наличност в раздела Product Search Settings (Настройки за търсене на продукти):

• Products in stock only (Само налични продукти) - Когато е активирано, чатботът връща само продукти, които в момента са налични на склад. Продуктите с изчерпана наличност се изключват от резултатите от търсенето.
• Show products available for pre-order (Показване на продукти, налични за предварителна поръчка) - Тази опция се появява, когато е активирана опцията "Products in stock only". Когато е активна, продуктите, които са с изчерпана наличност, но са конфигурирани в Shopify да продължат да се продават (предварителна поръчка), пак ще се показват в резултатите от търсенето, обозначени като налични за предварителна поръчка.

Поверителност при справка за поръчка

В раздела Order Lookup Configuration (Конфигурация за търсене на поръчки) на действието за поръчки опциите Allow order lookup without email verification (Разрешаване на търсене на поръчка без потвърждение по имейл) и Allow order lookup by email address only (Разрешаване на търсене на поръчка само по имейл адрес) са изключени по подразбиране. Режимът само по имейл връща по подразбиране 1 скорошна поръчка, като това може да се конфигурира от 1 до 3. Активирането на търсене само по идентификатор изключва режима само по имейл. Всеки, който знае избрания идентификатор за търсене, може да получи информация за поръчката, затова прегледайте контрола на достъпа и маскирането на лични данни (PII), преди да активирате някоя от тези опции.

AI Search за Shopify: Каталог, преиндексиране и настройки

При план E-commerce или при план Universal, когато към чатбота е присвоен продуктов пакет AI Search, функцията AI Search е включена и заменя търсенето в реално време в магазина. Индексирането започва автоматично при свързване на магазина.

• Проверете каталога - отворете Training > E-commerce catalog (Обучение > Каталог за e-commerce) и прегледайте разделите Products (Продукти) и Categories (Категории). В Shop > Products (Магазин > Продукти) се виждат панелът Product catalog (Продуктов каталог) и картата AI Search packs on this chatbot (Пакети AI Search на този чатбот).
• Планирайте преиндексиране - използвайте Schedule auto-retrain (График за автоматично повторно обучение) в Training > E-commerce catalog (Обучение > Каталог за e-commerce). Преиндексирането може да се изпълнява ежедневно и е налично при всеки план E-commerce, както и с всеки продуктов пакет. Бутонът Train now (Обучи сега) или Retrain (Обучи отново) го стартира при поискване. Обновяванията са инкрементални: непроменените продукти се пропускат, а премахнатите продукти се изтриват от индекса.
• Прегледайте действието - в Settings > Actions (Настройки > Действия) отворете Shopify - AI product search. Опциите му са Include product card (Включи продуктова карта), Products in stock only (Само налични продукти) и Number of products to return (Брой продукти за връщане).
• Показвайте карти с продукти - включете Enable Offer Cards (Активирай Offer Cards) в Settings > Model & Advanced (Настройки > Модел и разширени). Вижте Offer Cards.

Когато каталогът надвишава лимита за продукти, индексирането спира при достигане на лимита и собственикът на чатбота получава имейл. Опциите на описаното по-горе действие за търсене в реално време в магазина не се прилагат задължително за AI Search.

Тестване на интеграцията

След като активирате действията, отворете Overview (Общ преглед) и опитайте:

• "Покажете ми обувки за бягане" (тества търсенето на продукти)
• "Какъв е статусът на поръчката ми #1001?" (тества детайлите за поръчката; въведете съответния имейл адрес за поръчка, до която имате разрешен достъп)

Уверете се, че отговорите съответстват на данните от Вашия магазин в Shopify и че връзките към продуктите се отварят правилно.

Инсталирайте чатбот във Вашия Shopify магазин

За да добавите уиджета за чат към витрината на Вашия магазин в Shopify:

1. В ChatLab отидете в раздела Deploy (Внедряване) за Вашия бот
2. Изберете раздела за платформата Shopify
3. Изберете Widget и копирайте кодовия фрагмент
4. В административния панел на Shopify отидете в Online Store > Themes (Онлайн магазин > Теми)
5. Кликнете върху менюто с три точки на Вашата активна тема и изберете Edit code (Редактиране на код)
6. Отворете файла theme.liquid в секцията Layout
7. Поставете кодовия фрагмент в секцията <head>
8. Кликнете върху Save (Запазване)

Отворете публикуваната витрина на магазина, за да потвърдите, че уиджетът се зарежда. API връзката и инсталацията на витрината на магазина са отделни процеси; прегледайте активираните действия в Settings > Actions (Настройки > Действия).

Свързани статии

• AI Search: как Вашият чатбот намира продукти
• Планове и лимити за e-commerce
• Ръководство за настройка на e-commerce
• Добавяне на чатбот към Вашия уебсайт