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.
Ö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 a Base44-alkalmazáshoz az MI-csevegéssel
- 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.
- Ü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.
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.
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 abase44.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.
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. 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.
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.Mi a különbség az egyéni OpenAPI-integrációk és az alkalmazásonkénti külső API-k között?
Mi a különbség az egyéni OpenAPI-integrációk és az alkalmazásonkénti külső API-k között?
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.Hogyan teszteljem az integrációt közzététel előtt?
Hogyan teszteljem az integrációt közzététel előtt?
- Ha a szolgáltató kínál ilyet, használjon sandbox- vagy tesztmódot (például Stripe tesztkulcsokat).
- Próbáljon ki valós folyamatokat és szélsőséges eseteket is, ne csak egyetlen ideális utat.
- 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.
- Figyelje az integrációs kredithasználatot a Base44-ben és a külső szolgáltatásban is.
- 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.
Miért nem működik az integrációm?
Miért nem működik az integrációm?
- 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.
Ki használhat backend-függvényeket és alkalmazásonkénti külső API-kat?
Ki használhat backend-függvényeket és alkalmazásonkénti külső API-kat?
Miért kapok 403-as hibát backend-függvények használatakor?
Miért kapok 403-as hibát backend-függvények használatakor?
- 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.
Hogyan generálhatom újra vagy frissíthetem az API-kulcsomat?
Hogyan generálhatom újra vagy frissíthetem az API-kulcsomat?
- 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.
Mi történik az integrációimmal, ha alacsonyabb csomagra váltok?
Mi történik az integrációimmal, ha alacsonyabb csomagra váltok?
- 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.
Küldhet az alkalmazásom szöveges üzeneteket?
Küldhet az alkalmazásom szöveges üzeneteket?
Használhatok több integrációt egy alkalmazásban?
Használhatok több integrációt egy alkalmazásban?
Miért nem tudja a Base44 vagy az MI lekérni helyettem az API-kulcsomat?
Miért nem tudja a Base44 vagy az MI lekérni helyettem az API-kulcsomat?
- Jelentkezzen be a szolgáltatásba.
- Lépjen az API- vagy fejlesztői részhez.
- Generálja a kulcsot.
- Illessze be a Base44-be titkos adatként vagy munkaterületi fejlécként.
Úgy működnek az MCP-kapcsolatok, mint a többi alkalmazásintegráció?
Úgy működnek az MCP-kapcsolatok, mint a többi alkalmazásintegráció?