Свържете Вашия ChatLab чатбот с Вашия Shopify магазин, за да предоставите на клиентите си достъп в реално време до информация за продукти и проследяване на поръчки директно в чата.
Важно: Най-добри практики за електронна търговия
След като завършите интеграцията по-долу, прочетете подробното ръководство за оптимизиране на Вашия чатбот за електронна търговия: How to set up ChatLab for your E-commerce store
Какво предоставя интеграцията
Product Search - Клиентите могат да търсят във Вашия Shopify каталог чрез въвеждане на фраза. Чатботът търси в заглавията, описанията, типовете продукти, етикетите (tags) и доставчиците (vendors), като връща съответстващи активни продукти с:
- Име на продукта, описание и тип
- Доставчик и етикети
- Цена или ценови диапазон (за продукти с множество варианти)
- Налични варианти със SKU, цена за сравнение (compare-at price), складова наличност и статус на наличност
- Изображение на продукта и директна връзка към Вашия магазин
Можете да конфигурирате търсенето на продукти така, че да показва само налични артикули. Когато тази опция е активирана, изчерпаните продукти се изключват от резултатите. Допълнителна опция Ви позволява да включите продукти, налични за предварителна поръчка, дори когато филтърът за наличност е активен. Вижте Стъпка 4 за подробности.
Order Details - Клиентите могат да проверяват статуса на поръчката си, като въведат своя номер на поръчка и имейл адрес. И двете стойности се валидират спрямо записите във Вашия Shopify магазин. Чатботът връща:
- Номер на поръчката, дата, обща сума и валута
- Поръчани артикули с имена, количества, цени, SKU, име на варианта и доставчик
- Статус на изпълнение и информация за проследяване (номер, куриерска фирма, URL)
- Адрес за доставка и адрес за фактуриране
- Метод и цена на доставка
- Информация за контакт с клиента (имейл, име, телефон)
- Причина и дата на анулиране (за анулирани поръчки)
Стъпка 1: Създаване на идентификационни данни за Shopify API
Важно за агенции и партньори на Shopify: Приложението на Shopify ТРЯБВА да бъде създадено в Dev Dashboard на организацията, която притежава магазина - винаги започвайте от собствения административен панел на магазина (Settings > Apps > Develop apps > Build apps in Dev Dashboard). Приложение, създадено от друга организация (например агенция или партньор на Shopify, работещ в собствения си Dev Dashboard) и инсталирано в магазина чрез персонализирана връзка за инсталиране, НЯМА да работи с ChatLab, въпреки че инсталацията е успешна и приложението се показва сред инсталираните приложения на магазина с правилните разрешения. Причината: ChatLab се свързва чрез Client ID и Secret (предоставяне на клиентски идентификационни данни на Shopify - client credentials grant), а Shopify позволява това само за приложения, разработени от организацията, която притежава магазина - "Client credentials is only available for apps developed by your own organization and installed in stores that you own" (документация на Shopify). Това е ограничение на Shopify, а не на ChatLab. Симптомът е грешка при свързване в ChatLab със съобщението "The app cannot access this store. Create the app in the Dev Dashboard of the organization that owns this store" (причинено от OAuth грешката shop_not_permitted на Shopify), дори когато Client ID, Secret и поддомейнът на магазина са правилни и приложението е инсталирано. Сигурен знак за приложение от друга организация: административният панел на магазина показва "This custom app was built by a Shopify partner for your store." Решението за агенции: не е необходимо разработчикът на търговеца да прави това - поискайте от търговеца да добави Вашия потребител към СВОЯТА организация с роля App developer ("To give a user in a merchant store access to the Dev Dashboard, assign them the App developer role" - документация на Shopify), след което създайте приложението, докато работите в организацията на търговеца. Достъпът само като сътрудник (collaborator) не е достатъчен - приложенията, създадени докато работите във Вашата собствена организация, остават във Вашата организация.
- Влезте във Вашия административен панел на Shopify
- Отидете на Settings > Apps
- Кликнете върху Develop apps
- На страницата App Development кликнете върху Build apps in Dev Dashboard - това отваря dev.shopify.com/dashboard
- Кликнете върху Create app и въведете име (напр. "ChatLab Integration")
- След като бъде създадено, превъртете до секцията Access и кликнете върху Select scopes
- Под обхватите на достъп за Admin API намерете и активирайте следните разрешения:
read_productsread_orders
- Кликнете върху Done
- Кликнете върху бутона Release, за да публикувате Вашето приложение
- Отидете на App settings и копирайте Client ID и Secret - запазете ги на сигурно място, ще са Ви нужни за свързването с ChatLab
- Отидете в секцията Home и кликнете, за да инсталирате приложението във Вашия магазин
- Изберете Вашия магазин и потвърдете, като кликнете върху Install
Стъпка 2: Намерете поддомейна на Вашия магазин
Вашият поддомейн е частта преди .myshopify.com в URL адреса на Вашия административен панел на Shopify. Например, ако Вашият административен URL адрес е https://pizza-delicious.myshopify.com/admin, тогава Вашият поддомейн е pizza-delicious.
Стъпка 3: Свържете Shopify в ChatLab
- Влезте в ChatLab и изберете Вашия бот
- Отидете в раздела Connect (Свързване)
- Кликнете върху Connect (Свързване) върху плочката на Shopify
- Въведете Вашия Client ID (от Стъпка 1)
- Въведете Вашия Secret (от Стъпка 1)
- Въведете Вашия Shopify subdomain (от Стъпка 2)
- Кликнете върху Connect
ChatLab автоматично тества връзката, като проверява дали Вашите API идентификационни данни разполагат с необходимите обхвати на достъп. При успех ще видите съобщение за потвърждение.
Стъпка 4: Конфигуриране на Shopify действия
След като се свържете, можете да активирате и персонализирате отделни AI действия. Отидете на Settings > Actions (Настройки > Действия) и филтрирайте по платформата Shopify.
Налични са две действия:
- Shopify - product search - позволява на чатбота да търси във Вашия продуктов каталог
- Shopify - order details - позволява на чатбота да проверява информация за поръчки
Кликнете върху бутона за активиране на всяко действие, за да го включите. Можете също така да персонализирате етикета на действието (съобщението, което се показва на потребителите, докато действието се изпълнява) и инструкциите, които насочват как AI да използва всяко действие.
Търсене на продукти - настройки за инвентара
Действието за търсене на продукти включва опции за филтриране на наличностите в своя раздел Product Search Settings (Настройки за търсене на продукти):
- Products in stock only - Когато е активирано, чатботът връща само продукти, които в момента са налични на склад. Изчерпаните продукти се изключват от резултатите от търсенето.
- Show products available for pre-order - Тази опция се появява, когато е включена опцията "Products in stock only". Когато е активна, продуктите, които са изчерпани, но са настроени в Shopify да продължат да се продават (предварителна поръчка), пак ще се показват в резултатите от търсенето, обозначени като налични за предварителна поръчка.
Тестване на интеграцията
След като активирате действията, отворете уиджета на Вашия чатбот и опитайте:
- "Покажи ми обувки за бягане" (тества търсенето на продукти)
- "Какъв е статусът на моята поръчка #1001?" (тества данните за поръчката)
Уверете се, че отговорите съответстват на данните от Вашия Shopify магазин и че връзките към продуктите се отварят правилно.
Инсталиране на чатбота във Вашия Shopify магазин
За да добавите уиджета за чат към Вашия Shopify магазин:
- В ChatLab отидете в раздела Deploy (Внедряване) за Вашия бот
- Изберете раздела на платформата Shopify
- Копирайте кодовия фрагмент
- Във Вашия административен панел на Shopify отидете на Online Store > Themes
- Кликнете върху менюто с три точки на Вашата активна тема и изберете Edit code
- Отворете файла
theme.liquidпод Layout - Поставете кодовия фрагмент в секцията
<head> - Кликнете върху Save
Накрая - трябва да активирате AI действията, налични за Shopify - Order details и Product Search.