Suara

Notion integráció

Gyors és érthető leírás, hogy hogyan kösd be a Notion fiókodat a Suara rendszerébe.

Haladási szint

0% · Befejezés: 4 perc

Mi a Notion?

A Notion egy rugalmas jegyzet-, dokumentum- és adatbázis-eszköz. A tartalom oldalakban és adatbázisokban él, ahol minden bejegyzés külön oldal tulajdonságokkal.

Mire használhatod a Suarában?

Ha összekötöd a Notiont, az appod a Notion oldalaidat és adatbázisaidat tartalomként vagy adatként használhatja. Néhány példa:

  • Blog vagy tudásbázis: az app a Notionben írt cikkeket jeleníti meg.

  • Űrlapból bejegyzés: egy űrlap új sort vesz fel egy Notion-adatbázisban.

  • Egyszerű CRM: az ajánlatkérések adatbázis-bejegyzésként érkeznek.

  • Feladatlista: a csapat feladatait az app a Notionből olvassa.

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

  • Keresés: megkeresi azt, amit az integráció lát.

  • Adatbázis lekérdezése: szűréssel és rendezéssel kéri le a bejegyzéseket.

  • Bejegyzés létrehozása: új sort vesz fel egy adatbázisban.

Biztonság

A belső integráció titkos kulcsa 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 Notiont, 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.

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

1. Hozz létre egy belső integrációt a Notionben

  1. Jelentkezz be a Notionbe.

  2. Nyisd meg az integrációk oldalt: https://www.notion.so/profile/integrations

  3. Hozz létre egy új belső (Internal) integrációt, és adj neki nevet (például „Suara”). A Notion újabb felületén az integrációkat „connection”-ként is említheti.

  4. Mentés után másold ki az Internal Integration Secret értékét.

  5. Nyisd meg azt az oldalt vagy adatbázist, amelyet az appnak el kell érnie, kattints a ••• menüre, majd a Connections pontban add hozzá az integrációt. A szülőoldal megosztása a gyerekoldalakat is megosztja.

Fontos: az integráció csak azokat az oldalakat és adatbázisokat látja, amelyeket megosztottál vele a Connections menüben. Ha ezt kihagyod, a hívások 404-es hibát adnak, még érvényes kulccsal is.

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 Notiont. A Produktivitás kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).

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

  4. Töltsd ki a mezőt:

    • Internal integration secret: a másolt titkos 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 lekérdezi az integráció adatait, és ha a kulcs érvényes, a kapcsolat Notion · {munkaterület neve} 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 „Az ajánlatkérő űrlap beküldésekor vegyél fel egy új bejegyzést a Notion Ajánlatkérések adatbázisában.” 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 Notion 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 chatben futó műveletekhez ennél az integrációnál külön Chat-hozzáférést (MCP) is össze kell kötni: az Integrációk → Kapcsolataid alatt a kapcsolat részleteinél a Chat-hozzáférés összekötése (MCP) gombbal.

A bekötés után az AI a Notion-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 Notion kapcsolatra kattintva elérhető:

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

  • Kulcsok frissítése: új titkos kulcs mentése, ha újrageneráltad 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 Notiont.

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), és hogy belső (Internal) integrációtól származik.

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

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

  • 404-es hiba vagy „nem találom az oldalt”: Az oldalt vagy adatbázist nem osztottad meg az integrációval. Nyisd meg a Notionben, a ••• menüben válaszd a Connections pontot, és add hozzá az integrációt.