Shopify-integraatio

Yhdistä ChatLab-chatbotisi Shopify-verkkokauppaasi, jotta asiakkaasi saavat reaaliaikaisen pääsyn tuotetietoihin ja tilausseurantaan suoraan chatissa.

Tärkeää: E-commercen parhaat käytännöt

Kun olet saanut alla olevan integraation valmiiksi, lue kattava opas chatbotin optimoinnista verkkokauppaa varten: Kuinka ottaa ChatLab käyttöön verkkokaupassasi

Mitä integraatio tarjoaa

Tuotehaku - Asiakkaat voivat etsiä tuotteita Shopify-katalogistasi kirjoittamalla hakulausekkeen. Chatbot hakee tuotteiden nimistä, kuvauksista, tyypeistä, tunnisteista (tags) ja valmistajista palauttaen osuvat aktiiviset tuotteet sekä seuraavat tiedot:

• Tuotteen nimi, kuvaus ja tyyppi
• Valmistaja ja tunnisteet
• Hinta tai hintahaarukka (tuotteille, joilla on useita variantteja)
• Saatavilla olevat variantit sisältäen SKU:n, vertailuhinnan (compare-at price), varastomäärän ja saatavuustilan
• Tuotekuva ja suora linkki verkkokauppaasi

Voit määrittää tuotehaun näyttämään vain varastossa olevia tuotteita. Kun tämä asetus on käytössä, loppuunmyydyt tuotteet jätetään hakutulosten ulkopuolelle. Lisävalinnan avulla voit näyttää myös ennakkotilattavissa olevat tuotteet silloinkin, kun varastosuodatus on aktiivinen. Katso lisätietoja vaiheesta 4.

Tilauksen tiedot - Asiakkaat voivat tarkistaa tilauksen tilan antamalla tilausnumeronsa ja sähköpostiosoitteensa. Molemmat tiedot vahvistetaan Shopify-kauppasi tiedoista. Chatbot palauttaa seuraavat tiedot:

• Tilauksen viite, päivämäärä, loppusumma ja valuutta
• Tilatut tuotteet nimineen, määrineen, hintoineen, SKU-tietoineen, varianttinimineen ja valmistajineen
• Toimituksen tila (fulfillment status) ja seurantatiedot (seurantakoodi, kuljetusyhtiö, seurantalinkki)
• Toimitusosoite ja laskutusosoite
• Toimitustapa ja -kulu
• Asiakkaan yhteystiedot (sähköposti, nimi, puhelinnumero)
• Peruutuksen syy ja päivämäärä (peruutetuille tilauksille)

Vaihe 1: Luo Shopify API -tunnukset

Tärkeää toimistoille ja Shopify-kumppaneille: Shopify-sovellus TÄYTYY luoda kaupan omistavan organisaation Dev Dashboardissa - aloita aina kyseisen kaupan omasta hallintapaneelista (Settings > Apps > Develop apps > Build apps in Dev Dashboard [Asetukset > Sovellukset > Kehitä sovelluksia > Luo sovelluksia Dev Dashboardissa]). Toisen organisaation luoma sovellus (esimerkiksi toimisto tai Shopify-kumppani, joka työskentelee omassa Dev Dashboardissaan) ja asennettu kauppaan mukautetun asennuslinkin kautta EI toimi ChatLabin kanssa, vaikka asennus onnistuisi ja sovellus näkyisi kaupan asennettujen sovellusten listalla oikeilla käyttöoikeuksilla. Syy tähän: ChatLab yhdistää käyttäen Client ID:tä ja Secretiä (Shopifyn client credentials grant), ja Shopify sallii tämän valtuutuksen vain sovelluksille, jotka kaupan omistava organisaatio on itse kehittänyt - "Client credentials is only available for apps developed by your own organization and installed in stores that you own" (Shopifyn dokumentaatio). Tämä on Shopifyn, ei ChatLabin, rajoitus. Oireena on yhteysvirhe ChatLabissa ilmoituksella "The app cannot access this store. Create the app in the Dev Dashboard of the organization that owns this store" (johtuen Shopifyn shop_not_permitted OAuth -virheestä), vaikka Client ID, Secret ja kaupan aliverkkotunnus olisivat täysin oikein ja sovellus asennettuna. Toisen organisaation luoman sovelluksen tunnistaa kaupan hallinnassa näkyvästä ilmoituksesta: "This custom app was built by a Shopify partner for your store." Ratkaisu toimistoille: kauppiaan omaa kehittäjää ei tarvita työhön - pyydä kauppiasta lisäämään käyttäjäsi HÄNEN organisaatioonsa App developer -roolilla ("To give a user in a merchant store access to the Dev Dashboard, assign them the App developer role" - Shopifyn dokumentaatio), ja luo sovellus sitten työskennellessäsi kauppiaan organisaation alla. Pelkkä Collaborator-pääsy ei riitä - omassa organisaatiossasi työskennellessä luodut sovellukset pysyvät omassa organisaatiossasi.

