UNAS webáruház bekötése

Ha UNAS webáruházad van, bekötheted a Ninjába — onnantól az AI a valódi termékeidből és blogcikkeidből dolgozhat, nem kitalált dolgokról ír.

Mielőtt belekezdesz

Az API-kulcs csak PREMIUM és VIP UNAS-csomaggal érhető el; Standard csomagnál nincs API kapcsolat menüpont az UNAS-ban — lásd Melyik UNAS csomag kell a bekötéshez?.

Kérd le a kulcsot az UNAS-ban — lépj be az UNAS admin felületére, és nyisd meg a Beállítások → Külső kapcsolatok → API kapcsolat menüpontot. Itt generálj egy API-kulcsot.
Engedélyezd a funkciókat — pipáld be mind a tízet, így később nem kell visszamenned az UNAS-ba: getProduct (termékek olvasása — enélkül semmi nem működik), getCategory (kategóriák), setProduct és setCategory (a Shopgrade átírt termék- és kategóriaszövegének visszaírása), getPageContent, setPageContent, getPage, setPage (blogcikk kiküldése és a blog-oldalhoz rendelése), getStorage, setStorage (a blogcikk képei). A Új kulcs ablak ugyanezt a listát mutatja.
Másold ki a kulcsot — az UNAS csak egyszer mutatja meg, ezért másold vágólapra.
Nyisd meg az Integrációk oldalt — a Ninjában a bal menüben a Beállítások → Integrációk, majd kattints az UNAS kártyára.
Vedd fel a kulcsot — az Új kulcs gombbal. A Webshop neve mezőbe írj egy felismerhető nevet (például „Kávéshop UNAS"), az API-kulcs mezőbe illeszd be a kulcsot.
Teszteld, majd mentsd — kattints a Teszt gombra. Mentés csak sikeres teszt után lehetséges — így nem marad benn rossz kulcs.

A kulcsot titkosítva tároljuk, és később már nem kérhető vissza — csak az utolsó 4 karaktere látszik. Ha elveszett, generálj újat az UNAS-ban.
A kulcs önmagában még nem elég a posztokhoz: a bekötés után csinálj belőle tudásforrást is (Tudásforrások → Új forrás → Típus: UNAS), és ott válaszd ki ezt a kapcsolatot. Lásd: Tudásforrások használata.
Nem sikerül a teszt? Olvasd el a Teszt üzenetét: megmondja, rossz-e a kulcs, épp nem érhető-e el a bolt, vagy melyik jog hiányzik (pl. „nincs bekapcsolva a getProduct jog"). Jog-hiánynál pipáld be az UNAS-ban, mentsd, majd futtasd újra a Tesztet — a kulcsot nem kell cserélned.
Sikeres a teszt, de figyelmeztetést ír? Az a funkció, amit felsorol (pl. setProduct), nincs bepipálva — a teszt ettől még zöld, de az adott rész (pl. a Shopgrade visszaírása) nem fog menni, amíg be nem kapcsolod.
A Shopgrade nem talál egy terméket? A kereső a boltod mentett terméklistájából dolgozik, ami 30 percenként magától frissül — egy frissen felvitt termékhez nyomd meg a kereső alatti Frissítés gombot. Ha a kereső hibát ír a jogról, a getProduct hiányzik a kulcsodról.