Ugrás a fő tartalomhoz

Az integrációkról

Az integrációk a Base44-et a többi eszközéhez kapcsolják, így automatizálhatja a munkafolyamatokat, behúzhat adatokat, és külső szolgáltatásokat hívhat anélkül, hogy minden API-hívást kézzel kellene bekötnie. 3 szinten integrálhat:
  • Alkalmazásszint: Egyetlen alkalmazáson belüli integrációk:
    • Beépített integrációk, például az Invoke LLM és a SendEmail.
    • Összekötők OAuth-alapú kapcsolatokhoz olyan eszközökkel, mint a Notion, a Slack vagy a Google Workspace.
    • Külső API-hívások backend-függvényekkel, alkalmazásonkénti titkos adatokkal és függvényekkel.
    • Alkalmazás-MCP-szerver, amellyel az olyan MI-asszisztensek, mint a Claude, a ChatGPT és a Cursor biztonságosan csatlakozhatnak a közzétett alkalmazáshoz, és használhatják annak adatait és műveleteit.
  • Munkaterületi szint: A teljes munkaterület számára egyszer kezelt, közös API-k:
    • Egyéni OpenAPI-integrációk OpenAPI-specifikációk alapján, amelyeket a munkaterület bármely alkalmazása biztonságosan hívhat.
  • Fiókszint: A Base44-fiókjához tartozó kapcsolatok:
    • MCP-kapcsolatok, amelyeket egyszer konfigurál, hogy a Base44 MI-csevegés építés közben külső eszközöket használhasson, az alkalmazás telepített kódjának módosítása nélkül.

Alkalmazásszintű integrációk

Az alkalmazásszintű integrációk egyetlen alkalmazáson belül élnek. Ide tartoznak a beépített integrációk, az összekötők és a backendre épülő külső API-k, amelyeket csak az adott alkalmazáshoz köt be.

Beépített integrációk

Egyes integrációk előre telepítve érkeznek a Base44-ben, és azonnal használhatók. A legtöbb bármely csomagban működik, további beállítás vagy külön API-kulcs nélkül. Ezekkel az alapintegrációkkal MI-t, üzenetküldést, fájlkezelést és haladó logikát adhat bármely alkalmazáshoz. A Base44 beépített integrációi:
  • Invoke LLM: MI-válaszok generálása részletes promptokból, JSON-séma szerinti kimenettel, fájlmellékletekkel, képelemzéssel és webes kereséssel.
  • SendEmail: E-mailek küldése az alkalmazásból saját küldőnévvel és HTML-tartalommal, vagy valamelyik megtervezett e-mail elküldése.
  • SendPushNotification: Push-értesítés küldése egy személynek a natív mobilalkalmazásban, opcionálisan egy adott oldalra mutató hivatkozással.
  • UploadPublicFile: Olyan fájlok feltöltésének lehetővé tétele, amelyeket a hivatkozás birtokában bárki megnyithat, például profilképek vagy termékfotók. A visszaadott fájl-URL más integrációkban vagy munkafolyamatokban is használható.
  • UploadPrivateFile: Személyes vagy érzékeny adatokat tartalmazó fájlok privát tárolása, hogy csak az alkalmazás nyithassa meg őket.
  • CreateFileSignedUrl: Ideiglenes hivatkozás létrehozása egy privát fájlhoz, hogy valaki megtekinthesse vagy letölthesse.
  • GenerateImage: Képek létrehozása szöveges promptokból, önmagukban vagy megadott referenciaképek alapján.
  • GenerateVideo: Videók létrehozása szöveges promptokból.
  • GenerateSpeech: Szöveg átalakítása beszédhanggá.
  • TranscribeAudio: Rögzített beszéd átalakítása szöveggé.
  • ExtractDataFromUploadedFile: Strukturált adatok kinyerése feltöltött CSV-, XLSX-, JSON-, HTML-, PNG-, JPG-, JPEG- és PDF-fájlokból JSON-sémák segítségével.
További információ a beépített integrációkról.

Összekötők

Az összekötők OAuth-alapú integrációk, amelyekkel egy adott alkalmazás támogatott eszközökhöz csatlakozhat. Megkéri az MI-csevegést, hogy csatlakoztasson egy szolgáltatást, bejelentkezik, és jóváhagyja a kért jogosultságokat. Ezután az alkalmazás az engedélyezett módon olvashat vagy írhat adatokat az adott eszközben. Példák arra, mit építhet összekötőkkel:
  • Egy Notion-adatbázis szinkronizálása az alkalmazás tudásbázis-nézetéhez.
  • Frissítések közzététele egy Slack-csatornán.
  • Salesforce- vagy HubSpot-rekordok szinkronizálása egy belső irányítópultra.
  • Fájlok mentése az alkalmazásból a Google Drive-ra.
  • Idősáv lefoglalása a Google Calendarban új foglaláskor.
  • LinkedIn-bejegyzés közzététele új blogbejegyzés megjelenésekor.
  • TikTok-profilstatisztikák és követőszámok megjelenítése egy irányítópulton.

