A UNAS API kulcs az a 64-100 karakteres, alfanumerikus titkosító-szám, amellyel a külső szolgáltatások (mint a ShopChatly, vagy egy egyedi integrációs eszköz) hozzáférnek a webshopod adataihoz: termékekhez, rendelésekhez, vásárlókhoz. Soha nem osztod meg nyilvánosan, és csak fizetős UNAS csomagokon (Prémium és VIP) érhető el.

Ez az útmutató pontosan végigvezet, hogyan lépj be, hogyan generáld le, milyen jogokat adj meg, és hogyan kezeld biztonságosan.

Előfeltételek

UNAS Prémium vagy VIP előfizetés. A Plus csomagon nincs API. Ha most még Plus-on vagy, frissíts UNAS-on belül a Beállítások → Előfizetés menüben.
Admin hozzáférés. Az API menü csak a fő admin-felhasználónál látható. Ha sub-admin vagy, a tulajdonosnak kell legenerálnia.
5 perc. Az egész folyamat ennyi idő.

1. lépés — Belépés a UNAS adminba

Lépj be az UNAS admin felületére:

https://[a-te-boltod].unas.hu/admin/

A bejelentkezés után az Áttekintés oldalra érkezel. Innen indul a navigáció.

2. lépés — Beállítások → Külső kapcsolatok → API kapcsolat

A bal oldali menüben:

Kattints a „Beállítások”-ra (fogaskerék ikon)
Görgess le a „Külső kapcsolatok” csoporthoz
Kattints az „API kapcsolat”-ra

Itt egy táblázatot látsz a meglévő API-kapcsolataidról. Ha még nincs egyetlen sem, üres a táblázat.

3. lépés — Új API kapcsolat hozzáadása

Kattints a táblázat felett a „Hozzáad” vagy „Új” gombra (jobb felső sarok). Egy űrlap nyílik meg:

Mező	Mit adj meg
Név	`ShopChatly` (vagy bármi, amit később felismersz)
Leírás	`AI chatbot termékszinkron` (opcionális, de ajánlott)
Aktív	Pipa be

Engedélyezett funkciók

Ez a legfontosabb rész. Egy lista mutatja, milyen UNAS-műveletekre kap engedélyt az API kulcs. A ShopChatly számára a következőket pipáld be:

✅ Termékek olvasása (getProduct, getProducts)
✅ Kategóriák olvasása (getCategory, getCategories)
✅ GYIK / FAQ olvasása (ha van)
✅ Statikus oldalak olvasása (Plusz oldalak)
✅ Rendelések olvasása (rendelés-státusz lekérdezéshez)
✅ Készlet olvasása (getStockInfo)
✅ Kuponok olvasása és írása (cart recovery-hez kell az írás is — Pro+ csomagon)
✅ Automatizálás (abandoned cart) (csak Pro+ ShopChatly esetén)

A „Vásárlók adatai” és a „Rendelés módosítása / törlése” jogokat NE pipáld be — a ShopChatly-nek nincs szüksége rájuk, és csökkentik a kockázatot, ha valami rossz kulcs-szivárgás történne.

4. lépés — Mentés és kulcs másolása

Kattints a „Mentés” gombra. A táblázatba visszakerülsz, és most látsz egy új sort:

Név	API kulcs	Aktív
ShopChatly	`7f3a9c2b8e1d6f5a4c8b3e2a...`	✓

Az API kulcs egy hosszú, véletlenszerű karaktersor. Kattints rá (vagy a melletti „Másolás” gombra), hogy a vágólapra kerüljön.

⚠️ Megjegyzés: Az API kulcs csak ekkor látható teljes hosszában. Ha kilépsz az oldalról és visszatérsz, a kulcs egy része el lesz takarva (pl. csak az első és utolsó 4 karakter látszik). Tehát most másolod ki vagy újra-generálnod kell később.

5. lépés — A kulcs beillesztése a ShopChatly-be

Nyiss egy új böngészőfület és menj a ShopChatly dashboard-ra:

https://shopchatly.com/dashboard

Lépj be, majd:

Ha új user vagy: a wizard 2. lépésében megjelenik egy mező — illeszd be ide
Ha már létező user: Beállítások → 2. UNAS csatlakozás → kulcs beillesztés → Mentés

A ShopChatly automatikusan ellenőrzi a kulcs érvényességét egy próba-API hívással. Ha jó, zöld pipát látsz. Ha nem, hibaüzenet:

Hibaüzenet	Mit jelent
„Érvénytelen API kulcs”	A kulcs rossz vagy lejárt — másold ki újra
„API funkciók nincsenek engedélyezve”	A 3. lépésben elfelejtettél bepipálni egy funkciót
„Nem Prémium / VIP csomag”	A UNAS előfizetésed nem támogatja az API-t
„Túl sok kérés (rate limit)“	Túl sokszor próbálkoztál — várj 5 percet

Biztonsági tudnivalók

Hol tárolja a ShopChatly a kulcsodat?

Titkosítva, AES-256 algoritmussal, a saját adatbázisunkban. A megnyitott dashboard sehol nem mutatja vissza a kulcsot — még az adminban sem. Ez azt jelenti, hogy ha valaki feltöri a ShopChatly-t, a kulcsod akkor sem olvasható ki közvetlenül.

A kulcsot csak a ti webshopotok termékszinkronjához használjuk. Soha nem osztjuk meg harmadik féllel, és nem használjuk nyílt szöveges naplózásra.

Mit csináld, ha a kulcsod kompromittálódott?

Ha bármi okból úgy gondolod, hogy a kulcsod nyilvánosságra került (pl. véletlen Git commit-ban, képernyőképen):

Azonnal menj vissza a UNAS adminra
Beállítások → Külső kapcsolatok → API kapcsolat
Az érintett kulcs sorát töröld (vagy állítsd inaktívra)
Generálj egy újat
A ShopChatly dashboardban a Beállítások → 2. lépés-ben frissítsd

A régi kulcs az új generálással azonnal érvénytelenné válik, és senki nem tud többé adatot lekérni vele.

Hány API kulcsot tarthatok?

A UNAS Prémium általában 5 darab API kulcsot enged egyszerre, a VIP 10 darabot. Ezt a Beállítások → Előfizetés oldalon ellenőrizheted.

Ha több külső szolgáltatást használsz (chatbot, ERP, raktárkezelő), mindenkinek külön kulcsot adj — soha ne ossz meg ugyanazt. Így ha valamelyik szolgáltatást kicseréled vagy egyik kompromittálódik, csak a saját kulcsát kell visszavonni.

Összefoglalás

UNAS Prémium vagy VIP csomag kell
Beállítások → Külső kapcsolatok → API kapcsolat → Hozzáad
Termék, kategória, GYIK, készlet, rendelés (olvasás) — pipa be
Vásárlói adatok, rendelés-módosítás — ne pipáld be
Mentés, másolás, beillesztés a ShopChatly-be
Kompromittálás esetén: új kulcs + ShopChatly frissítés

Ha bármi nem világos, írj a info@shopchatly.com-ra — egy ember válaszol, és segít.

UNAS API kulcs beállítása lépésről lépésre