Joomla

Integroi AI SmartTalk Joomla-verkkosivustosi kanssa lisätäksesi älykkään chatbotin ja synkronoida automaattisesti sisältösi tietopohjaasi.

---

1. Esivaatimukset

Ennen aloittamista varmista, että sinulla on:

• Aktiivinen AI SmartTalk -tili
• Ylläpito-oikeudet Joomla-verkkosivustollesi (versio 6.x)
• cURL käytössä palvelimellasi
• Verkkokauppaa varten: HikaShop-komponentti asennettuna (valinnainen)

---

2. Laajennuksen lataaminen

1. Kirjaudu AI SmartTalk -tilillesi
2. Siirry päävalikossa kohtaan Integration
3. Etsi Joomla-osio
4. Napsauta Download-painiketta tallentaaksesi laajennuksen ZIP-tiedoston tietokoneellesi

---

3. Asentaminen Joomlaan

1. Kirjaudu Joomla-ylläpito-ohjauspaneeliisi
2. Siirry kohtaan Extensions > Manage > Install
3. Napsauta Upload Package File -välilehteä
4. Valitse lataamasi AI SmartTalk ZIP-tiedosto
5. Napsauta Upload & Install
6. Odota asennuksen vahvistusviestiä

---

4. Laajennuksen konfigurointi

4.1 Ota laajennus käyttöön

1. Siirry kohtaan Extensions > Plugins
2. Etsi System - AI SmartTalk
3. Napsauta laajennuksen nimeä avataksesi asetukset
4. Aseta Status kohdaksi Enabled

4.2 Syötä API-tunnistetiedot

1. AI SmartTalk -tililläsi siirry kohtaan Integration > Joomla
2. Kopioi Chat Model ID ja Chat Model Token
3. Palaa Joomla-laajennuksen asetuksiin
4. Liitä Chat Model ID vastaavaan kenttään
5. Liitä Chat Model Token vastaavaan kenttään

4.3 Valitse synkronoitavat sisältötyypit

Valitse, mitä sisältöä haluat synkronoida chatbotillesi:

• Products: Synkronoi HikaShop-tuotteet (vaatii HikaShopin)
• Articles: Synkronoi Joomla-artikkelit
• Categories: Synkronoi Joomla-kategoriat

4.4 Määritä automaattinen synkronointi

• Ota Auto Sync käyttöön päivittääksesi chatbotiasi automaattisesti, kun sisältö muuttuu
• Kun se on pois päältä, voit synkronoida manuaalisesti laajennuksen asetuksista

4.5 Mukauta chatbotin näyttöä (valinnainen)

• CDN URL: Oletusarvo on https://cdn.aismarttalk.tech (vaihda vain, jos käytät valkoisella brändillä varustettua versiota)
• Iframe Position: Valitse, mihin chatbot ilmestyy sivustollasi

---

5. Datan Synkronointi

Alkuperäinen Synkronointi

1. Avaa liitännäisen asetukset ja napsauta Tallenna ja sulje
2. Liitännäinen synkronoi automaattisesti kaikki julkaistut sisällöt:
   • Julkaistut artikkelit, joilla on julkinen pääsy
   • Julkaistut kategoriat, joilla on julkinen pääsy
   • Julkaistut HikaShop-tuotteet, joilla on varastoa (jos käytössä)

Automaattinen Synkronointi

Kun se on määritetty, liitännäinen synkronoi automaattisesti:

• Kun tallennat artikkelin: Synkronoi heti, jos julkaistu
• Kun päivität tuotteen: Synkronoi, jos julkaistu ja varastossa
• Kun muutat tilaa: Poistaa chatbotista, jos julkaisematon

Manuaalinen Uudelleen Synkronointi

Pakottaaksesi täydellisen uudelleen synkronoinnin:

1. Avaa liitännäisen asetukset
2. Napsauta Tallenna ja sulje
3. Kaikki synkronoimattomat sisällöt synkronoidaan automaattisesti

---

6. Integraation Vahvistaminen

Tarkista Chatbotin Näyttö