Külső API-hívások backend-függvényekkel

A backend-függvényekkel megvalósított külső integrációk lehetővé teszik, hogy egy adott alkalmazás alkalmazásonkénti hitelesítő adatokkal közvetlenül kommunikáljon olyan külső szolgáltatásokkal, mint a Stripe, a Twilio vagy a Google API-k. Ezek a hívások az Ön saját backend-függvényein és titkos adatain keresztül futnak.
Integráció csatlakoztatása az alkalmazáshoz az MI-csevegéssel

Integráció csatlakoztatása a Base44-alkalmazáshoz az MI-csevegéssel

Akkor használjon backend-függvényeket, ha:
  • Egyszeri integrációt szeretne egyetlen alkalmazáshoz.
  • Szorosan az alkalmazáshoz kötött egyéni logikára van szüksége.
  • A szolgáltatás még nincs egyéni OpenAPI-integrációként beállítva a munkaterületén.
Példák backend-függvényekkel megvalósított külső integrációkra:
  • Üdvözlő e-mailek küldése az alkalmazás új felhasználóinak az e-mail-szolgáltatóján keresztül.
  • A meglévő CRM szinkronizálása az alkalmazás adatbázisával.
  • A csapat riasztása a Slacken, amikor valaki beküld egy űrlapot.
  • Tartalom generálása MI-eszközökkel a saját szolgáltatói kulcsaival.
  • Olyan beszállítóspecifikus API-k hívása, amelyekhez még nincs összekötő vagy egyéni OpenAPI-integráció.
  • Annak lehetővé tétele, hogy mindenki a saját fiókját csatlakoztassa egy OAuth2-bejelentkezést használó szolgáltatáshoz. Lásd: Saját bejelentkezéssel rendelkező szolgáltatás csatlakoztatása.
Ha az MI-csevegésben integrációt kér, a Base44 lépésről lépésre végigvezeti, és szükség esetén hitelesítő adatokat vagy engedélyt kér. Ezután automatikusan összekapcsolja a backend- és frontend-logikát, így gyorsan munkába állhat. A hitelesítő adatokat titkos adatként tárolja az alkalmazás irányítópultján, és a Kód > base44 > functions alatti TypeScript-függvényekben használja. Ismerje meg, hogyan adhatja hozzá, módosíthatja és törölheti az alkalmazás titkos adatait.
Minden backend-függvénynek van egy kódfájlja, amelyet szerkeszthet, megtekinthet és tesztelhet. Egy függvény naplóinak megtekintéséhez nyissa meg a fájlját a Kód részben, és kattintson a Logs elemre.

MI-asszisztensek csatlakoztatása

A közzétett alkalmazás saját MCP-szervert tehet elérhetővé, hogy az MI-asszisztensek az Ön által szabályozott hozzáféréssel használhassák az adatait és műveleteit. Ez eltér a fiókszintű MCP-kapcsolatoktól, amelyeket a Base44 MI-csevegés építés közben használ.

Munkaterületi szintű integrációk

A munkaterületi szintű integrációk egy munkaterületen élnek, és több alkalmazásban is újra felhasználhatók a beállítás vagy a hitelesítő adatok megismétlése nélkül.

Egyéni OpenAPI-integrációk

Az egyéni OpenAPI-integrációkkal közös külső API-kat regisztrálhat munkaterületi szinten egy OpenAPI-specifikációból. Egyszer importálja a specifikációt, kiválasztja az elérhetővé tenni kívánt műveleteket, és a munkaterület bármely alkalmazása meghívhatja ezeket a műveleteket az SDK-n keresztül. Az MI és a frontend-kód a base44.integrations.custom segítségével közvetlenül hívhatja az egyéni OpenAPI-integrációkat a hitelesítő adatok felfedése nélkül. A hívások a Base44 backendjén keresztül futnak, így a titkos adatok soha nem jutnak el a böngészőbe. Ez ideális a belső és a partner-API-khoz, amelyeket csapata több alkalmazásban használ.
Ki hozhat létre és használhat egyéni OpenAPI-integrációkat:
  • Csomag: Egyéni OpenAPI-integrációk létrehozásához vagy szerkesztéséhez Builder csomag vagy magasabb szükséges.
  • Szerepkör: Egyéni OpenAPI-integrációt csak a munkaterület tulajdonosai és adminisztrátorai hozhatnak létre vagy szerkeszthetnek.
  • Használat: A munkaterületen bárki használhat egy meglévő egyéni OpenAPI-integrációt az alkalmazásaiban, Free csomagban is.
