Joomla

Integrujte AI SmartTalk se svým webem Joomla a přidejte inteligentního chatbota a automaticky synchronizujte svůj obsah do své znalostní báze.

---

1. Požadavky

Než začnete, ujistěte se, že máte:

• Aktivní účet AI SmartTalk
• Administrátorský přístup k vašemu webu Joomla (verze 6.x)
• cURL povolené na vašem serveru
• Pro e-commerce: nainstalovaný komponent HikaShop (volitelné)

---

2. Stahování pluginu

1. Přihlaste se do svého účtu AI SmartTalk
2. Přejděte na Integration v hlavním menu
3. Najděte sekci Joomla
4. Klikněte na tlačítko Download a uložte ZIP soubor pluginu na svůj počítač

---

3. Instalace na Joomla

1. Přihlaste se do svého administrátorského panelu Joomla
2. Přejděte na Extensions > Manage > Install
3. Klikněte na kartu Upload Package File
4. Vyberte ZIP soubor AI SmartTalk, který jste stáhli
5. Klikněte na Upload & Install
6. Počkejte na potvrzovací zprávu o instalaci

---

4. Konfigurace pluginu

4.1 Povolení pluginu

1. Přejděte na Extensions > Plugins
2. Vyhledejte System - AI SmartTalk
3. Klikněte na název pluginu pro otevření nastavení
4. Nastavte Status na Enabled

4.2 Zadejte API přihlašovací údaje

1. Ve svém účtu AI SmartTalk přejděte na Integration > Joomla
2. Zkopírujte Chat Model ID a Chat Model Token
3. Vraťte se do nastavení pluginu Joomla
4. Vložte Chat Model ID do odpovídajícího pole
5. Vložte Chat Model Token do odpovídajícího pole

4.3 Vyberte typy obsahu k synchronizaci

Vyberte, který obsah chcete synchronizovat se svým chatbotem:

• Products: Synchronizujte produkty HikaShop (vyžaduje HikaShop)
• Articles: Synchronizujte články Joomla
• Categories: Synchronizujte kategorie Joomla

4.4 Nakonfigurujte automatickou synchronizaci

• Povolte Auto Sync, aby se váš chatbot automaticky aktualizoval, když se obsah změní
• Při vypnutí můžete synchronizovat ručně z nastavení pluginu

4.5 Přizpůsobení zobrazení chatbota (volitelné)

• CDN URL: Výchozí je https://cdn.aismarttalk.tech (měňte pouze v případě použití bílé značky)
• Iframe Position: Vyberte, kde se chatbot na vašem webu zobrazí

---

5. Synchronizace dat

Počáteční synchronizace

1. V nastavení pluginu klikněte na Uložit a zavřít
2. Plugin automaticky synchronizuje veškerý publikovaný obsah:
   • Publikované články s veřejným přístupem
   • Publikované kategorie s veřejným přístupem
   • Publikované produkty HikaShop se skladem (pokud je povoleno)

Automatická synchronizace

Jakmile je nakonfigurováno, plugin automaticky synchronizuje:

• Když uložíte článek: Synchronizuje se okamžitě, pokud je publikován
• Když aktualizujete produkt: Synchronizuje se, pokud je publikován a skladem
• Když změníte stav: Odebere z chatbotu, pokud není publikován

Ruční opětovná synchronizace

Pro vynucení úplné opětovné synchronizace:

1. Otevřete nastavení pluginu
2. Klikněte na Uložit a zavřít
3. Veškerý nesynchronizovaný obsah bude automaticky synchronizován

---

6. Ověření integrace

Zkontrolujte zobrazení chatbotu

1. Navštivte frontend vašeho Joomla webu
2. Hledejte bublinu chatbotu v pravém dolním rohu
3. Klikněte pro otevření okna chatu
4. Chatbot by se měl načíst s vašimi nakonfigurovanými nastaveními

Zkontrolujte synchronizovaný obsah

1. Přihlaste se do svého účtu AI SmartTalk
2. Přejděte do sekce Znalosti
3. Ověřte, že váš Joomla obsah se zobrazuje:
   • Články by měly být zobrazeny s celým textem
   • Produkty by měly zahrnovat popisy a detaily
   • Kategorie by měly být uvedeny

Otestujte chatbot

1. Zeptejte se na otázku ohledně vašeho Joomla obsahu
2. Chatbot by měl odpovědět přesnými informacemi
3. Otestujte dotazy ohledně článků, produktů nebo kategorií, které jste synchronizovali

---

7. Chování synchronizace obsahu

Co se synchronizuje

Články:

• Pouze publikované články (state = 1)
• Veřejné nebo registrované úrovně přístupu (access = 1 or 5)
• Celý obsah článku včetně úvodního textu

Produkty (HikaShop):

• Pouze publikované produkty
• Produkty se skladem (množství > 0 nebo neomezený sklad)
• Popisy produktů, ceny a detaily

Kategorie:

• Pouze publikované kategorie
• Veřejné nebo registrované úrovně přístupu
• Popisy kategorií

Co se odstraňuje

Obsah je automaticky odstraněn z chatbotu, když:

• Článek je stažen z publikace
• Produkt je vyprodán
• Produkt je stažen z publikace
• Kategorie je stažena z publikace

---

8. Řešení problémů

Chatbot se na stránce nezobrazuje

• Zkontrolujte, že je plugin Povolen
• Ověřte, že je ID modelu chatu správně zadáno
• Vymažte mezipaměť Joomla: Systém > Vymazat mezipaměť
• Zkontrolujte konzoli prohlížeče na chyby JavaScriptu

Obsah se nesynchronizuje

• Ujistěte se, že je v nastavení pluginu povoleno Automatické synchronizování
• Zkontrolujte, že je obsah publikován a má veřejný přístup
• U produktů ověřte, že mají dostupné zásoby
• Zkontrolujte chybové protokoly serveru na problémy s cURL nebo připojením

Synchronizace produktů nefunguje

• Ověřte, že je HikaShop nainstalován a aktivován
• Zkontrolujte, že jsou produkty publikovány a skladem
• Ujistěte se, že je v nastavení vybrán typ obsahu "Produkty"

Chyby připojení k API

• Ověřte, že je Token modelu chatu správný
• Zkontrolujte, že váš server povoluje odchozí HTTPS připojení
• Ujistěte se, že je rozšíření cURL povoleno v PHP
• Otestujte konektivitu API z příkazového řádku serveru

---

9. Odinstalace pluginu

Pokud potřebujete plugin odstranit:

1. Plugin automaticky provede úklid:
   • Odstraní sloupce pro sledování synchronizace z databázových tabulek
   • Smaže veškerý synchronizovaný obsah z AI SmartTalk
2. Přejděte na Rozšíření > Spravovat > Spravovat
3. Vyhledejte AI SmartTalk
4. Zaškrtněte políčko a klikněte na Odinstalovat

---

10. Závěr

Úspěšně jste:

• Nainstalovali plugin AI SmartTalk na Joomla
• Propojili svou stránku s chatbotem AI SmartTalk
• Nakonfigurovali automatickou synchronizaci obsahu
• Přidali inteligentního chatbota na svou webovou stránku

Vaši návštěvníci nyní mohou získat okamžité odpovědi na otázky týkající se vašeho obsahu, produktů a služeb 24/7 prostřednictvím chatbota poháněného AI.

Pro podporu nás kontaktujte na contact+support@aismarttalk.tech