# Importazione di contatti da un file Se hai un elenco di contatti in un foglio di calcolo, puoi caricarli tutti in una volta invece di aggiungerli uno per uno. L'app utilizza una procedura guidata in 3 passaggi — **Carica → Associa colonne → Revisione** — che funziona con il file CSV che già possiedi, senza bisogno di scaricare prima un modello. --- ## Come importare i contatti 1. Fai clic su **Contatti** nella barra laterale sinistra, quindi fai clic su **Importa** nella parte superiore della pagina. 2. **Carica.** Trascina il tuo file CSV nell'area di rilascio, oppure fai clic su di essa per sfogliare i file. Non c'è alcun modello da scaricare prima: usa il file che hai già. 3. **Mappa le colonne.** La procedura guidata legge la riga di intestazione del file e tenta di associare automaticamente ogni colonna a un campo di destinazione: **Nome, Cognome, Telefono, Email, Tag, Note** o **Non importare**. Controlla il suggerimento per ogni colonna e correggi eventuali errori utilizzando il selettore accanto ad essa. Una tabella di anteprima mostra le prime righe esattamente come verranno importate. * Una **colonna per il numero di telefono è obbligatoria**: non è possibile continuare senza associarne una. * Una colonna associata ai **Tag** diventa dei tag reali su ogni contatto. È possibile inserire più tag in una singola cella: separali con una virgola o un punto e virgola (`vip; newsletter; hotmart`). I tag non ancora esistenti verranno creati automaticamente; quelli già esistenti verranno riutilizzati, ignorando le maiuscole/minuscole. 4. **Revisione.** Scegli: * **Canale predefinito** — WhatsApp Business, WhatsApp Web o SMS. Si applica a qualsiasi contatto importato che non specifichi già un canale. * **Lista** — seleziona una lista esistente dal menu a tendina o digita un nome per crearne una nuova al momento. Puoi scegliere solo una delle due opzioni, non entrambe. * **Aggiorna contatti esistenti** — disattivato per impostazione predefinita. Se disattivato, le righe che corrispondono a un contatto già presente (stesso numero di telefono) vengono ignorate come duplicati: nulla nel contatto cambia e il contatto **non** viene aggiunto alla lista. Se attivato, quelle righe **aggiornano** il contatto: il nome, l'email e le note nel file sovrascrivono i dati esistenti (le celle vuote lasciano invariato il valore corrente), eventuali tag nella riga vengono aggiunti e il contatto viene inserito nella lista selezionata. Questo è il modo in cui puoi reimportare un file per correggere o arricchire i contatti che già possiedi. 5. Fai clic su **Importa [count]**. Verrai indirizzato a una schermata dei risultati che mostra quanti contatti sono stati creati, quanti contatti esistenti sono stati aggiornati (quando l'opzione è attiva) e, se alcune righe sono state ignorate, una spiegazione del motivo (numero di telefono non valido, numero di telefono mancante, duplicato, limite di contatti raggiunto, ecc.). --- ## Dettagli sull'associazione delle colonne * **Telefono** è l'unica colonna obbligatoria. Le righe prive di numero di telefono vengono scartate prima dell'importazione e conteggiate separatamente nella schermata dei risultati. * **Nome / Cognome / Email** si mappano direttamente sui campi base del contatto. * **Note** si mappa sul campo [Note / Profilo Lead](custom-contact-fields.md#notes-lead-profile) del contatto. * **Tag** crea (o riutilizza) tag reali e li applica al contatto: gli stessi tag che utilizzi per filtrare, per inviare broadcast e per attivare webhook. Inseriscine diversi in una cella separati da virgole o punti e virgola. Prima del 19 agosto 2026 questa colonna veniva salvata come campo personalizzato chiamato `tags`; se hai importato prima di tale data, reimporta lo stesso file con **Aggiorna contatti esistenti** attivo e i tag verranno applicati correttamente (il campo personalizzato `tags` rimanente non causa problemi; contatta l'assistenza se desideri che venga rimosso da ogni contatto). * Attualmente non esiste una mappatura di colonna per campi personalizzati arbitrari (come le colonne `custom_` del sistema classico): consulta [Caricamento massivo di campi personalizzati](custom-contact-fields.md#bulk-loading-custom-fields) per la soluzione alternativa attuale. --- ## Suggerimenti - Verifica che i numeri di telefono includano il prefisso internazionale. Senza di esso, i messaggi non verranno consegnati e le righe senza un numero di telefono utilizzabile verranno ignorate completamente. - Non è necessario rimuovere spazi, trattini o parentesi dai numeri di telefono: l'importatore tollera la formattazione comune, ma richiede comunque il prefisso internazionale. - I file vengono analizzati interamente nel tuo browser, quindi non c'è un limite fisso alla dimensione del caricamento da parte della procedura guidata, ma il numero totale di contatti è comunque limitato dal tuo piano. Se un'importazione dovesse superare il limite del tuo piano, quelle righe verranno rifiutate e appariranno nella schermata dei risultati come `contact_limit_reached`. - Se un contatto con lo stesso numero di telefono esiste già, quella riga viene ignorata per impostazione predefinita e appare come `duplicate` nella schermata dei risultati. L'importazione non crea mai una seconda copia di un contatto. Per modificare in blocco i contatti che già possiedi (correggere nomi o email, aggiungere tag, inserirli in una lista), attiva **Aggiorna contatti esistenti** nel passaggio di Revisione e reimporta il file. --- ## Domande frequenti **Il mio CSV ha una colonna `custom_company` da una vecchia esportazione: verrà mappata correttamente?** Non automaticamente. L'abbinamento automatico della procedura guidata riconosce solo le intestazioni nome/telefono/email/tag/note; tutto il resto viene impostato come **Non importare**, quindi una colonna `custom_company` non popolerà da sola il campo personalizzato `company`. Aggiungi i valori in seguito tramite [Campi personalizzati](custom-contact-fields.md) o tramite API. **Dov'è finito il pulsante "Scarica modello"?** Non c'è più: la procedura guidata funziona direttamente con qualsiasi CSV tu abbia già e ti consente di correggere eventuali colonne non corrispondenti nel passaggio di Associazione. **Ho già importato i miei contatti: come posso aggiungere tag o correggere i campi per tutti contemporaneamente?** Reimporta lo stesso file (o una versione aggiornata) con **Aggiorna contatti esistenti** attivato nel passaggio di Revisione. Le righe che corrispondono a un numero di telefono esistente aggiorneranno quel contatto (nome, email, note, tag e lista) invece di essere ignorate. Solo i numeri di telefono vengono utilizzati per la corrispondenza, quindi mantieni quella colonna esattamente com'era. **Posso importare contatti Instagram o Messenger da un file?** No. L'importazione supporta solo WhatsApp Business, WhatsApp Web e SMS, poiché questi canali raggiungono le persone tramite numero di telefono. Instagram e Messenger identificano invece le persone tramite il loro account social, pertanto tali contatti vengono creati automaticamente quando qualcuno ti invia un messaggio su quel canale. **Posso importare contatti come inattivi per il bot?** Non esiste una colonna specifica per riga. Importa prima il gruppo, quindi utilizza l'azione in blocco **Bot disattivato** sui contatti importati: vedi [Esclusione dei contatti dal bot AI](excluding-contacts-from-bot.md). --- ## Prossimi passi - [Organizzazione di liste e contatti](list-and-contact-management.md) — gestisci e ordina i tuoi contatti appena importati. - [Passaggio da Campagne a Broadcast e Agenti](../moving-from-campaigns.md) — inizia a inviare messaggi alla tua lista importata. - [Campi personalizzati, profilo lead e note](custom-contact-fields.md) — aggiungi dettagli più ricchi dopo l'importazione.