Ezen az oldalon

• Mikor ezt válaszd
• Hogyan működik
• Termékkártyák a chatben
• Beállítás lépésről lépésre
• Miért marad helyes az ár
• Limitek és viselkedés
• Gyakori hibák és megoldások

Mikor ezt válaszd

• PrestaShop webshopod van, és azt szeretnéd, hogy az asszisztens pontos árral és készletadattal válaszoljon, ne csak a termékleírás szövegével.
• Azt akarod, hogy a chat termékkártyákat jelenítsen meg képpel, névvel és árral, közvetlen linkkel a termékoldalra.
• Egész boltot akarsz beolvasni egy lépésben — a Webshop forrás a sitemap minden oldalát feldolgozza, nem csak a termékeket.
• Nem támogatott motoron van a boltod? Akkor használd a Weboldal forrást — az is beolvassa a katalógust, de strukturált ár/készlet és termékkártyák nélkül.

Hogyan működik

A beolvasás úgy működik, mint a Weboldal forrás — a sitemapből indul —, de minden oldalt aszerint dolgoz fel, hogy termékoldal-e vagy sem.

1. Felfedezés. Az EchoAI beolvassa a bolt sitemapjét, és összegyűjti az összes URL-t. A CDATA-ba csomagolt URL-eket (a PrestaShopnál gyakoriak) is helyesen kezeli.
2. Osztályozás. A felismert platform szerint dönti el, hogy melyik URL termékoldal és melyik egyéb (kategória, blog, statikus lap). A Shopify és a WooCommerce a publikus terméklistát (JSON API) használja, a többi platform a sitemap terméklinkjeit; az UNAS-nál a kategóriaoldalak terméklistájából gyűjti ki a terméklinkeket.
3. Termékoldal feldolgozása. Letölti az oldalt, kinyeri a termékadatokat (név, ár, pénznem, készlet, cikkszám, márka, kategória, tulajdonságok, képek), és két dolgot ír be:
   • egy termékbejegyzést a pontos árral és készlettel — ezt használja a chat a termékkártyákhoz és a pontos árazáshoz;
   • egy kereshető szöveges bejegyzést, amely az adott termékhez kapcsolódik — ez számít bele a tartalomkeretbe, és ez teszi a terméket szövegre is megtalálhatóvá (a tulajdonságok, pl. „Szín: Natúr", is bekerülnek a kereshető szövegbe).
4. Egyéb oldal feldolgozása. A nem-termék oldalakból csak szöveges bejegyzés készül, ár/készlet nélkül — ugyanúgy, mint a Weboldal forrásnál.

A beolvasás a háttérben fut, párhuzamosan dolgozza fel az oldalakat. A folyamat idempotens: az újraszinkronizálás kihagyja a már beolvasott oldalakat, így nem keletkezik duplikátum, és nem fogy feleslegesen a tartalomkeret.

Termékkártyák a chatben

Amikor a látogató termékre kérdez, az asszisztens nem csak szöveggel válaszol: a beszélgetésben termékkártyákat jelenít meg kétoszlopos rácsban (legfeljebb 6 kártya). Minden kártya kattintható, és új lapon nyitja meg a termékoldalt.

Egy kártya tartalma:

• Termékkép (ha van) — a kifogyott termékeknél halványítva.
• Termék neve.
• Ár — a beszélgetés nyelvének megfelelő formázásban (ezres elválasztó, pénznem).
• Készletállapot — színes pötty + felirat (zöld = raktáron, szürke = elfogyott). A felirat lokalizált (pl. „Raktáron" / „Elfogyott"); a pontos darabszám soha nem jelenik meg, csak a bináris állapot.

A kártyák sorrendje finoman átrangsorolva jelenik meg, hogy a leghasznosabb termékek kerüljenek előre:

• előbb a raktáron lévő termékek,
• aztán azok, amelyeknek van áruk,
• végül azok, amelyeknek van képük.

A keresési relevancia-sorrend az azonos pontszámú termékeken belül megmarad. A kifogyott termékek nem tűnnek el — csak halványabban, szürkébben jelennek meg, hogy informatívak, de ne riasszanak.

Beállítás lépésről lépésre

1. Nyisd meg a Tartalomforrások (Integrációk) oldalt a vezérlőpulton.
2. Keresd meg a Webshop termékadatok kártyát.
3. Add meg a webshopod URL-jét. Többnyelvű boltnál egy nyelvre szűkíthetsz útvonal-előtaggal (pl. https://shopod.hu/hu).
4. Válaszd ki, melyik asszisztens kapja a beolvasott termékeket.
5. Kattints a Webshop csatlakoztatása gombra. Az EchoAI elindítja a beolvasást, és a kártyán követheted az állapotot: connecting → crawling → active.

Amikor a beolvasás befejeződik, a kártya kiírja, hány termék szinkronizálódott. Később az újraszinkronizálással frissítheted az árakat és a készletet — az idempotens beolvasás csak az újdonságokat veszi fel.

Miért marad helyes az ár

A PrestaShop a látogató országa szerint döntheti el, milyen pénznemben jeleníti meg az árat. Ez azt jelenti, hogy ha a beolvasó egy másik országból „nézi" a boltot, az ár rossz pénznemben érkezhet — a helyes pénznem pedig ilyenkor meg sem jelenik az oldalon. Az EchoAI két dologgal védi ki ezt.

Pénznem-zárolás

Az első beolvasáskor az EchoAI a bolt főoldaláról felismeri a helyes pénznemet, és hozzárögzíti a forráshoz. Ettől kezdve minden terméket ehhez a pénznemhez ellenőriz:

• Ha egy termék a helyes pénznemben jön be → bekerül.
• Ha egy termék rossz pénznemben jön be → az EchoAI nem írja be. A korábbi, helyes adat érintetlen marad — a „régi, de helyes" mindig jobb, mint a „friss, de rossz".

Országhű letöltés

Hogy a bolt eleve a helyes pénznemet mutassa, az EchoAI az ilyen, ország szerint árazó boltokat a bolt országából olvassa be. A csatlakozó felhasználó országát az EchoAI a kapcsolatból ismeri fel, és úgy állítja be a beolvasást, hogy az onnan „nézzen be" a boltba.

Limitek és viselkedés

Gyakori hibák és megoldások