Integracija sa Shopify platformom

Povežite svoj ChatLab chatbot sa svojom Shopify prodavnicom kako biste kupcima omogućili pristup informacijama o proizvodima i praćenju porudžbina u realnom vremenu, direktno u chatu.

Važno: Najbolje prakse za E-Commerce

Nakon što završite integraciju u nastavku, pročitajte sveobuhvatni vodič o optimizaciji chatbota za e-commerce: Kako podesiti ChatLab za vašu E-commerce prodavnicu

Šta ova integracija pruža

Pretraga proizvoda - Kupci mogu pretraživati vaš Shopify katalog unosom fraze. Chatbot pretražuje nazive proizvoda, opise, tipove, oznake i dobavljače, vraćajući odgovarajuće aktivne proizvode sa sledećim podacima:

• Naziv proizvoda, opis i tip
• Dobavljač i oznake
• Cena ili raspon cena (za proizvode sa više varijanti)
• Dostupne varijante sa SKU, uporednom cenom, količinom na zalihama i statusom dostupnosti
• Slika proizvoda i direktan link ka vašoj prodavnici

Možete konfigurisati pretragu proizvoda tako da prikazuje samo proizvode na zalihama. Kada je ova opcija omogućena, rasprodati artikli se isključuju iz rezultata. Dodatna opcija vam omogućava da uključite proizvode dostupne za pretporudžbinu čak i kada je filter za stanje na zalihama aktivan. Pogledajte Korak 4 za detalje.

Detalji porudžbine - Kupci mogu proveriti status porudžbine unosom broja porudžbine i imejl adrese. Obe vrednosti se proveravaju u evidenciji vaše Shopify prodavnice. Chatbot vraća:

• Broj porudžbine, datum, ukupan iznos i valutu
• Naručene artikle sa nazivima, količinama, cenama, SKU, nazivom varijante i dobavljačem
• Status isporuke i informacije o praćenju (broj pošiljke, kurirska služba, URL)
• Adresu za dostavu i adresu za naplatu
• Način i troškove dostave
• Kontakt podatke kupca (imejl, ime, telefon)
• Razlog i datum otkazivanja (za otkazane porudžbine)

Korak 1: Kreirajte Shopify API kredencijale

Važno za agencije i Shopify partnere: Shopify aplikacija MORA biti kreirana u Dev Dashboard-u organizacije koja poseduje prodavnicu - uvek započnite iz administratorskog panela same prodavnice (Settings > Apps > Develop apps > Build apps in Dev Dashboard). Aplikacija koju kreira druga organizacija (na primer, agencija ili Shopify partner koji radi u svom Dev Dashboard-u) i koja se instalira na prodavnicu putem prilagođenog linka za instalaciju NEĆE raditi sa ChatLab-om, čak i ako instalacija uspe i aplikacija se pojavi među instaliranim aplikacijama prodavnice sa odgovarajućim dozvolama. Razlog: ChatLab se povezuje koristeći Client ID i Secret (Shopify dodela na osnovu akreditiva klijenta), a Shopify dozvoljava ovu dodelu samo za aplikacije koje je razvila organizacija u čijem je vlasništvu prodavnica - „Client credentials is only available for apps developed by your own organization and installed in stores that you own” (Shopify dokumentacija). Ovo je ograničenje platforme Shopify, a ne ChatLab-a. Simptom je neuspešno povezivanje u ChatLab-u uz poruku „The app cannot access this store. Create the app in the Dev Dashboard of the organization that owns this store” (izazvano greškom OAuth shop_not_permitted sa platforme Shopify), čak i kada su Client ID, Secret i poddomen prodavnice potpuno tačni, a aplikacija instalirana. Jasan znak aplikacije iz druge organizacije: administratorski panel prodavnice prikazuje „This custom app was built by a Shopify partner for your store.” Rešenje za agencije: nije potrebno da to radi programer trgovca - zatražite od trgovca da doda vašeg korisnika u NJIHOVU organizaciju sa ulogom App developer („To give a user in a merchant store access to the Dev Dashboard, assign them the App developer role” - Shopify dokumentacija), a zatim kreirajte aplikaciju dok radite unutar organizacije trgovca. Sam pristup saradnika (collaborator) nije dovoljan - aplikacije kreirane dok radite u sopstvenoj organizaciji ostaju u vašoj organizaciji.

