Suara

UNAS integráció

Gyors és érthető leírás, hogy hogyan kösd be az UNAS webshopodat a Suara rendszerébe.

Haladási szint

0% · Befejezés: 4 perc

Mi az UNAS?

Az UNAS egy magyar webáruház-motor. A bolt termékeit, rendeléseit és kategóriáit az adminban kezeled, és az UNAS XML API-n keresztül is elérhetők.

Mire használhatod a Suarában?

Ha összekötöd az UNAS-t, az appod a meglévő webshopod adataival dolgozhat. Néhány példa:

  • Egyedi kirakat: az UNAS termékeit az app saját megjelenéssel mutatja.

  • Készlet-dashboard: egy oldal a készlet és az árak aktuális állapotát mutatja.

  • Rendelési riport: egy oldal a rendelésekből készít kimutatást.

Az AI az alábbi műveleteket használja:

  • Termékek olvasása és módosítása: lekéri a termékeket, és az árat, a készletet vagy a termékadatokat módosítani tudja (létrehozás és törlés is).

  • Rendelések olvasása és állapotának módosítása: lekéri a rendeléseket, és át tudja állítani egy rendelés állapotát.

  • Kategóriák olvasása: lekéri a kategóriákat.

Biztonság

Az API-kulcs titkosítva, a Suara szerverén marad. A generált app sosem látja, és a böngészőbe sem kerül. Az app a Suara gatewayen keresztül hívja az UNAS-t, a gateway pedig a háttérben hozzáadja a hitelesítő adatokat. A kapcsolatot a láthatóság beállításával korlátozhatod: Csak én, Csak kiválasztott tagok vagy Az egész munkaterület.

Jóváhagyás: az olvasás jóváhagyás nélkül fut. A termék vagy a rendelés módosítása előtt a chat jóváhagyást kér (a Mindig engedélyezem beállítás elérhető).

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

1. Szerezd meg az API-kulcsot az UNAS adminban

  1. Jelentkezz be az UNAS adminba.

  2. Nyisd meg a Beállítások → Külső kapcsolatok oldalt, és az API-kapcsolatnál (leírás: https://unas.hu/tudastar/api) hozz létre egy API-kulcsot, és másold ki.

Fontos: az API-kulccsal a bolt adatait olvashatják és módosíthatják. Ne oszd meg.

2. Kösd be a Suarában

  1. A Suara oldalsávjában nyisd meg az Integrációk oldalt.

  2. A Katalógusban keresd meg az UNAS-t. A Webshop kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).

  3. Kattints a Csatlakoztatás gombra. Megnyílik az „Unas csatlakoztatása” ablak.

  4. Töltsd ki a mezőt:

    • API kulcs: a másolt kulcs.

    A beillesztett titkos érték a Kulcs megjelenítése ikonnal ellenőrizhető. A Hol találom? hivatkozás a szolgáltatás megfelelő oldalára visz.

  5. Válaszd ki, ki használhatja a kapcsolatot (Csak én vagy Az egész munkaterület). Ha a teljes munkaterületnek engedélyezed, a Suara figyelmeztet, hogy minden tag használhatja a kapcsolatot a saját projektjeiben.

  6. Kattints a Mentés és ellenőrzés gombra. A Suara bejelentkezik az UNAS API-ba, és ha a kulcs érvényes, a kapcsolat Unas néven megjelenik a Kapcsolataid között.

3. Használd a projektedben

Három módon használhatod a kapcsolatot:

  • A chatben kérve: írd le az AI-nak, mit szeretnél, például „Építs egy készlet-dashboardot, amely az UNAS boltom termékeit és készletét mutatja.” Ha még nincs kapcsolat, az AI felkínálja a csatlakoztatást.

  • Az Integrációk oldalról: a Kapcsolataid között az Unas mellett a Bekötés az appba gombbal kötheted be a kapcsolatot egy projektbe.

  • A projekt Kapcsolatok oldaláról: nyisd meg a projekt Kapcsolatok részét, és kattints a Kapcsolat gombra. Ott a Munkaterület kapcsolatai közül választhatsz egy meglévőt, vagy az Új bekötése gombbal újat hozhatsz létre.

A projektekbe kötéshez be kell kapcsolni a Suara Cloudot. Ha még nincs bekapcsolva, kérd meg az AI-t a chatben. A kapcsolatot ettől függetlenül használhatod csak a chatben is (Csak chat), az appba bekötni később is lehet.

A bekötés után az AI az UNAS-hívásokat az app szerveroldali (edge function) részében generálja. A hitelesítő adatok így nem kerülnek a kódba, és a kapcsolatot szükség esetén a projekt Kapcsolatok oldaláról bármikor leválaszthatod.

Kapcsolat kezelése

Az Integrációk → Kapcsolataid alatt az Unas kapcsolatra kattintva elérhető:

  • Alapadatok: az elnevezés és a láthatóság módosítása.

  • Kulcsok frissítése: új API-kulcs mentése, ha lecserélted vagy törölted a régit.

  • Kapcsolt projektek: itt látod, mely projektek használják a kapcsolatot.

  • Utolsó hívások: itt látod a legutóbbi hívásokat (metódus, útvonal, státusz, időtartam, forrás: alkalmazás vagy chat).

  • Leválasztás (Veszélyzóna): megszünteti a kapcsolatot. A hozzá kötött projektek ezután nem érik el az UNAS-t.

A státusz lehet Aktív, Hiba vagy Visszavonva. Ha Újracsatlakozás szükséges üzenetet látsz, mentsd újra a kulcsot.

Hibaelhárítás

  • „Mentés és ellenőrzés” hibával áll meg: Ellenőrizd, hogy a kulcs helyesen lett kimásolva (szóköz nélkül).

  • A kapcsolat „Hiba” vagy „Visszavonva” státuszú: A kulcs törölve lett, lejárt, vagy visszavonták. Generálj új kulcsot az UNAS adminban, és mentsd el a Kulcsok frissítése résznél.

  • Az app nem éri el az UNAS-t: Ellenőrizd, hogy a kapcsolat be van-e kötve a projektbe, és hogy a Suara Cloud be van-e kapcsolva.

  • Nem látok egy terméket vagy kategóriát: Ellenőrizd, hogy a termék az UNAS-ban aktív és látható-e.

UNAS integráció | Suara