Integraatio PrestaShopiin

Yhdistä ChatLab-chatbotisi PrestaShop-kauppaasi tarjotaksesi asiakkaille reaaliaikaisen pääsyn tuotetietoihin ja tilausten seurantaan suoraan chatissa.

Tärkeää: verkkokaupan parhaat käytännöt

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

Mitä integraatio tarjoaa

Tuotehaku - Asiakkaat voivat hakea PrestaShop-katalogistasi kirjoittamalla hakulausekkeen. Chatbot etsii tuotteiden nimistä ja kuvauksista ja palauttaa viisi parhaiten vastaavaa tuotetta, joista näytetään:

• Tuotetunnus (ID), nimi ja kuvaus
• Hinta (valinnaisesti verollisena ja mahdolliset erikoishinta-alennukset huomioituna)
• Suora linkki kauppasi tuotesivulle
• Tuotekuva

Tuotehaku viitteen (SKU) mukaan - Asiakkaat voivat etsiä tuotteita tarkoilla viitekoodeilla. Chatbot hakee useista eri tunnistetyypeistä - viite/SKU, EAN-13-viivakoodi, ISBN ja MPN - sekä päätuotteista että niiden varianteista (yhdistelmistä). Tämä on hyödyllistä, kun asiakkaalla on tietty tuotekoodi luettelosta, laskusta tai pakkauksesta.

Tilauksen tiedot - Asiakkaat voivat tarkistaa tilauksensa tilan antamalla tilaustunnuksen ja tilaukseen liittyvän sähköpostiosoitteen. Molemmat arvot vahvistetaan PrestaShop-kauppasi tiedoista. Chatbot palauttaa:

• Tilauksen viitteen, päivämäärän ja nykyisen tilan (esim. käsittelyssä, valmis, peruutettu)
• Tilauksen loppusumman
• Vastaanottajan nimen, yrityksen, täydellisen toimitusosoitteen (katuosoite, kaupunki, postinumero) ja puhelinnumeron
• Kuljetusliikkeen nimen ja seurantakoodit (tukee useita seurantakoodeja)
• Tilatut tuotteet nimineen, määrineen ja yksikköhintoineen

Esivaatimukset

Varmista ennen PrestaShop-integraation aloittamista, että:

• Chatbotisi on jo lisätty PrestaShop-kauppaasi - katso Chatbotin asentaminen PrestaShop-kauppaan
• Sinulla on pääsy PrestaShopin hallintapaneeliin (back office)

Vaihe 1: Ota Webservice käyttöön PrestaShopissa

1. Kirjaudu sisään PrestaShopin hallintapaneeliin
2. Siirry kohtaan Configure > Advanced Parameters > Webservice

3. Vieritä alas osioon Configuration
4. Aseta Enable PrestaShop's webservice asentoon Yes
5. Napsauta Save

Vaihe 2: Luo Webservice-avain

1. Napsauta samalla Webservice-sivulla painiketta Add new webservice key

2. Napsauta Generate luodaksesi uuden avaimen
3. Anna kuvaus (esim. "ChatLab Integration")
4. Varmista, että avaimen tilana on Enabled
5. Myönnä resurssien käyttöoikeuksissa View (GET) -oikeus seuraaviin resursseihin:
   • addresses
   • attachments
   • carriers
   • categories
   • combinations
   • configurations
   • customers
   • languages
   • order_carriers
   • order_details
   • order_states
   • orders
   • product_customization_fields
   • product_feature_values
   • product_features
   • product_option_values
   • product_options
   • products
   • search
   • specific_price_rules
   • specific_prices
   • states
   • states
   • stock_availables
   • tags
   • tax_rule_groups
   • tax_rules
   • taxes

6. Napsauta Save
7. Kopioi luotu webservice-avain - tarvitset sitä seuraavassa vaiheessa

Vaihe 3: Etsi tuotteen URL-osoitemuoto

1. Siirry PrestaShopin hallintapaneelissa kohtaan Configure > Shop Parameters > Traffic & SEO