1. Prijavite se na svoj Shopify administratorski panel
2. Idite na Settings > Apps
3. Kliknite na Develop apps
4. Na stranici App Development kliknite na Build apps in Dev Dashboard - ovo otvara dev.shopify.com/dashboard
5. Kliknite na Create app i unesite naziv (npr. „ChatLab Integration”)

6. Kada je kreirate, skrolujte do odeljka Access i kliknite na Select scopes

7. Pod opsegom pristupa za Admin API, pronađite i omogućite sledeće dozvole:
   • read_products
   • read_orders
8. Kliknite na Done

9. Kliknite na dugme Release da biste objavili svoju aplikaciju
10. Idite na App settings i kopirajte Client ID i Secret - sačuvajte ih na bezbedno mesto, biće vam potrebni za povezivanje sa ChatLab-om

11. Idite na odeljak Home i kliknite da instalirate aplikaciju na svoju prodavnicu

12. Izaberite svoju prodavnicu i potvrdite klikom na Install

Korak 2: Pronađite poddomen svoje prodavnice

Vaš poddomen je deo pre .myshopify.com u URL adresi vašeg Shopify administratorskog panela. Na primer, ako je vaša administratorska URL adresa https://pizza-delicious.myshopify.com/admin, onda je vaš poddomen pizza-delicious.

Korak 3: Povežite Shopify u ChatLab-u

1. Prijavite se na ChatLab i izaberite svog bota
2. Idite na karticu Connect (Poveži)

3. Kliknite na Connect (Poveži) na Shopify kartici
4. Unesite svoj Client ID (iz Koraka 1)
5. Unesite svoj Secret (iz Koraka 1)
6. Unesite svoj Shopify subdomain (iz Koraka 2)

7. Kliknite na Connect (Poveži)

ChatLab automatski testira vezu proveravajući da li vaši API kredencijali imaju potrebne opsege pristupa. Ako je povezivanje uspešno, videćete poruku potvrde.

Korak 4: Konfigurišite Shopify akcije

Nakon povezivanja, možete omogućiti i prilagoditi pojedinačne AI akcije. Idite na Settings > Actions (Podešavanja > Akcije) i filtrirajte prema platformi Shopify.

Dostupne su dve akcije:

• Shopify - product search - omogućava chatbotu da pretražuje vaš katalog proizvoda
• Shopify - order details - omogućava chatbotu da pretražuje informacije o porudžbinama

Kliknite na dugme za aktivaciju na svakoj akciji da biste je omogućili. Takođe možete prilagoditi oznaku akcije (poruku koja se prikazuje korisnicima dok se akcija izvršava) i uputstva koja usmeravaju kako AI koristi svaku akciju.

Pretraga proizvoda - Podešavanja zaliha

Akcija pretrage proizvoda uključuje opcije filtriranja zaliha u svojoj kartici Product Search Settings (Podešavanja pretrage proizvoda):

• Products in stock only (Samo proizvodi na zalihama) - Kada je omogućeno, chatbot vraća samo proizvode koji su trenutno na zalihama. Rasprodati proizvodi se isključuju iz rezultata pretrage.
• Show products available for pre-order (Prikaži proizvode dostupne za pretporudžbinu) - Ova opcija se pojavljuje kada je omogućena opcija „Products in stock only”. Kada je aktivna, proizvodi koji nisu na zalihama, ali su u Shopify-u podešeni da nastave sa prodajom (pretporudžbina), i dalje će se pojavljivati u rezultatima pretrage, označeni kao dostupni za pretporudžbinu.

Testiranje integracije

Nakon što aktivirate akcije, otvorite widget svog chatbota i isprobajte:

• „Show me running shoes” (testira pretragu proizvoda)
• „What's the status of my order #1001?” (testira detalje porudžbine)

Proverite da li odgovori odgovaraju podacima iz vaše Shopify prodavnice i da li se linkovi proizvoda ispravno otvaraju.

Instalirajte chatbot na svoju Shopify prodavnicu

Da biste dodali widget za chat na svoju Shopify prodavnicu:

1. U ChatLab-u, idite na karticu Deploy (Objavi) za svog bota
2. Izaberite karticu platforme Shopify
3. Kopirajte isečak koda
4. U svom Shopify administratorskom panelu, idite na Online Store > Themes
5. Kliknite na meni sa tri tačke na svojoj aktivnoj temi i izaberite Edit code
6. Otvorite datoteku theme.liquid u odeljku Layout
7. Nalepite isečak koda unutar <head> sekcije
8. Kliknite na Save

Na kraju - potrebno je da omogućite AI Actions dostupne za Shopify - Order details i Product Search.