Connettere Gmail alla tua app

Connetti la tua app Base44 a Gmail per inviare, leggere e gestire email. Usa Gmail per consegnare avvisi, approvazioni e report, per trasformare i messaggi in arrivo in record nella tua app e per attivare flussi quando arriva nuova posta, da un unico account condiviso o dalla casella personale di ogni persona.

Quale tipo dovresti usare? Usa un connettore per costruttori di app quando la tua app invia email da un unico account Gmail per tutti, ad esempio una casella operativa che invia report settimanali. Usa un connettore per utenti dell’app quando ogni persona invia email dal proprio account Gmail.

Ti serve un piano Builder o superiore per usare i connettori nella tua app.

Cosa puoi fare

Invia email automaticamente

Invia conferme, avvisi e follow-up personalizzati quando succede qualcosa nella tua app.

Leggi le email in arrivo

Leggi e analizza i messaggi in arrivo, poi trasformali in record come ticket di supporto.

Gestisci la casella di posta

Organizza la posta mentre la tua app la elabora, ad esempio segna i messaggi come letti o applica etichette.

Per personalizzare le email, specifica nella chat AI oggetto, corpo del messaggio, formattazione, destinatari ed eventuali campi dinamici. Puoi anche modificare le funzioni backend generate in Dashboard → Code → Functions per personalizzare ulteriormente il payload dell’email. Prompt di esempio per la chat AI

Send automated confirmation emails when a new order is placed.

Read and parse incoming emails to create support tickets.

Trigger a workflow automatically when a new email arrives.

Send personalized follow-up emails to new leads.

Notify team members via email when tasks are assigned.

In sintesi

Identificatore di tipo

gmail

Modello di autenticazione

OAuth

Tipi di connettore

Per costruttori di app, per utenti dell’app

Configurazione della connessione

Nessuna

Guida ai permessi

Scope e permessi Gmail

Connetterlo

Per costruttori di app
Per utenti dell'app

Connetti un unico account Gmail usato da tutti i flussi della tua app.Per connettere Gmail:

Vai all’editor della tua app.
Descrivi cosa vuoi fare con Gmail nella chat AI, ad esempio: Connect this app to Gmail and email me when a new ticket is created.
Rivedi cosa chiede la chat AI sotto We need your permission to access.
Clicca su Connect to Gmail.
Nella finestra di Google, seleziona l’account da connettere, rivedi i permessi e clicca su Allow.
Torna all’editor e lascia che l’AI finisca di creare i flussi che usano Gmail.

Permetti a ogni persona che usa la tua app di collegare il proprio account Gmail. Un admin imposta il connettore una volta a livello di workspace, dalle impostazioni del workspace o dalla chat AI, poi ogni persona collega il proprio account dentro la tua app.

Tratta il tuo Client Secret come una password. Non condividerlo e non includerlo in screenshot. Inseriscilo solo quando Base44 lo chiede durante la configurazione.

Prepara il tuo connettore

Imposta un’app OAuth Google e raccogli i suoi dettagli prima di aggiungere il connettore in Base44.Per preparare il tuo connettore:

Crea un’app OAuth Google in Google Cloud per ottenere un Client ID e un Client Secret.
Annota gli scope che servono alla tua app. Consulta Scope e permessi Gmail.
Registra i tuoi redirect URI nell’app OAuth. Consulta la card sotto.

Registra il tuo URL di callback

Registra questo URL di callback nella tua app OAuth Google. Funziona per ogni app del tuo workspace, inclusi gli URL live, di anteprima, di condivisione e dei domini personalizzati:https://connectors.base44.com/api/oauth/callbackSe hai impostato questo connettore prima del passaggio di Base44 a un URL di callback unico, usa ancora un URI separato per ogni host dell’app. Apri Workspace Settings → Connectors, clicca su View redirect URIs for your apps sotto Connectors For App Users, seleziona la tua app e registra ogni URI elencato sotto Per-app URLs (for legacy connectors).

Aggiungi il connettore

Per aggiungere il connettore:

Clicca sul nome del tuo workspace in basso a sinistra.
Clicca su Settings.
Clicca su Connectors sotto Plugins.
Sotto Connectors For App Users, clicca su Add Connector.
Clicca su Gmail.
Nei dettagli del connettore, clicca su Add Connector.
Inserisci un Connector name, poi il Client ID e il Client Secret della tua app OAuth Google.
Sotto Scopes, apri il menu degli scope suggeriti e seleziona quelli che servono alla tua app. Usa Additional scopes solo per scope non elencati.
Clicca su Add Connector.

