Come configurare l’invio email con Gmail
Se la tua azienda utilizza Google Workspace (G Suite), puoi configurare Hyper Enterprise per inviare email automatiche tramite una casella Gmail aziendale.
Importante: questa funzionalità richiede un abbonamento Google Workspace (account aziendale). Non è compatibile con i normali account Gmail personali (@gmail.com).
Cosa ti serve prima di iniziare
- Un account Google Workspace aziendale
- Accesso alla Google Cloud Console con un utente con privilegi di amministratore del progetto
- Accesso alla Google Workspace Admin Console con un Super Administrator
- L’indirizzo email mittente (es.
noreply@tuaazienda.com), che deve essere una casella attiva nel tuo Google Workspace
Parte 1 — Creazione del Service Account su Google Cloud
1. Accedi a Google Cloud Console
Vai su console.cloud.google.com ed effettua l’accesso.
2. Crea o seleziona un progetto
In alto a sinistra clicca sul selettore di progetto. Puoi usare un progetto esistente oppure crearne uno nuovo (es. hyper-enterprise-email).
3. Abilita l’API Gmail
- Nel menu di sinistra vai su API e servizi → Libreria
- Cerca
Gmail APIe aprila - Clicca Abilita
4. Crea un Service Account
- Vai su IAM e amministrazione → Account di servizio
- Clicca Crea account di servizio
- Inserisci un nome descrittivo, es.
hyper-enterprise-email - Clicca Crea e continua, poi Fine (i ruoli non sono necessari per questo utilizzo)
5. Genera la chiave JSON
- Clicca sul service account appena creato
- Vai nella scheda Chiavi → Aggiungi chiave → Crea nuova chiave
- Seleziona il formato JSON e clicca Crea
- Il file viene scaricato automaticamente: conservalo in modo sicuro, contiene credenziali sensibili
6. Annota il Client ID
Nella pagina del service account, nella scheda Dettagli, trovi il campo ID univoco (o Client ID): copialo, servirà nel passo successivo.
Parte 2 — Delega sul portale Google Workspace Admin
Questa operazione permette al service account di inviare email per conto delle caselle della tua organizzazione.
1. Accedi alla Admin Console
Vai su admin.google.com con un account Super Administrator.
2. Abilita la delega a livello di dominio
- Vai su Sicurezza → Controllo API → Gestisci la delega a livello di dominio
- Clicca Aggiungi nuovo
- Nel campo Client ID incolla l’ID univoco copiato al punto 6 della sezione precedente
- Nel campo Ambiti OAuth inserisci esattamente:
https://mail.google.com/- Clicca Autorizza
Parte 3 — Configurazione in Hyper Enterprise
Apri il file JSON scaricato in precedenza con un editor di testo (es. Blocco Note). Individua questi due valori:
"client_email": "hyper-enterprise-email@tuo-progetto.iam.gserviceaccount.com""private_key": "-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----\n"Accedi al gestionale con un utente amministratore e vai in:
Amministrazione → Impostazioni → Email
Imposta i seguenti campi:
| Campo | Valore |
| Servizio email | Gmail |
| Indirizzo mittente predefinito | L’indirizzo email da cui verranno inviati i messaggi (es. noreply@tuaazienda.com) — deve corrispondere a una casella del tuo Google Workspace |
| Service Account Email | Il valore del campo client_email dal file JSON |
| Private Key | Il valore completo del campo private_key dal file JSON, incluse le righe -----BEGIN...-----END----- |
Per incollare la Private Key: copia l’intero valore dal JSON (comprese le righe di intestazione e chiusura). Le sequenze \n nel file diventano automaticamente ritorni a capo quando incolli nel campo.
Salva le impostazioni e usa il pulsante Invio mail di prova per verificare il funzionamento.
Problemi comuni
- Errore “Unauthorized client”: la delega a livello di dominio non è stata configurata correttamente. Verifica che il Client ID e lo scope siano corretti nella Admin Console.
- Errore di autenticazione: controlla che la Private Key sia stata incollata per intero, incluse le righe
-----BEGIN-----e-----END-----. - L’email non viene consegnata: verifica che l’indirizzo mittente sia una casella attiva e appartenente al dominio Google Workspace configurato.
- Account Gmail personale: questo connettore non funziona con account
@gmail.compersonali; è richiesto un abbonamento Google Workspace.