2. Vieritä alas osioon Schema of URLs
3. Kopioi arvo kentästä Route to products (esim. {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)

Vaihe 4: Yhdistä PrestaShop ChatLabiin

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

3. Napsauta Connect (Yhdistä) PrestaShop-ruudussa
4. Syötä Webservice key (vaiheesta 2)
5. Syötä Shop url (kauppasi täydellinen URL-osoite, esim. https://www.mystore.com)
6. Syötä Product url format (vaiheesta 3)

7. Napsauta Initialize Configuration - tämä hakee saatavilla olevat kielet kaupastasi
8. Valitse oikea Default language pudotusvalikosta
9. Napsauta Connect

ChatLab testaa yhteyden automaattisesti varmistamalla, että webservice-avaimellasi on vaaditut oikeudet. Jos yhteys onnistuu, näet vahvistusviestin.

Vaihe 5: Määritä PrestaShop-toiminnot

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

Seuraavat toiminnot ovat käytettävissä:

• Prestashop - product search - antaa chatbotille mahdollisuuden hakea tuotekatalogistasi nimen mukaan
• Prestashop - search by reference - antaa chatbotille mahdollisuuden etsiä tuotteita viite-/SKU-, EAN-13-, ISBN- tai MPN-koodien avulla
• Prestashop - order details - antaa chatbotille mahdollisuuden hakea tilauksen tietoja
• Prestashop - get product variants - antaa chatbotille mahdollisuuden hakea tietyn tuotteen tarkat varianttitiedot (koot, värit)

Napsauta kunkin toiminnon aktivointipainiketta ottaaksesi sen käyttöön. Voit myös mukauttaa toiminnon otsikkoa (käyttäjille näytettävää viestiä toiminnon suorituksen aikana) sekä ohjeita, jotka ohjaavat tekoälyn toimintaa kunkin toiminnon osalta.

Kun "Search by reference" -toiminto on käytössä, tavallinen tuotehaku turvautuu myös automaattisesti viitekoodihakuun, jos nimellä ei löydy tuloksia. Tämä tarkoittaa, että asiakkaat voivat syöttää SKU:n tai viivakoodin tavalliseen hakukyselyyn ja saada silti tarkkoja tuloksia.

Näytä tuotteet, joilla on varastontäydennyspäivä (ennakkotilaus)

Kun "Products in stock only" on otettu käyttöön tuotehakutoiminnon asetuksissa, voit lisäksi ottaa käyttöön vaihtoehdon "Show products with restock date". Tämä antaa chatbotille luvan sisällyttää tuloksiin varastosta loppuneet tuotteet, joille on asetettu odotettu täydennyspäivämäärä PrestaShopissa. Sen sijaan, että nämä tuotteet piilotettaisiin kokonaan, chatbot kertoo asiakkaalle täydennyspäivämäärästä ja siitä, että tuote on ennakkotilattavissa.

Vaatimukset:

• PrestaShopissa on oltava käytössä "Allow ordering of out-of-stock products" (Shop Parameters > Product Settings)
• Webservice-avaimella on oltava View (GET) -oikeudet resursseihin combinations ja configurations
• Tuotteiden yhdistelmille on oltava asetettu available_date PrestaShopissa

Verolliset hinnat

Ota käyttöön "Apply tax (VAT) to prices" -valitsin tuotehakutoiminnon asetuksissa näyttääksesi hinnat verollisina. Kun tämä on käytössä, chatbot laskee hinnat PrestaShop-kauppasi verosääntöjen mukaisesti kaupan oletusmaan perusteella. Tämä varmistaa, että asiakkaiden chatissa näkemät hinnat vastaavat verkkokaupan näyteikkunassa näkyviä hintoja.

Vaatimukset:

• Webservice-avaimella on oltava View (GET) -oikeudet resursseihin taxes, tax_rules, tax_rule_groups ja configurations

Erikoishinnat (alennukset ja kampanjat)

Ota käyttöön "Apply specific prices (discounts/promotions)" -valitsin tuotehakutoiminnon asetuksissa näyttääksesi PrestaShopin erikoishintasääntöjen mukaiset alennushinnat. Kun tuotteelle on voimassa alennus, chatbot näyttää sekä alennetun hinnan että alkuperäisen hinnan, jotta asiakkaat näkevät säästön.

Tämä kattaa yleiset erikoishintasäännöt - kampanjat ja alennusmyynnit, jotka koskevat kaikkia asiakkaita vähimmäismäärällä 1. Myös aikarajoitettuja kampanjoita tuetaan; chatbot soveltaa vain niitä alennuksia, jotka ovat tällä hetkellä voimassa aloitus- ja päättymispäivämääriensä mukaan.

Vaatimukset:

• Webservice-avaimella on oltava View (GET) -oikeudet resursseihin specific_prices ja specific_price_rules

Integraation testaaminen

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

• "Näytä minulle juoksukengät" (testaa tuotehakua)
• "Etsin tuotetta ABC-12345" (testaa viite-/SKU-hakua)
• "Mikä on tilaukseni 12345 tila?" (testaa tilauksen tietoja)

Varmista, että vastaukset vastaavat PrestaShop-kauppasi tietoja, että tuotelinkit avautuvat oikein ja että hinnat sisältävät verot ja alennukset, kun kyseiset asetukset ovat käytössä.

Asenna chatbot PrestaShop-kauppaasi

Lisätäksesi chat-widgetin PrestaShop-kauppaasi tutustu yksityiskohtaiseen oppaaseen: Chatbotin asentaminen PrestaShop-kauppaan