Lascia che le persone si connettano

Ogni persona collega il proprio account Gmail dentro la tua app. Chiedi alla chat AI di aggiungere una funzionalità dove le persone accedono con Gmail, poi ognuno collega il proprio account quando la usa.

Usarlo in una funzione backend

Una volta connesso Gmail, le tue funzioni backend possono recuperare un token di accesso e chiamare direttamente l’API Gmail. Base44 gestisce il flusso OAuth e l’archiviazione dei token.

Per una connessione condivisa, usa getConnection() per recuperare il token.
Per una connessione utente dell’app, usa getCurrentAppUserConnection() così ogni richiesta usa il token della persona connessa.

// Shared connection: one account the whole app uses
const connection = await base44.asServiceRole.connectors.getConnection("gmail");
// Use the connection's access token to call the Gmail API.

Connettori condivisi

Configura, distribuisci e chiama una connessione condivisa da una funzione backend.

Connettori per utenti dell'app

Recupera un token per singolo utente e chiama l’API come la persona connessa.

Scope e permessi Gmail

Quando connetti Gmail, il connettore richiede permessi (scope) che controllano cosa può fare la tua app con il tuo account Gmail. Sotto trovi l’elenco attuale degli scope Gmail che il connettore può richiedere.

Scope Gmail

email: Identifica l’account Google che viene connesso.
https://www.googleapis.com/auth/gmail.readonly: Leggi messaggi e metadati.
https://www.googleapis.com/auth/gmail.send: Invia messaggi.
https://www.googleapis.com/auth/gmail.labels: Gestisci le etichette.
https://www.googleapis.com/auth/gmail.modify: Modifica i messaggi, ad esempio segna come letto o applica un’etichetta.
https://www.googleapis.com/auth/gmail.compose: Crea e aggiorna bozze.
https://www.googleapis.com/auth/gmail.settings.basic: Gestisci le impostazioni di base della posta, come filtri, firme e risposta automatica.

Gli elenchi di scope possono cambiare nel tempo. Rivedi sempre i permessi mostrati durante il flusso di connessione.

Leggere il contenuto della posta di qualcuno è uno dei permessi che Google tratta come restricted, quindi un’app che lo richiede ha più cose da fare prima di poter essere pubblicata. Se stai configurando questa integrazione con il tuo progetto Google Cloud, vedi scegliere gli scope Google.

Risoluzione dei problemi

La connessione fallisce con un errore di redirect URI

Controlla che https://connectors.base44.com/api/oauth/callback sia registrato nella tua app OAuth Google, esattamente come mostrato. Se il connettore usa ancora URL per singola app, l’URI nella tua app OAuth deve invece corrispondere a uno di quelli mostrati sotto Per-app URLs (for legacy connectors) in View redirect URIs for your apps, quindi registra ogni URI elencato lì per l’app che stai connettendo.

Alcune persone non riescono a connettere il proprio account

Se la tua app OAuth Google è in modalità di test, solo gli utenti di test approvati possono connettersi. Pubblica la tua app OAuth o toglila dalla modalità di test, così chiunque usi la tua app può collegare il proprio account.

Questa pagina è stata tradotta con l’AI. Per le informazioni più accurate e aggiornate, consulta la versione inglese.

Per iniziare

Superagenti

Creare la tua app

Proteggere la tua app

Promuovere la tua app

Connettori

Integrazioni

Cosa puoi fare

Invia email automaticamente

Leggi le email in arrivo

Gestisci la casella di posta

In sintesi

Connetterlo

Prepara il tuo connettore

Registra il tuo URL di callback

Aggiungi il connettore

Lascia che le persone si connettano

Usarlo in una funzione backend

Connettori condivisi

Connettori per utenti dell'app

Scope e permessi Gmail

Scope Gmail

Risoluzione dei problemi

​Cosa puoi fare

Invia email automaticamente

Leggi le email in arrivo

Gestisci la casella di posta

​In sintesi

​Connetterlo

​Prepara il tuo connettore

Registra il tuo URL di callback

​Aggiungi il connettore

​Lascia che le persone si connettano

​Usarlo in una funzione backend

Connettori condivisi

Connettori per utenti dell'app

​Scope e permessi Gmail

Scope Gmail

​Risoluzione dei problemi

Cosa puoi fare

In sintesi

Connetterlo

Prepara il tuo connettore

Aggiungi il connettore

Lascia che le persone si connettano

Usarlo in una funzione backend

Scope e permessi Gmail

Risoluzione dei problemi