Suara

Integrációk, kulcsok és háttérfeladatok

Fizetés, számlázás, szállítás, AI: a beépített integrációk, az API-kulcsok megadása és a háttérfeladatok.

Haladási szint

0% · Befejezés: 3 perc

Az alkalmazásod nem kell, hogy mindent maga tudjon. Online fizetés, számlázás, csomagküldés vagy egy AI-asszisztens – ezekhez külső szolgáltatásokat köthetsz be. A Suara több népszerű, magyar vállalkozásoknak fontos szolgáltatáshoz eleve tartalmaz kész integrációt. Ez a cikk megmutatja, mi érhető el, hogyan adod meg a kulcsokat, és mik azok a háttérfeladatok.

Beépített integrációk

A projektoldalon az Eszközök → Beállítások → Integrációk nézetben látod a projekthez bekapcsolt integrációkat. Az Új integráció gombbal böngészheted a teljes listát, kategóriák szerint szűrve vagy kereséssel:

  • Fizetés: Barion, SimplePay (OTP Mobil), Stripe
  • Számlázás: Billingo, Számlázz.hu
  • Szállítás: Foxpost, GLS, Packeta (Zásilkovna)
  • Webshop: Shoprenter, UNAS
  • Adó: NAV adószám-ellenőrzés
  • AI: OpenAI (ChatGPT), Anthropic (Claude), DeepSeek
  • Email: Resend
  • Google: Google Calendar, Sheets, Drive és Gmail
  • Felhő: Suara Cloud

Ezeket az AI eleve ismeri, és mindegyikhez kész építőelemei vannak. Ezért elég hétköznapi nyelven kérned:

A webshopomban lehessen Barionnal fizetni, és sikeres fizetés után a Számlázz.hu automatikusan állítsa ki a számlát.

A rendelésnél a vásárló választhasson Foxpost csomagautomatát, és a címkét is a rendszer készítse el.

Tegyél az oldalra egy chatbotot, ami az ÁSZF-ünk alapján válaszol a vásárlók kérdéseire.

A magyar piacra szabott integrációk (például Barion, Billingo, Foxpost vagy a NAV adószám-ellenőrzés) akkor jelennek meg a listában, ha magyarul, illetve Magyarországról használod a Suarát.

Kulcsok megadása

A legtöbb szolgáltatás egy vagy több API-kulcsot kér, amellyel az alkalmazásod azonosítja magát náluk. Ezeket a szolgáltató felületén, a saját fiókodban kapod meg. Kétféleképpen adhatod meg őket.

1. Amikor az AI kéri a chatben

Ha az AI építés közben egy integrációt köt be, felugrik az API Kulcsok Szükségesek ablak. Minden mezőnél ott a Hol szerzem be? link, ami megmutatja, hol találod az adott kulcsot. Töltsd ki a mezőket, és kattints az API Kulcsok Mentése gombra.

Ha még nincs kéznél a kulcs, válaszd a Később adom meg lehetőséget. Az AI ilyenkor példaadatokkal fejezi be a funkciót, hogy ki tudd próbálni az alkalmazást. Amint megadod a kulcsot, a funkció valódi adatokkal fog működni.

📷 KÉP: az „API Kulcsok Szükségesek” ablak Barion-kulcsmezőkkel, a „Hol szerzem be?” linkekkel és a „Később adom meg” gombbal

2. Az Integrációk nézetben

  1. Nyisd meg az Eszközök → Beállítások → Integrációk nézetet, és kattints az Új integráció gombra.
  2. Válaszd ki a szolgáltatást. Az adatlapon a Funkciók alatt látod, mire lesz képes vele az alkalmazásod.
  3. A Kapcsolat beállítása részben add meg a szükséges kulcsokat. A Honnan szerezd be ↗ link a szolgáltató megfelelő oldalára visz.
  4. Kattints a Bekapcsolás gombra. Amíg valamelyik kulcs hiányzik, a gomb nem aktív, és a Suara megmutatja, melyik kulcs hiányzik még.

Egy bekapcsolt integráció kulcsait később a Kulcsok mentése gombbal cserélheted le. A Kikapcsolás gombbal lekapcsolod az integrációt, a hozzá tartozó kulcsokkal együtt.

Sok szolgáltatásnak van teszt és éles üzemmódja (a Barionnál például a „test” és a „prod”). Kezdd teszt kulcsokkal, és csak akkor válts élesre, ha minden rendben működik.

Hol tárolódnak a kulcsok?

A kulcsok titkosítva tárolódnak, és csak szerveroldalon használatosak: a látogatóid sosem látják őket, és a felületen sem jelennek meg újra. Ha bekapcsolod a Haladó módot (profilmenü → Megjelenés → Haladó mód), a Suara Cloud → Hozzáférési kulcsok nézetben az összes kulcsot egy helyen kezelheted: újat adhatsz hozzá, módosíthatod vagy törölheted őket.

Az API-kulcsot soha ne írd bele a chatüzenetbe, és ne oszd meg nyilvánosan. Mindig a kulcsok számára kialakított mezőben add meg.

Háttérfeladatok (edge functionök)

Egy fizetés indítása vagy egy számla kiállítása nem történhet a látogató böngészőjében, hiszen ott a kulcsok nem lennének biztonságban. Ezért az AI az ilyen műveleteket háttérfeladatként építi meg: ezek kis automatizmusok, amelyek a Suara Cloudon futnak az alkalmazásodért, például e-mailt küldenek egy űrlap elküldése után. (Fejlesztői nyelven ezek az edge functionök.)

Ezekkel általában semmi dolgod: az AI automatikusan beállítja őket, amikor egy funkciónak szüksége van rá. Haladó módban a Suara Cloud → Háttérfeladatok nézetben látod a listájukat (név, állapot, verzió, utolsó frissítés), és a Háttérfeladatok újraindítása gombbal újraindíthatod őket. Ha valami nem működik, a Tevékenység nézet naplója segít kideríteni, mi történt – vagy egyszerűen írd le a hibát az AI-nak.

Tippek

  • Nevezd meg a szolgáltatót a kérésedben („SimplePay-jel”, „GLS-sel”), így az AI a kész integrációt használja.
  • Ha egy integráció a Suara Cloudot igényli, az AI azt is bekapcsolja.

Kapcsolódó cikkek