Vai al contenuto principale

Sulle integrazioni

Le integrazioni collegano Base44 al resto del tuo stack così puoi automatizzare workflow, importare dati e chiamare servizi esterni senza cablare ogni chiamata API a mano. Puoi integrare a 3 livelli:
  • Livello app: Integrazioni all’interno di una singola app:
    • Integrazioni integrate come Invoke LLM e SendEmail.
    • Connettori per connessioni OAuth a strumenti come Notion, Slack o Google Workspace.
    • Chiamate API esterne con funzioni backend che usano Secrets e funzioni per singola app.
  • Livello workspace: API condivise gestite una volta per l’intero workspace:
    • Integrazioni OpenAPI personalizzate basate su specifiche OpenAPI che qualsiasi app nel workspace può chiamare in modo sicuro.
  • Livello account: Connessioni che risiedono nel tuo account Base44:
    • Connessioni MCP che configuri una volta così la chat IA di Base44 può usare strumenti esterni mentre costruisci, senza cambiare il codice dell’app in produzione.

Integrazioni a livello app

Le integrazioni a livello app risiedono all’interno di una singola app. Includono integrazioni integrate, connettori e API esterne alimentate dal backend che colleghi solo a quell’app.

Integrazioni integrate

Alcune integrazioni sono preinstallate in Base44 e sono disponibili immediatamente. La maggior parte funziona con qualsiasi piano, senza configurazione extra o chiavi API separate. Con queste integrazioni core, puoi aggiungere IA, messaggistica, gestione file e logica avanzata a qualsiasi app. Le integrazioni integrate di Base44 includono:
  • Invoke LLM: genera risposte IA da prompt dettagliati, con output con schema JSON, allegati file, analisi immagini e ricerca web.
  • SendEmail: invia email dalla tua app con il tuo nome mittente e contenuto HTML, oppure invia una delle tue email progettate.
  • SendPushNotification: invia una notifica push a una persona nella tua app mobile nativa, con un link opzionale a una pagina specifica.
  • UploadPublicFile: permetti alle persone di caricare file che chiunque abbia il link può aprire, come foto profilo o foto dei prodotti. Usa l’URL del file restituito in altre integrazioni o workflow.
  • UploadPrivateFile: archivia in modo privato i file che contengono dati personali o sensibili, così solo la tua app può aprirli.
  • CreateFileSignedUrl: crea un link temporaneo a un file privato, così qualcuno può visualizzarlo o scaricarlo.
  • GenerateImage: crea immagini da prompt testuali, da sole o a partire da immagini di riferimento che le fornisci.
  • GenerateVideo: crea video da prompt testuali.
  • GenerateSpeech: trasforma il testo in audio parlato.
  • TranscribeAudio: trasforma il parlato registrato in testo.
  • ExtractDataFromUploadedFile: estrai dati strutturati da file CSV, XLSX, JSON, HTML, PNG, JPG, JPEG e PDF caricati usando schemi JSON.
Scopri di più sulle integrazioni integrate.

Connettori

I connettori sono integrazioni abilitate OAuth che permettono a un’app specifica di connettersi a strumenti supportati. Chiedi alla chat IA di connettere un servizio, accedi e approvi i permessi richiesti. La tua app può quindi leggere o scrivere dati in quello strumento in base a ciò che permetti. Esempi di cosa puoi costruire con i connettori:
  • Sincronizza un database Notion per alimentare una vista di conoscenza nella tua app.
  • Pubblica aggiornamenti su un canale Slack.
  • Sincronizza record Salesforce o HubSpot in una dashboard interna.
  • Salva file dalla tua app su Google Drive.
  • Blocca il tempo su Google Calendar quando viene fatta una nuova prenotazione.
  • Pubblica un post LinkedIn quando viene pubblicato un nuovo post del blog.
  • Mostra statistiche del profilo TikTok e conteggi di follower in una dashboard.

Chiamate API esterne con funzioni backend

Le integrazioni esterne che usano funzioni backend permettono a un’app specifica di parlare direttamente con servizi di terze parti come Stripe, Twilio o le API di Google con credenziali per singola app. Queste chiamate vengono collegate tramite le tue funzioni backend e Secrets.
Connecting an integration to your app using the AI chat

Connecting an integration to your Base44 app using the AI chat

Usa le funzioni backend quando:
  • Vuoi un’integrazione una tantum per una singola app.
  • Ti serve logica personalizzata strettamente accoppiata a quell’app.
  • Il servizio non è ancora impostato come integrazione OpenAPI personalizzata nel tuo workspace.
Esempi di integrazioni esterne con funzioni backend:
  • Invio di email di benvenuto a nuove persone che usano la tua app tramite il tuo provider email.
  • Sincronizzazione del tuo CRM esistente con il database della tua app.
  • Avviso al tuo team in Slack quando qualcuno invia un form.
  • Generazione di contenuti con strumenti IA usando le tue chiavi del provider.
  • Chiamata di API specifiche di vendor che non hanno ancora un connettore o un’integrazione OpenAPI personalizzata.
  • Collegamento dell’account di ogni persona a un servizio che usa l’accesso OAuth2. Vedi Collegare un servizio con il proprio accesso.
