Shoprenter integráció

Mi a Shoprenter?

A Shoprenter egy magyar webshop-motor. A bolt termékeit, rendeléseit és ügyféladatait az adminban kezeled, és API-n keresztül is elérhetők.

Mire használhatod a Suarában?

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

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

• Belső dashboard: egy oldal a rendelések és termékek aktuális állapotát mutatja.

• Rendeléskövető oldal: a vásárló az oldalon megnézheti a rendelése állapotát.

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

• Termékek olvasása: lekéri a termékeket (név, ár, készlet, állapot).

• 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.

Biztonság

Az API-jelszó 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 a Shoprentert, 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 rendelés állapotának 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 a bolt azonosítóját és az API-hozzáférést a Shoprenterben

1. A bolt azonosítója a Shoprenter-címed első része: ha a bolt címe bolt.shoprenter.hu, akkor az azonosító bolt.

2. Jelentkezz be a Shoprenter adminba.

3. Nyisd meg a Beállítások → API hozzáférés oldalt.

4. Hozz létre egy API-felhasználót (vagy használd a meglévőt), és jegyezd fel a felhasználónevet és a jelszót.

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 a Shoprentert. 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 a „Shoprenter csatlakoztatása” ablak.

4. Töltsd ki a mezőket:

   • Bolt azonosító: a bolt címének első része, például bolt.

   • API felhasználó: az API-hozzáférés felhasználóneve.

   • API jelszó: az API-hozzáférés jelszava.

   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 lekér egy terméket a boltból, és ha az adatok érvényesek, a kapcsolat Shoprenter · {bolt azonosító} 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 rendeléskövető oldalt, amely a Shoprenter boltom rendeléseit 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 a Shoprenter 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 bekötés után az AI a Shoprenter-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 a Shoprenter kapcsolatra kattintva elérhető:

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

• Kulcsok frissítése: új API-felhasználó vagy jelszó mentése, ha lecseré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 a Shoprentert.

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 bolt azonosítója pontosan egyezik a bolt címének első részével, és hogy az API-felhasználónév és a jelszó helyes (szóköz nélkül).

• A kapcsolat „Hiba” vagy „Visszavonva” státuszú: Az API-felhasználót törölték vagy megváltozott a jelszava. Állítsd be újra a Shoprenter adminban, és mentsd el a Kulcsok frissítése résznél.

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

• Rossz bolt azonosító: Az azonosító csak a bolt címének első része (például bolt), nem a teljes cím.