monday.com integráció

Mi a monday.com?

A monday.com egy vizuális munkakezelő platform. A munkát táblákon (board) vezeted, a táblákon elemek (item) vannak, az elemekhez pedig oszlopok tartoznak, például státusz, felelős vagy dátum.

Mire használhatod a Suarában?

Ha összekötöd a monday.com-ot, az appodból elemeket hozhatsz létre és olvashatsz a monday.com tábláidon. Néhány példa:

• Igénylő űrlap: az űrlap beküldése új elemet hoz létre a táblán, kitöltött oszlopértékekkel.

• Ügyfélportál: az ügyfél látja a hozzá tartozó elem státuszát.

• Belső eszköz: egy dashboard a tábláid elemeit és oszlopait mutatja.

• Lead-követés: az ajánlatkérések új elemként érkeznek az értékesítési táblára.

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

• Táblák és oszlopok listázása: megmutatja a táblák szerkezetét.

• Elemek olvasása: lekéri egy tábla elemeit.

• Elem létrehozása: oszlopértékekkel együtt új elemet vesz fel.

Biztonság

A személyes API 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 a monday.com-ot, 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 személyes API tokent a monday.com-ban

1. Jelentkezz be a monday.com-ba.

2. Kattints a profilképedre a jobb felső sarokban, és válaszd a Developers menüpontot.

3. A fejlesztői felületen nyisd meg a My access tokens részt.

4. Kattints a Show gombra, majd a Copy gombbal másold ki a tokent.

5. Részletek: https://developer.monday.com/api-reference/docs/authentication

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 monday.com-ot. 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 „monday.com csatlakoztatása” ablak.

4. Töltsd ki a mezőt:

   • Személyes API 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 a monday.com-profilodat, és ha a token érvényes, a kapcsolat monday.com · {neved} 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 hozz létre egy új elemet a monday.com Leadek táblán, a státusz legyen Új.” 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 monday.com 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 monday.com-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 monday.com 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 ú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 monday.com-ot.

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

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

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

• Egy új elem státusza hibát ad: A státuszoszlopnak megadott címkének léteznie kell a táblán. Ellenőrizd, hogy az oszlop tartalmazza-e a kért értéket (például az Új címkét).

• Nem látok egy táblát: A token csak azokat a táblákat éri el, amelyekhez a tokent birtokló fióknak is van hozzáférése.