Gmail

Siesta AI - Gmail consente un lavoro sicuro con l'account Gmail tramite l'API ufficiale di Gmail. L'integrazione offre la lettura, la creazione e l'invio di e-mail, che possono essere combinate con modelli GPT e flussi di lavoro aziendali.

Connessione rapida

Per creare, basta cliccare su Add Connection, selezionare Gmail e la pagina verrà automaticamente reindirizzata al login di Google. Dopo il login, l'account è collegato.

Operazioni disponibili

1. CreateDraft

Crea una nuova bozza di e-mail (draft) nella casella di posta di Gmail.

Parametro	Tipo	Richiesto	Descrizione
body	String	Sì	Testo dell'e-mail (plain)
subject	String	Sì	Oggetto dell'e-mail
to	String	Sì	Indirizzo e-mail

Casi d'uso: generazione automatizzata di e-mail da parte di un modello AI, preparazione per approvazione, modelli/proposte.

2. SendEmailAsync

Invia un'e-mail direttamente dall'account Gmail.

Parametro	Tipo	Richiesto	Descrizione
body	String	Sì	Testo dell'e-mail
subject	String	Sì	Oggetto dell'e-mail
to	String	Sì	Indirizzo del destinatario

Casi d'uso: notifiche automatiche, sequenze di vendita/marketing, follow-up, report generati da AI.

3. ListInboxAsync

Ottiene un elenco dei messaggi più recenti nella casella di posta.

Parametro	Tipo	Richiesto	Descrizione
includeSpamTrash	Bool	No	Includere spam e cestino
maxResults	Int	No	Numero di messaggi restituiti

Casi d'uso: assistenti AI per e-mail, sintesi della casella di posta, categorizzazione e instradamento, rilevamento di messaggi prioritari.

4. GetMessageAsync

Ottiene il contenuto completo di un messaggio specifico, inclusi i metadati.

Parametro	Tipo	Richiesto	Descrizione
messageId	String	Sì	ID del messaggio nell'API di Gmail

Casi d'uso: analisi del contenuto tramite GPT, estrazione di dati (ordini, contatti, SLA), ricostruzione di thread, contesto per risposte automatiche.

Capacità abilitate dall'integrazione di Gmail

• Redazione migliorata da AI: generazione di bozze di e-mail dal contesto e dai dati aziendali.
• Assistente per la casella di posta AI: risposte automatiche, etichettatura, prioritizzazione, sintesi dei thread.
• Flussi di lavoro automatizzati: follow-up, escalation, sequenze di onboarding, comunicazione con i clienti.
• Estrazione di dati: dati strutturati dalle e-mail, conversione in ticketing/CRM/ERP, collegamenti ai sistemi interni.

Requisiti per l'integrazione

1. Progetto Google Cloud: API di Gmail attivata, ID client OAuth 2.0 creato, URL di reindirizzamento autorizzato per Siesta AI.
2. Autorizzazione OAuth 2.0: l'utente concede accesso; ambito tipico:
   • https://www.googleapis.com/auth/gmail.readonly
   • https://www.googleapis.com/auth/gmail.modify
   • https://www.googleapis.com/auth/gmail.send
3. Archiviazione sicura dei token: i token sono crittografati, con rotazione automatica dei token di aggiornamento.
4. Quote e limiti di velocità delle API di Google: minimizzare le chiamate a GetMessageAsync, raggruppare le operazioni della casella di posta, memorizzare nella cache i metadati.
5. Governance e controlli: validazione delle e-mail prima dell'invio, whitelisting di indirizzi/domini, registri di audit, flussi di lavoro di approvazione.

Considerazioni sulla sicurezza

• Le e-mail e i metadati non vengono memorizzati senza uno scopo esplicito.
• I token di accesso sono crittografati e rinnovati regolarmente.
• Ogni operazione è auditabile; Siesta AI non invia e-mail senza approvazione o politica dell'organizzazione.

Come connettersi (OAuth)

1. Add Connection -> seleziona Gmail (stessa selezione per Gmail/Google Calendar/Google Search).
   

2. Accesso tramite Google (login OAuth).
   

3. Conferma il nome dell'integrazione (nome interno in Siesta AI).
   

4. Accettazione delle autorizzazioni (scopi secondo l'integrazione di Gmail).
   

Conclusione

L'integrazione di Gmail offre a Siesta AI un modo affidabile e sicuro per automatizzare la comunicazione aziendale. La combinazione dell'API di Gmail e dell'orchestrazione AI accelera il lavoro con le e-mail, consente l'analisi delle informazioni in arrivo e automatizza compiti di routine.