Quando richiedi un’integrazione nella chat IA, Base44 ti guida passo passo e chiede credenziali o autorizzazione quando serve. Poi collega automaticamente la logica backend e frontend così puoi partire velocemente. Salvi le credenziali come segreti nella dashboard dell’app e le usi in funzioni TypeScript sotto Code > base44 > functions. Scopri come aggiungere, modificare ed eliminare i segreti della tua app.
Ogni funzione backend ha un file di codice che puoi modificare, visualizzare e testare. Per controllare i log di una funzione, apri il suo file in Code e clicca su Logs.

Collegare assistenti AI

La tua app pubblicata può esporre il proprio server MCP, così gli assistenti AI possono usarne dati e azioni, con un accesso che controlli tu. È diverso dalle connessioni MCP a livello account, che la chat AI di Base44 usa mentre costruisci.
Scopri di più su come collegare assistenti AI alla tua app.

Integrazioni a livello workspace

Le integrazioni a livello workspace risiedono in un workspace e possono essere riutilizzate su molte app senza ripetere la configurazione o le credenziali.

Integrazioni OpenAPI personalizzate

Le integrazioni OpenAPI personalizzate ti permettono di registrare API esterne condivise a livello workspace da una specifica OpenAPI. Importi una spec una volta, selezioni le operazioni che vuoi esporre e qualsiasi app in quel workspace può chiamare quelle operazioni tramite l’SDK. L’IA e il tuo codice frontend possono chiamare direttamente le integrazioni OpenAPI personalizzate tramite base44.integrations.custom senza esporre le credenziali. Le chiamate vengono proxate attraverso il backend di Base44, quindi i segreti non raggiungono mai il browser. Questo è ideale per API interne e API partner che il tuo team usa su molte app.
Chi può creare e usare le integrazioni OpenAPI personalizzate:
  • Piano: ti serve un piano Builder o superiore per creare o modificare integrazioni OpenAPI personalizzate.
  • Ruolo: solo proprietari e admin del workspace possono creare o modificare integrazioni OpenAPI personalizzate.
  • Usarne una: chiunque nel workspace può usare un’integrazione OpenAPI personalizzata esistente nelle proprie app, anche con un piano Free.
Scopri come configurare queste API in dettaglio in Gestione delle integrazioni API personalizzate.

Connessioni a livello account

Le connessioni a livello account vengono configurate una volta per il tuo account Base44 e sono disponibili ovunque usi la chat IA di Base44.

Connessioni MCP

Le connessioni MCP ti permettono di collegare server MCP personalizzati al tuo account Base44 così la chat IA può usare strumenti e dati esterni come contesto mentre costruisci. Questo ti dà una chat IA consapevole del contesto senza cambiare il runtime dell’app in produzione.
Cosa sapere sulle connessioni MCP:
  • Piano: ti serve un piano Builder o superiore per usare le connessioni MCP.
  • Configurazione: i server MCP vengono configurati una volta per account sotto Account settings → Builder → MCP Connections.
  • Quando vengono usate: la chat IA chiama un server MCP solo quando il tuo prompt lo richiede (ad esempio, quando menzioni quel server o chiedi dati che fornisce). Non contatta ogni server MCP per ogni messaggio.
Esempi di cosa puoi fare con le connessioni MCP:
  • Chiedi alla chat IA di cercare in un MCP di documentazione interna e riassumere le pagine più pertinenti per una funzionalità.
  • Connetti un server MCP GitHub e chiedi un riepilogo delle issue aperte in un repo specifico.
  • Connetti un MCP di analytics, come Amplitude o un servizio metrico personalizzato, e chiedi alla chat di portare metriche di prodotto recenti nella conversazione mentre pianifichi modifiche.
Scopri come aggiungere e gestire i server MCP in Impostare un MCP personalizzato.

Archiviare le chiavi API

Alcune integrazioni richiedono una chiave API, che funziona come una password privata tra la tua app e il servizio esterno. Crei la chiave in quel servizio, poi la salvi in Base44 così la tua app può usarla senza esporla:
  • Segreti dell’app: per le funzioni backend di un’app, salva la chiave come segreto dell’app nella pagina Secrets della tua app. Puoi anche incollarla nella chat AI e Base44 la salva per te. Consulta Gestire i segreti dell’app.
  • Integrazioni OpenAPI personalizzate: un proprietario o admin del workspace aggiunge la chiave una sola volta come header quando crea o modifica l’integrazione. Base44 la archivia crittografata nel tuo workspace. Consulta Gestire le integrazioni API personalizzate.

FAQ

