Configurazione email (SMTP)

A cosa serve

XIQUIL può inviare email per notifiche, promemoria scadenze, riepilogo settimanale e invio credenziali a nuovi utenti. Per farlo ha bisogno di un server SMTP — che puoi configurare dalle Impostazioni avanzate → Email.

Se non configuri l’email, l’app funziona normalmente ma le notifiche arrivano solo in-app (e via push se hai l’app mobile). Nessuna email viene mai inviata senza SMTP configurato.

Dove configurare

Impostazioni avanzate → Email — dalla sezione puoi:

• Inserire i parametri SMTP
• Testare la connessione inviando un’email di prova
• Disabilitare l’email senza perdere la configurazione

Configurazione SMTP: inserimento parametri di connessione e pulsante “Invia email di test” per verificare la configurazione.

Campi richiesti

Campo	Descrizione	Esempio
Host SMTP	Indirizzo del server di posta	smtp.gmail.com
Porta	Porta del server (di solito 465 o 587)	587
TLS	Tipo di cifratura: SSL (465) o STARTTLS (587)	STARTTLS
Utente	Account email mittente	[email protected]
Password	Password o App Password	••••••••
Email mittente	Indirizzo visualizzato nel campo “Da”	XIQUIL <[email protected]>

Configurazioni comuni

Gmail

Per Gmail devi usare una App Password (non la password normale) se hai la verifica in 2 passaggi attiva.

1. Vai su myaccount.google.com → Sicurezza → App Password
2. Genera una password per “Posta”
3. Usa smtp.gmail.com, porta 587, STARTTLS

Mailgun / SendGrid / Brevo

Tutti i provider SMTP transazionali funzionano con XIQUIL. Usa le credenziali SMTP che ti forniscono (non le API key del pannello web).

Server di posta locale (Postfix, Mailcow)

Se hai un server di posta self-hosted, usa il suo indirizzo interno e le credenziali dell’account mittente.

Test connessione

Dopo aver inserito i parametri, usa il pulsante “Invia email di test” nella stessa sezione. XIQUIL invia un’email all’indirizzo dell’admin corrente. Se arriva, la configurazione è corretta.

Attenzione

Se il test fallisce, controlla: host e porta corretti, password non scaduta, account non bloccato dal provider, firewall del server che permette le connessioni in uscita sulla porta SMTP.

Cosa si disabilita senza email

Se SMTP non è configurato o viene disabilitato:

• Nessuna email di notifica scadenze
• Nessun riepilogo settimanale
• Nessuna email di invito/credenziali nuovi utenti
• Nessun reset password via email (gli admin devono usare il CLI)

Le notifiche in-app e push continuano a funzionare normalmente.

Vedi anche

• Processi pianificati — i job che usano email (riepilogo_settimanale, notifiche_giornaliere)
• Notifiche — preferenze notifiche per utente
• Utenti e permessi — invito nuovi utenti via email