1. Vieraile Joomla-sivustosi etusivulla
2. Etsi chatbot-kupla oikeasta alakulmasta
3. Napsauta avataksesi chat-ikkunan
4. Chatbotin tulisi latautua määrittämilläsi asetuksilla

Tarkista Synkronoidut Sisällöt

1. Kirjaudu sisään AI SmartTalk -tilillesi
2. Siirry Tieto-osioon
3. Varmista, että Joomla-sisältösi näkyy:
   • Artikkelien tulisi näkyä täydellä tekstillä
   • Tuotteiden tulisi sisältää kuvaukset ja tiedot
   • Kategoriat tulisi listata

Testaa Chatbot

1. Kysy kysymys Joomla-sisällöstäsi
2. Chatbotin tulisi vastata tarkalla tiedolla
3. Testaa kyselyitä artikkeleista, tuotteista tai kategorioista, jotka olet synkronoinut

---

7. Sisällön Synkronointikäyttäytyminen

Mitä Synkronoidaan

Artikkelit:

• Vain julkaistut artikkelit (state = 1)
• Julkiset tai rekisteröidyt pääsytasot (access = 1 or 5)
• Täysi artikkelin sisältö, mukaan lukien johdantoteksti

Tuotteet (HikaShop):

• Vain julkaistut tuotteet
• Tuotteet, joilla on varastoa (määrä > 0 tai rajaton varasto)
• Tuotekuvaukset, hinnat ja tiedot

Kategoria:

• Vain julkaistut kategoriat
• Julkiset tai rekisteröidyt pääsytasot
• Kategorian kuvaukset

Mitä Poistetaan

Sisältö poistetaan automaattisesti chatbotista, kun:

• Artikkeli on julkaisematon
• Tuote on loppunut varastosta
• Tuote on julkaisematon
• Kategoria on julkaisematon

---

8. Vianetsintä

Chatbot ei näy sivustolla

• Tarkista, että liitännäinen on Käytössä
• Varmista, että Chat-mallin ID on syötetty oikein
• Tyhjennä Joomla-välimuisti: Järjestelmä > Tyhjennä välimuisti
• Tarkista selaimen konsolista JavaScript-virheet

Sisältö ei synkronoidu

• Varmista, että Automaattinen synkronointi on käytössä liitännäisen asetuksissa
• Tarkista, että sisältö on julkaistu ja sillä on julkinen pääsy
• Tuotteiden osalta varmista, että niitä on varastossa
• Tarkista palvelimen virhelokit cURL- tai yhteysongelmien varalta

Tuotesynkronointi ei toimi

• Varmista, että HikaShop on asennettu ja aktivoitu
• Tarkista, että tuotteet on julkaistu ja niitä on varastossa
• Varmista, että "Tuotteet" sisältötyyppi on valittu asetuksissa

API-yhteysvirheet

• Varmista, että Chat-mallin token on oikein
• Tarkista, että palvelimesi sallii ulospäin suuntautuvat HTTPS-yhteydet
• Varmista, että cURL-laajennus on käytössä PHP:ssä
• Testaa API-yhteys palvelimen komentoriviltä

---

9. Liitännäisen poistaminen

Jos sinun tarvitsee poistaa liitännäinen:

1. Liitännäinen siivoaa automaattisesti:
   • Poistaa synkronointitietueet tietokannan tauluista
   • Poistaa kaikki synkronoidut sisällöt AI SmartTalkista
2. Siirry kohtaan Laajennukset > Hallitse > Hallitse
3. Etsi AI SmartTalk
4. Napsauta valintaruutua ja napsauta Poista asennus

---

10. Yhteenveto

Olet onnistuneesti:

• Asentanut AI SmartTalk -liitännäisen Joomlaan
• Liittänyt sivustosi AI SmartTalk -chatbotiin
• Määrittänyt automaattisen sisällön synkronoinnin
• Lisännyt älykkään chatbotin verkkosivustollesi

Vieraasi voivat nyt saada välittömiä vastauksia sisällöstäsi, tuotteistasi ja palveluistasi 24/7 AI-pohjaisen chatbotin kautta.

Tukea varten ota meihin yhteyttä osoitteessa contact+support@aismarttalk.tech