Ezen API-k részletes konfigurálását az Egyéni API-integrációk kezelése oldalon ismerheti meg.

Fiókszintű kapcsolatok

A fiókszintű kapcsolatokat egyszer konfigurálja a Base44-fiókjához, és mindenhol elérhetők, ahol a Base44 MI-csevegést használja.

MCP-kapcsolatok

Az MCP-kapcsolatokkal egyéni MCP-szervereket csatlakoztathat Base44-fiókjához, így az MI-csevegés építés közben kontextusként használhatja a külső eszközöket és adatokat. Így kontextusérzékeny MI-csevegést kap az alkalmazás telepített futtatókörnyezetének módosítása nélkül.
Amit az MCP-kapcsolatokról tudni érdemes:
  • Csomag: Az MCP-kapcsolatokhoz Builder csomag vagy magasabb szükséges.
  • Beállítás: Az MCP-szervereket fiókonként egyszer konfigurálja a Fiókbeállítások → Builder → MCP-kapcsolatok részben.
  • Mikor használja őket: Az MI-csevegés csak akkor hív meg egy MCP-szervert, ha a prompt megkívánja (például ha megemlíti az adott szervert, vagy olyan adatot kér, amelyet az biztosít). Nem keres meg minden üzenetnél minden MCP-szervert.
Példák arra, mit tehet MCP-kapcsolatokkal:
  • Kérje meg az MI-csevegést, hogy keressen egy belső dokumentációs MCP-ben, és foglalja össze egy funkcióhoz a legrelevánsabb oldalakat.
  • Csatlakoztasson egy GitHub MCP-szervert, és kérjen összefoglalót egy adott tároló nyitott issue-iról.
  • Csatlakoztasson egy analitikai MCP-t, például az Amplitude-ot vagy egy egyéni mérőszám-szolgáltatást, és kérje meg a csevegést, hogy a módosítások tervezése közben húzza be a beszélgetésbe a legutóbbi termékmutatókat.
Az MCP-szerverek hozzáadását és kezelését az Egyéni MCP beállítása oldalon ismerheti meg.

API-kulcsok tárolása

Egyes integrációkhoz API-kulcs szükséges, amely egyfajta privát jelszóként működik az alkalmazás és a külső szolgáltatás között. A kulcsot az adott szolgáltatásban hozza létre, majd menti a Base44-ben, hogy az alkalmazás felfedés nélkül használhassa:
  • Alkalmazás titkos adatai: Egyetlen alkalmazás backend-függvényeihez mentse a kulcsot alkalmazásszintű titkos adatként az alkalmazás Titkos kulcsok oldalán, vagy illessze be az MI-csevegésbe, és a Base44 menti Ön helyett. Lásd: Az alkalmazás titkos adatainak kezelése.
  • Egyéni OpenAPI-integrációk: A munkaterület tulajdonosa vagy adminisztrátora egyszer, fejlécként adja hozzá a kulcsot az integráció létrehozásakor vagy szerkesztésekor, és a Base44 titkosítva tárolja a munkaterületen. Lásd: Egyéni API-integrációk kezelése.

GYIK

Kattintson az alábbi kérdésekre, hogy többet megtudjon az integrációk használatáról.
Az egyéni OpenAPI-integrációkat egyszer konfigurálja egy munkaterületen egy OpenAPI-specifikációból, és a munkaterület minden alkalmazása elérheti őket a base44.integrations.custom.call() segítségével. A hitelesítő adatok titkosított munkaterületi titkos adatként tárolódnak, és soha nem kerülnek az alkalmazás kódjába. Használatukhoz nincs szükség backend-függvényekre.Az alkalmazásonkénti külső API-k egy adott alkalmazás backend-függvényeit és titkos adatait használják. Alkalmazásspecifikus logikához ideálisak, vagy ha nem szeretne egy API-t a munkaterület összes alkalmazásával megosztani.
Az alkalmazás közzététele előtt tesztelje az integrációt, hogy időben észrevegye a hibákat:
  1. Ha a szolgáltató kínál ilyet, használjon sandbox- vagy tesztmódot (például Stripe tesztkulcsokat).
  2. Próbáljon ki valós folyamatokat és szélsőséges eseteket is, ne csak egyetlen ideális utat.
  3. Ellenőrizze, hogy a bemenetek és kimenetek megfelelnek-e a várakozásainak a felületen és a szolgáltató irányítópultján.
  4. Figyelje az integrációs kredithasználatot a Base44-ben és a külső szolgáltatásban is.
  5. Az élesítés előtt nézze meg az alkalmazás előnézetét, hogy észrevegye a lassú betöltést, a sikertelen API-hívásokat vagy a hiányzó adatokat.