1. Kirjaudu sisään Shopify-hallintapaneeliisi
2. Siirry kohtaan Settings > Apps (Asetukset > Sovellukset)
3. Napsauta Develop apps (Kehitä sovelluksia)
4. Napsauta App Development -sivulla Build apps in Dev Dashboard (Luo sovelluksia Dev Dashboardissa) - tämä avaa osoitteen dev.shopify.com/dashboard
5. Napsauta Create app (Luo sovellus) ja anna nimi (esim. "ChatLab Integration")

6. Kun sovellus on luotu, vieritä osioon Access (Käyttöoikeudet) ja napsauta Select scopes (Valitse käyttöoikeudet)

7. Etsi ja ota käyttöön seuraavat luvat kohdasta Admin API access scopes:
   • read_products
   • read_orders
8. Napsauta Done (Valmis)

9. Napsauta Release-painiketta (Julkaise) julkaistaksesi sovelluksesi
10. Siirry kohtaan App settings (Sovellusasetukset) ja kopioi Client ID ja Secret - säilytä nämä turvallisesti, tarvitset niitä yhdistämiseen ChatLabiin

11. Siirry Home-osioon (Etusivu) ja napsauta asentaaksesi sovelluksen kauppaasi

12. Valitse kauppasi ja vahvista napsauttamalla Install (Asenna)

Vaihe 2: Etsi verkkokauppasi aliverkkotunnus (subdomain)

Aliverkkotunnuksesi on Shopify-hallintapaneelisi URL-osoitteessa oleva osa ennen päätettä .myshopify.com. Jos hallintaosoitteesi on esimerkiksi https://pizza-delicious.myshopify.com/admin, aliverkkotunnuksesi on pizza-delicious.

Vaihe 3: Yhdistä Shopify ChatLabiin

1. Kirjaudu sisään ChatLabiin ja valitse bottisi
2. Siirry välilehdelle Connect (Yhdistä)

3. Napsauta Connect (Yhdistä) Shopify-kortissa
4. Syötä Client ID (vaiheesta 1)
5. Syötä Secret (vaiheesta 1)
6. Syötä Shopify subdomain (vaiheesta 2)

7. Napsauta Connect (Yhdistä)

ChatLab testaa yhteyden automaattisesti tarkistamalla, että API-tunnuksillasi on vaaditut käyttöoikeudet. Jos yhteys onnistuu, näet vahvistusviestin.

Vaihe 4: Määritä Shopify-toiminnot (Shopify Actions)

Yhdistämisen jälkeen voit ottaa käyttöön ja mukauttaa yksittäisiä tekoälytoimintoja. Siirry kohtaan Settings > Actions (Asetukset > Toiminnot) ja suodata tulokset Shopify-alustan mukaan.

Käytettävissä on kaksi toimintoa:

• Shopify - product search - antaa chatbotille mahdollisuuden etsiä tuotekatalogistasi
• Shopify - order details - antaa chatbotille mahdollisuuden hakea tilaustietoja

Ota toiminto käyttöön napsauttamalla sen aktivointipainiketta. Voit myös muokata toiminnon otsikkoa (action label, viesti joka näkyy käyttäjille toiminnon ollessa käynnissä) sekä ohjeita, jotka ohjaavat sitä, miten tekoäly käyttää kumpaakin toimintoa.

Tuotehaku - Varastoasetukset

Tuotehakutoiminto sisältää varaston suodatusvaihtoehtoja sen Product Search Settings -välilehdellä (Tuotehaun asetukset):

• Products in stock only - Kun tämä on käytössä, chatbot palauttaa vain tuotteita, joita on tällä hetkellä varastossa. Loppuunmyydyt tuotteet jätetään hakutulosten ulkopuolelle.
• Show products available for pre-order - Tämä vaihtoehto tulee näkyviin, kun "Products in stock only" on käytössä. Kun asetus on aktiivinen, tuotteet, jotka ovat loppuunmyytyjä mutta määritetty Shopifyssa myynnin jatkamiseen (ennakkotilaus), näkyvät silti hakutuloksissa merkittynä ennakkotilattaviksi.

Integraation testaaminen

Kun olet aktivoinut toiminnot, avaa chatbot-widgetisi ja kokeile:

• "Näytä minulle juoksukengät" (testaa tuotehakua)
• "Mikä on tilaukseni #1001 tila?" (testaa tilauksen tietoja)

Varmista, että vastaukset vastaavat Shopify-kauppasi tietoja ja että tuotelinkit aukeavat oikein.

Asenna chatbot Shopify-verkkokauppaasi

Lisätäksesi chat-widgetin Shopifyn kauppanäkymään:

1. Siirry ChatLabissa bottisi välilehdelle Deploy (Julkaise)
2. Valitse Shopify-alustavälilehti
3. Kopioi koodinpätkä
4. Siirry Shopify-hallinnassasi kohtaan Online Store > Themes (Verkkokauppa > Teemat)
5. Napsauta aktiivisen teemasi kolmen pisteen valikkoa ja valitse Edit code (Muokkaa koodia)
6. Avaa theme.liquid-tiedosto Layout-kansiosta
7. Liitä koodinpätkä <head>-osion sisään
8. Napsauta Save (Tallenna)

Lopuksi - muista ottaa käyttöön Shopifylle saatavilla olevat AI Actions -toiminnot: Order details ja Product Search.