Joomla

Integrera AI SmartTalk med din Joomla-webbplats för att lägga till en intelligent chatbot och automatiskt synkronisera ditt innehåll till din kunskapsbas.

---

1. Förutsättningar

Innan du börjar, se till att du har:

• Ett aktivt AI SmartTalk-konto
• Administratörsbehörighet till din Joomla-webbplats (version 6.x)
• cURL aktiverat på din server
• För e-handel: HikaShop-komponenten installerad (valfritt)

---

2. Ladda ner pluginet

1. Logga in på ditt AI SmartTalk-konto
2. Navigera till Integration i huvudmenyn
3. Hitta sektionen Joomla
4. Klicka på Ladda ner-knappen för att spara pluginets ZIP-fil på din dator

---

3. Installation på Joomla

1. Logga in på din Joomla-administratörspanel
2. Gå till Extensions > Manage > Install
3. Klicka på fliken Upload Package File
4. Välj AI SmartTalk ZIP-filen du laddade ner
5. Klicka på Upload & Install
6. Vänta på installationsbekräftelsemeddelandet

---

4. Konfigurera pluginet

4.1 Aktivera pluginet

1. Gå till Extensions > Plugins
2. Sök efter System - AI SmartTalk
3. Klicka på pluginets namn för att öppna inställningarna
4. Ställ in Status på Enabled

4.2 Ange API-uppgifter

1. I ditt AI SmartTalk-konto, gå till Integration > Joomla
2. Kopiera Chat Model ID och Chat Model Token
3. Återvänd till Joomla-pluginets inställningar
4. Klistra in Chat Model ID i motsvarande fält
5. Klistra in Chat Model Token i motsvarande fält

4.3 Välj innehållstyper att synkronisera

Välj vilket innehåll du vill synkronisera till din chatbot:

• Produkter: Synkronisera HikaShop-produkter (kräver HikaShop)
• Artiklar: Synkronisera Joomla-artiklar
• Kategorier: Synkronisera Joomla-kategorier

4.4 Konfigurera automatisk synkronisering

• Aktivera Auto Sync för att automatiskt uppdatera din chatbot när innehållet ändras
• När det är inaktiverat kan du manuellt synkronisera från pluginets inställningar

4.5 Anpassa chatbotens visning (Valfritt)

• CDN URL: Standard är https://cdn.aismarttalk.tech (ändra endast om du använder en whitebranded version)
• Iframe Position: Välj var chatboten ska visas på din webbplats

---

5. Datasynkronisering

Initial synkronisering

1. I plugininställningarna, klicka på Spara & Stäng
2. Pluginet kommer automatiskt att synkronisera allt publicerat innehåll:
   • Publicerade artiklar med offentlig åtkomst
   • Publicerade kategorier med offentlig åtkomst
   • Publicerade HikaShop-produkter med lager (om aktiverat)

Automatisk synkronisering

När den är konfigurerad, synkroniserar pluginet automatiskt:

• När du sparar en artikel: Synkroniseras omedelbart om publicerad
• När du uppdaterar en produkt: Synkroniseras om publicerad och i lager
• När du ändrar status: Tas bort från chatboten om opublicerad

Manuell om-synkronisering

För att tvinga en fullständig om-synkronisering:

1. Öppna plugininställningarna
2. Klicka på Spara & Stäng
3. Allt osynkroniserat innehåll kommer att synkroniseras automatiskt

---

6. Verifiera integrationen

Kontrollera chatbotens visning

1. Besök frontend på din Joomla-webbplats
2. Leta efter chatbotbubblan i det nedre högra hörnet
3. Klicka för att öppna chattfönstret
4. Chatboten bör laddas med dina konfigurerade inställningar

Kontrollera synkroniserat innehåll

1. Logga in på ditt AI SmartTalk-konto
2. Gå till Kunskap-sektionen
3. Verifiera att ditt Joomla-innehåll visas:
   • Artiklar bör visas med sin fullständiga text
   • Produkter bör inkludera beskrivningar och detaljer
   • Kategorier bör listas

Testa chatboten

1. Ställ en fråga om ditt Joomla-innehåll
2. Chatboten bör svara med korrekt information
3. Testa frågor om artiklar, produkter eller kategorier som du har synkroniserat

---

7. Innehållssynkroniseringsbeteende

Vad som synkroniseras

Artiklar:

• Endast publicerade artiklar (state = 1)
• Offentliga eller registrerade åtkomstnivåer (access = 1 or 5)
• Fullt artikelinnehåll inklusive introduktionstext

Produkter (HikaShop):

• Endast publicerade produkter
• Produkter med lager (kvantitet > 0 eller obegränsat lager)
• Produktbeskrivningar, priser och detaljer

Kategorier:

• Endast publicerade kategorier
• Offentliga eller registrerade åtkomstnivåer
• Kategoribeskrivningar

Vad som tas bort

Innehåll tas automatiskt bort från chatboten när:

• En artikel är opublicerad
• En produkt tar slut i lager
• En produkt är opublicerad
• En kategori är opublicerad

---

8. Felsökning

Chatboten visas inte på webbplatsen

• Kontrollera att pluginet är Aktiverat
• Verifiera att Chat Model ID är korrekt angivet
• Rensa din Joomla-cache: System > Rensa cache
• Kontrollera webbläsarens konsol för JavaScript-fel

Innehåll synkroniseras inte

• Se till att Auto Sync är aktiverat i plugininställningarna
• Kontrollera att innehållet är publicerat och har offentlig åtkomst
• För produkter, verifiera att de har lager tillgängligt
• Kontrollera serverns fel-loggar för cURL- eller anslutningsproblem

Produktsynkronisering fungerar inte

• Verifiera att HikaShop är installerat och aktiverat
• Kontrollera att produkterna är publicerade och i lager
• Se till att innehållstypen "Produkter" är vald i inställningarna

API-anslutningsfel

• Verifiera att Chat Model Token är korrekt
• Kontrollera att din server tillåter utgående HTTPS-anslutningar
• Se till att cURL-tillägget är aktiverat i PHP
• Testa API-anslutningen från serverns kommandorad

---

9. Avinstallation av plugin

Om du behöver ta bort pluginet:

1. Pluginet kommer automatiskt att rensa upp:
   • Ta bort synkroniseringens spårningskolumner från databas-tabeller
   • Ta bort allt synkroniserat innehåll från AI SmartTalk
2. Gå till Tillägg > Hantera > Hantera
3. Sök efter AI SmartTalk
4. Klicka i kryssrutan och klicka på Avinstallera

---

10. Slutsats

Du har framgångsrikt:

• Installerat AI SmartTalk-pluginet på Joomla
• Anslutit din webbplats till din AI SmartTalk-chatbot
• Konfigurerat automatisk innehållssynkronisering
• Lagt till en intelligent chatbot på din webbplats

Dina besökare kan nu få omedelbara svar om ditt innehåll, produkter och tjänster dygnet runt genom den AI-drivna chatboten.

För support, kontakta oss på contact+support@aismarttalk.tech