Airtable integráció

Mi az Airtable?

Az Airtable egy táblázat és adatbázis keveréke. A base-ekben táblák vannak, a táblákban rekordok, a rekordokhoz pedig különböző típusú mezők tartoznak. Sok csapat ezzel vezeti a tartalmait, készletlistáit, foglalásait vagy egyszerű CRM-jét.

Mire használhatod a Suarában?

Ha összekötöd az Airtable-t, az appod az Airtable base-eidet adatbázisként használhatja, az AI pedig olvasni és írni tudja a rekordokat. Néhány példa:

• Űrlapból rekord: a weboldalad űrlapja új rekordot hoz létre egy kijelölt táblában.

• Tartalom vagy katalógus: az app az Airtable-ben vezetett termékeket, programokat vagy cikkeket jeleníti meg.

• Foglalások, készlet: a csapat az Airtable-ben szerkeszti az adatokat, az app pedig az aktuális adatokat mutatja.

• Egyszerű CRM: az ajánlatkérések rekordként érkeznek meg, az állapotukat az app vissza tudja olvasni.

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

• Base-ek és táblák listázása: megmutatja, mely base-eket és táblákat éri el a token.

• Rekordok olvasása: szűréssel (képlettel vagy nézettel) kéri le a rekordokat.

• Rekord létrehozása és frissítése: új sort vesz fel, vagy módosít egy meglévőt.

Biztonság

A personal access token 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 Airtable-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.

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

1. Szerezd meg a personal access tokent az Airtable-ben

1. Jelentkezz be az Airtable-be.

2. Nyisd meg a tokenek oldalt: https://airtable.com/create/tokens

3. Kattints a Create token gombra, és adj a tokennek nevet (például „Suara”).

4. A jogosultságoknál (Scopes) add hozzá: data.records:read, data.records:write és schema.bases:read.

5. Az Access résznél jelöld ki azokat a base-eket, amelyeket az appnak el kell érnie.

6. Kattints a Create token gombra, majd másold ki a tokent. A token pat-tal kezdődik.

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 Airtable-t. 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 az „Airtable csatlakoztatása” ablak.

4. Töltsd ki a mezőt:

   • Personal access token: a másolt token.

   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 Airtable-fiókodat, és ha a token érvényes, a kapcsolat Airtable 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 új rekordot az Airtable Ajánlatkérések táblájá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 az Airtable 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 az Airtable-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 Airtable kapcsolatra kattintva elérhető:

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

• Kulcsok frissítése: új token 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 Airtable-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 token helyesen lett kimásolva (szóköz nélkül), és hogy pat-tal kezdődik.

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

• Az app nem éri el az Airtable-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 base-t vagy táblát: A token csak azokat a base-eket éri el, amelyeket a létrehozásakor az Access résznél kijelöltél. Bővítsd a token hozzáférését az Airtable-ben, vagy hozz létre újat.

• 403-as hiba: Ez nemcsak a hiányzó hozzáférést jelentheti, hanem azt is, hogy rossz base- vagy táblanevet adtál meg. Ellenőrizd mindkettőt.

• Az írás hibával áll meg: Ellenőrizd, hogy a token megkapta a data.records:write jogosultságot.