Ha problémába ütközik, ellenőrizze a következőket:
  • Az API-kulcs helyes, és el van mentve a Secrets részben, illetve adott esetben az egyéni OpenAPI-integrációban.
  • Elegendő aktív kredittel rendelkezik a külső szolgáltatásban.
  • Éles folyamatok tesztelésekor éles, nem teszt hitelesítő adatokat használ.
  • Az API-kérés a helyes végpontot, adattartalmat és paramétereket tartalmazza.
  • Nem érte el a szolgáltatás sebességkorlátait.
A munkaterület tulajdonosai és adminisztrátorai hozhatnak létre backend-függvényeket a saját alkalmazásaikban. Az Editor szerepkörű közreműködők is szerkeszthetnek és létrehozhatnak backend-függvényeket egy alkalmazásban.
Ha backend-függvények használatakor 403-as hibát lát, a kérésből általában hiányoznak a jogosultságok.Gyakori okok és megoldások:
  • Jogosultságok a függvényben: Lehet, hogy a backend-függvény elutasítja a kérést, mert a felhasználó nincs bejelentkezve, vagy nincs megfelelő szerepköre. Ellenőrizze a függvény kódjába beépített szerepkör- vagy hozzáférés-ellenőrzéseket.
  • A külső szolgáltatás jogosultságai: A 403-as hiba a hívott külső API-tól is származhat. Győződjön meg róla, hogy az API-kulcs rendelkezik a megfelelő hatókörökkel, és a kérés a helyes végpontot és metódust használja.
  • Ha továbbra is gond van: Nézze meg a backend-függvényekre vonatkozó javításokat a Base44 fejlesztőeszközei oldalon, vagy forduljon a Customer Care csapatához.
Kétféle API-kulcsot kell esetleg újragenerálnia vagy frissítenie:
  • Külső szolgáltatások kulcsai: Generálja újra a kulcsot az adott szolgáltatás fejlesztői portálján, például az OpenAI, a Resend vagy a Notion esetében, majd módosítsa a titkos adat értékét az alkalmazás irányítópultján, vagy frissítse az egyéni OpenAPI-integráció beállításaiban.
  • A Base44-fiók API-kulcsa: A fiók API-kulcsai már nem támogatottak, és nem generálhat újat. A meglévő kulcsokat fokozatosan kapcsoljuk ki, ezért hozzon létre helyette személyes hozzáférési tokent, és frissítsen mindent, ami a régi kulcsot használta.
  • A beépített integrációk, az összekötők és a backend-függvényeket használó alkalmazásonkénti külső API-k továbbra is elérhetők maradnak.
  • Az egyéni OpenAPI-integrációk és az MCP-kapcsolatok leállhatnak, amíg nem vált Builder csomagra vagy magasabbra.
A Base44 maga nem küld szöveges üzeneteket (SMS). Ha az alkalmazásból szeretne ilyet küldeni, regisztráljon egy SMS-szolgáltatónál, mentse az API-kulcsát titkos adatként, és kérje meg az MI-csevegést, hogy egy backend-függvényen keresztül küldje az üzeneteket. Például:
Igen. Ugyanabban az alkalmazásban kombinálhatja a beépített integrációkat, az összekötőket, az egyéni OpenAPI-integrációkat és az alkalmazásonkénti külső API-kat, ha a csomagja és a beállításai támogatják őket.
Biztonsági okokból az olyan külső szolgáltatások, mint a Stripe, az OpenAI vagy a Notion, nem engedik, hogy harmadik felek, köztük a Base44, automatikusan hozzáférjenek a hitelesítő adataihoz. Ehelyett a következőket kell tennie:
  1. Jelentkezzen be a szolgáltatásba.
  2. Lépjen az API- vagy fejlesztői részhez.
  3. Generálja a kulcsot.
  4. Illessze be a Base44-be titkos adatként vagy munkaterületi fejlécként.
A hozzáadás után az alkalmazás vagy az egyéni OpenAPI-integráció biztonságosan, kód nélkül használhatja a kulcsot a háttérben.
Miért fontos ez: Az API-kulcsok jelszóként működnek a szolgáltatásokhoz. Ha privátan és az Ön felügyelete alatt maradnak, az adatai biztonságban vannak, és csak Ön engedélyezheti a hozzáférést.
Nem. Az MCP-kapcsolatok csak a Base44 MI-csevegésnek szólnak építés közben. Egyszer állítja be őket a fiókjához, a fiókbeállítások MCP-kapcsolatok részében, és az MI-csevegés csak akkor használja őket, ha a prompt megkívánja az adott MCP-szervert. A telepített alkalmazás nem ezen a beállítási oldalon keresztül hívja az MCP-szervereket.
Továbbra is segítségre van szüksége? Csatlakozzon a Discordunkhoz, és kapjon valós idejű támogatást a Base44 csapatától és közösségétől.
Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az angol nyelvű változatot.