Clicca su una domanda qui sotto per saperne di più sull’uso delle integrazioni.
Le integrazioni OpenAPI personalizzate vengono configurate una volta in un workspace da una spec OpenAPI e sono disponibili per ogni app in quel workspace tramite base44.integrations.custom.call(). Le credenziali vengono memorizzate come segreti workspace cifrati e mai esposti al codice dell’app e non ti servono funzioni backend per usarle.Le API esterne per singola app usano funzioni backend e Secrets in un’app specifica. Sono ideali per logica specifica dell’app o quando non vuoi condividere un’API su tutte le app di un workspace.
Prima di pubblicare la tua app, testa la tua integrazione così puoi cogliere i problemi presto:
  1. Usa la modalità sandbox o di test (ad esempio, chiavi di test Stripe), se il provider la offre.
  2. Prova flussi reali e casi limite, non solo un singolo percorso felice.
  3. Controlla che input e output corrispondano alle tue aspettative nella tua UI e nella dashboard del provider.
  4. Monitora l’uso dei crediti di integrazione sia in Base44 sia nel servizio esterno.
  5. Vedi l’anteprima della tua app per cogliere caricamenti lenti, chiamate API fallite o dati mancanti prima di andare live.
Se incontri problemi, controlla quanto segue:
  • La tua chiave API è corretta e salvata in Secrets o nell’integrazione OpenAPI personalizzata, se rilevante.
  • Hai abbastanza crediti attivi nel servizio esterno.
  • Stai usando credenziali live, non di test, quando testi flussi di produzione.
  • La tua richiesta API include endpoint, payload e parametri corretti.
  • Non hai raggiunto i limiti di rate del servizio.
I proprietari e gli admin di workspace possono creare funzioni backend nelle app che possiedono. Anche i collaboratori con ruolo Editor possono modificare e creare funzioni backend in un’app.
Se vedi un errore 403 quando usi le funzioni backend, di solito alla richiesta mancano i permessi.Cause comuni e soluzioni:
  • Permessi nella tua funzione: La tua funzione backend può rifiutare la richiesta perché la persona non è autenticata o non ha il ruolo giusto. Controlla eventuali controlli di ruolo o accesso che hai aggiunto nel codice della funzione.
  • Permessi del servizio esterno: Un 403 può anche venire dall’API esterna che stai chiamando. Assicurati che la chiave API abbia gli scope giusti e che la richiesta usi l’endpoint e il metodo corretti.
  • Hai ancora problemi: Consulta le soluzioni per le funzioni backend negli strumenti per sviluppatori di Base44, oppure contatta il Customer Care.
Ci sono 2 tipi di chiavi API che potresti dover rigenerare o aggiornare:
  • Chiavi di servizi di terze parti: Rigenera la tua chiave nel portale sviluppatori di quel servizio, ad esempio OpenAI, Resend, Notion, poi modifica il valore del segreto nella dashboard dell’app o aggiornala nelle impostazioni dell’integrazione OpenAPI personalizzata.
  • La chiave API del tuo account Base44: le chiavi API dell’account non sono più supportate e non puoi rigenerarne una. Le chiavi esistenti vengono disattivate gradualmente. Crea invece un token di accesso personale e aggiorna tutto ciò che usava la vecchia chiave.
  • Le integrazioni integrate, i connettori e le API esterne per singola app che usano funzioni backend restano disponibili.
  • Le integrazioni OpenAPI personalizzate e le connessioni MCP possono smettere di funzionare finché non aggiorni a un piano Builder o superiore.
Base44 non invia direttamente messaggi di testo (SMS). Per inviarli dalla tua app, registrati a un servizio SMS, salva la sua chiave API come segreto e chiedi alla chat AI di inviare i messaggi tramite una funzione backend. Ad esempio:
Sì. Puoi combinare integrazioni integrate, connettori, integrazioni OpenAPI personalizzate e API esterne per singola app nella stessa app, purché il tuo piano e le tue impostazioni le supportino.
Per motivi di sicurezza, servizi esterni come Stripe, OpenAI o Notion non lasciano che terze parti, incluso Base44, accedano automaticamente alle tue credenziali. Devi invece:
  1. Accedere al servizio.
  2. Andare alla sezione API o sviluppatori.
  3. Generare la tua chiave.
  4. Incollarla in Base44 come Secret o header workspace.
Una volta aggiunta, la tua app o integrazione OpenAPI personalizzata può usare quella chiave dietro le quinte in modo sicuro e senza codice.
Perché è importante: Le chiavi API funzionano come password per i servizi. Tenerle private e sotto il tuo controllo mantiene i tuoi dati al sicuro e garantisce che solo tu autorizzi l’accesso.
No. Le connessioni MCP sono solo per la chat IA di Base44 mentre costruisci. Le configuri una sola volta per il tuo account, sotto MCP Connections nelle impostazioni dell’account. La chat IA le usa solo quando il tuo prompt richiede quel server MCP. La tua app in produzione non chiama server MCP tramite questa pagina di impostazioni.
Ti serve ancora aiuto? Unisciti al nostro Discord e ricevi supporto in tempo reale dal team e dalla community Base44.
Questa pagina è stata tradotta con l’AI. Per le informazioni più accurate e aggiornate, consulta la versione inglese.