Importare contatti da file CSV in RoundCube
Migrare la rubrica da un'altro client a RoundCube e' un'operazione frequente nelle migrazioni gestite da G Tech Group. RoundCube supporta nativamente l'importazione di file CSV (Comma Separated Values) e vCard. In questa guida vediamo come preparare il file, mappare le colonne e gestire i duplicati.
Formati supportati
RoundCube importa CSV (separatore virgola o punto e virgola) e vCard 3.0 / 4.0. Il CSV deve avere intestazione di colonna nella prima riga: First Name, Last Name, Email, Phone, Company, Notes. La codifica deve essere UTF-8 senza BOM per evitare problemi con accenti.
Esportare dai principali servizi
Gmail: Contatti - Esporta - CSV Google. Outlook: File - Apri ed esporta - Importa/esporta - Esporta in file - CSV. Thunderbird: Rubrica - Strumenti - Esporta - CSV. iCloud: Contatti - Mostra tutti - Esporta vCard.
Mapping colonne e gruppi
RoundCube riconosce automaticamente le intestazioni standard. Se le tue intestazioni sono in italiano, rinominale (Nome -> First Name, Cognome -> Last Name, Email -> Email). Puoi assegnare tutti i contatti a un gruppo esistente al momento dell'import.
Procedura passo-passo
- Esporta i contatti dal client di origine in formato CSV UTF-8
- Apri il file in un'editor (LibreOffice, Excel) e verifica intestazioni in inglese
- Salva di nuovo come CSV UTF-8 (senza BOM)
- Su RoundCube vai su Contatti - Importa (icona)
- Seleziona il file CSV e il gruppo di destinazione
- Spunta Sostituisci tutta la rubrica se vuoi pulire prima
- Clicca Importa e attendi il report (X contatti importati, Y duplicati)
- Verifica un contatto random per controllare i campi
Errori comuni e come risolverli
- Caratteri accentati sostituiti da ?: il file non e' UTF-8. Riaprilo in LibreOffice e salva come CSV UTF-8.
- Solo email importata, nome mancante: intestazioni colonna non riconosciute. Rinomina Name in First Name + Last Name.
- Duplicati creati invece di aggiornati: RoundCube non fa merge automatico, importa tutto. Pulisci prima.
- Errore File troppo grande: dividi il CSV in lotti da 1000 contatti.
Approfondimenti tecnici e scenari d'uso
L'argomento Importare contatti da file CSV in RoundCube richiede una buona comprensione dell'infrastruttura di posta sottostante. RoundCube e' uno strato applicativo che si poggia su un server IMAP (di norma Dovecot su Plesk) per la lettura dei messaggi, su un server SMTP (Postfix) per l'invio, e su un database MySQL o MariaDB per i metadati. Ogni operazione che vediamo dall'interfaccia attiva una o più' chiamate verso questi servizi. Comprendere il flusso aiuta a diagnosticare velocemente i malfunzionamenti e a prendere decisioni informate quando bisogna pianificare interventi su ambienti di produzione con utenti business.
G Tech Group, in qualità' di agenzia digitale italiana con più' di un decennio di esperienza su Plesk e oltre cinquecento clienti attivi, ha consolidato una serie di accorgimenti operativi: pulizia periodica delle cache, monitoraggio dei log applicativi, verifica dei certificati SSL, audit dei plugin installati, e schedulazione di backup giornalieri con retention multipla. Tutte queste pratiche sono integrate nei piani di assistenza tecnica h24 erogati dalla sede di Giustino, in Trentino. L'assistenza in italiano e i tempi di risposta sotto le due ore sui ticket critici sono parte del valore offerto ai clienti professionali.
Per chi gestisce diversi domini sullo stesso server e' utile ricordare che molte impostazioni RoundCube hanno scope globale: una modifica al file config.inc.php si applica a tutti gli utenti. Per personalizzazioni per dominio o per gruppo serve un plugin dedicato o l'estensione del config tramite hook. In ambienti multi-tenant come quelli di un'agenzia digitale e' bene mantenere un repository git con le modifiche di configurazione, separato dal codice upstream di RoundCube, per poter eseguire upgrade in sicurezza senza perdere customizzazioni. G Tech Group segue questa policy per tutti i server gestiti, garantendo così' aggiornamenti regolari della webmail senza regressioni sulle personalizzazioni (skin, plugin custom, integrazioni CRM e altri moduli aziendali).
Sul fronte sicurezza, l'argomento merita sempre attenzione specifica. Le credenziali email transitano su HTTPS, ma una sola compromissione può aprire la porta a campagne di phishing dal dominio aziendale, con danni di reputazione e di deliverability difficili da recuperare in tempi brevi. Per questo G Tech Group consiglia abilitazione di SPF, DKIM e DMARC obbligatori, policy di password forte, fail2ban configurato sui tentativi falliti, monitor di accessi anomali e training periodico per gli utenti finali. Per i clienti enterprise sono inoltre disponibili moduli di autenticazione multi-fattore tramite reverse proxy Authelia o Keycloak posti davanti a RoundCube.
Dal punto di vista delle prestazioni, la maggior parte dei rallentamenti percepiti dagli utenti deriva da tre cause: cache messaggi cresciuta a dismisura (la tabella cache_messages può superare svariati gigabyte in pochi mesi), connessioni IMAP non chiuse correttamente che esauriscono le risorse Dovecot, e tempi di risposta del DNS lenti per le ricerche DNSBL durante la consegna SMTP. La cron di bin/cleandb.sh che G Tech Group abilita in fase di onboarding riduce notevolmente il primo problema, mentre tuning di Dovecot e cache DNS locale risolvono gli altri due, garantendo una webmail sempre fluida anche su domini con centinaia di caselle attive in contemporanea.
Domande frequenti
D: Posso importare anche vCard?
R: Sì, il selettore file accetta anche .vcf.
D: L'import e' reversibile?
R: Solo se hai salvato un backup precedente. Esporta prima.
D: Posso importare in un gruppo specifico?
R: Sì, selezionalo nel form di import.
Hai bisogno di aiuto?
Se hai bisogno di configurare RoundCube per la tua azienda, il team di G Tech Group può aiutarti. Contattaci tramite il modulo di contatto.