Your AI Connector Docs

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à.
  1. Associa le colonne. La procedura guidata legge la riga di intestazione del file e tenta di abbinare automaticamente ogni colonna a un campo di destinazione: Nome, Cognome, Telefono, Email, Tag, Note, uno qualsiasi dei tuoi campi personalizzati o Non importare. Controlla l’associazione proposta 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 la cui intestazione corrisponde al nome di uno dei tuoi campi personalizzati viene abbinata automaticamente a quel campo. Maiuscole e accenti non contano, quindi una colonna CPF troverà un campo chiamato cpf. Puoi anche scegliere manualmente qualsiasi campo personalizzato per qualsiasi colonna.
    • Una colonna che non è ancora uno dei tuoi campi personalizzati può diventarlo: seleziona Nuovo campo personalizzato: nel relativo selettore e il campo verrà creato al momento dell’importazione.
    • Se un campo personalizzato ha un tipo (Numero, Casella di controllo, Menu a discesa) e alcuni dei valori della colonna non sono compatibili, la procedura guidata ti avviserà di quante righe sono interessate prima dell’importazione. Tali righe verranno ignorate completamente, inclusi nome ed email. Fai clic su Converti in Testo nell’avviso per modificare il tipo di campo in un unico passaggio, oppure correggi i valori o imposta la colonna su Non importare.
    • È obbligatoria una colonna per il numero di telefono: non è possibile procedere senza associarne una.
    • Una colonna associata a Tag diventerà dei tag reali su ogni contatto. È possibile inserire più tag in una singola cella, separandoli 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.
  1. Revisione. Scegli:
    • Canale predefinito — WhatsApp Business, WhatsApp Web o SMS. Si applica a qualsiasi contatto importato che non specifichi già un canale.
    • Elenco — seleziona un elenco esistente dal menu a discesa o digita un nome per crearne uno nuovo sul momento. Puoi fare solo una delle due cose, non entrambe. Se apri l’importazione mentre la pagina Contatti mostra uno dei tuoi elenchi, quell’elenco è già selezionato per te; deselezionalo se non lo desideri.
    • 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 cambia in quel contatto, anche se, se hai scelto un elenco, il contatto che già possiedi vi verrà comunque aggiunto. Se attivato, quelle righe aggiornano invece il contatto: nome, email e note nel file sovrascrivono quelli esistenti (le celle vuote lasciano invariato il valore attuale), eventuali tag nella riga vengono aggiunti e il contatto viene inserito nell’elenco scelto. È così che puoi reimportare un file per correggere o arricchire i contatti che già possiedi.
  1. Fai clic su Importa [count]. Verrai reindirizzato a una schermata dei risultati che mostra quanti contatti sono stati creati, quanti contatti esistenti sono stati aggiornati (se l’opzione è attiva), quanti contatti già presenti sono stati aggiunti all’elenco selezionato e, in caso di righe ignorate, una spiegazione del motivo (numero di telefono non valido, numero di telefono mancante, duplicato, limite di contatti raggiunto, ecc.). Se l’opzione Aggiorna contatti esistenti era disattivata e alcune righe corrispondevano a contatti già presenti, la schermata dei risultati lo segnalerà e offrirà l’opzione Aggiorna questi contatti: con un solo clic potrai inviare nuovamente solo quelle righe con l’opzione attivata, senza dover importare nuovamente il file.

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 del contatto.
  • Tag crea (o riutilizza) tag reali e li applica al contatto: gli stessi tag che utilizzi per filtrare, per inviare trasmissioni mirate 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 effettuato un’importazione prima di tale data, importa nuovamente lo stesso file con l’opzione Aggiorna contatti esistenti attiva 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).
  • Campi personalizzati — ognuno dei tuoi campi personalizzati è una destinazione a sé stante. Un’intestazione che corrisponde al nome di un campo viene selezionata automaticamente; il valore viene salvato sul contatto esattamente come appare nel file (un campo Numero, Data, Casella di controllo o Menu a discesa converte formati riconoscibili come 19,99, 01/02/1990 o yes). Seleziona Nuovo campo personalizzato per creare un campo da una colonna. Con l’opzione Aggiorna contatti esistenti attiva, i valori dei campi personalizzati nel file aggiornano anche i contatti già presenti; le celle vuote lasciano invariato il valore corrente.
  • Una colonna che contiene identificativi con punti, trattini o zeri iniziali (un CPF, un codice fiscale, un codice postale) deve essere inserita in un campo Testo. In un campo Numero, tali valori non sono compatibili e la riga viene ignorata.

Suggerimenti

  • Verifica due volte che i numeri di telefono includano il prefisso internazionale. Senza di esso, i messaggi non verranno consegnati e le righe prive di 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 di dimensione di 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 una persona. La selezione di un elenco funziona comunque su quelle righe: il contatto che già possiedi viene aggiunto all’elenco e conteggiato separatamente nella schermata dei risultati, quindi reimportare lo stesso file è il modo in cui puoi popolare un elenco con persone già presenti nel tuo account. Per aggiornare anche i loro campi (correggere nomi o email, aggiungere tag), attiva Aggiorna contatti esistenti nel passaggio di Revisione e reimporta il file.

Domande frequenti

Il mio CSV ha una colonna custom_company proveniente da una vecchia esportazione: verrà mappata correttamente? Non automaticamente, perché l’intestazione non è esattamente company. Seleziona Campo personalizzato: company nel selettore di quella colonna e verrà importata nel campo company. Rinominare l’intestazione in company prima del caricamento farà sì che la procedura guidata la riconosca automaticamente.

Alcune righe sono state ignorate con il messaggio “Il valore di un campo personalizzato non corrisponde al tipo di campo” — perché? La colonna è associata a un campo personalizzato con un tipo specifico (ad esempio Numero) e quelle righe contengono qualcos’altro, come 001.576.401-08 in un campo Numero. Fai clic su Converti in Testo nell’avviso durante la fase di associazione delle colonne (o modifica il tipo nella sezione Campi personalizzati) e importa nuovamente il file con l’opzione Aggiorna contatti esistenti attiva.

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.

Prossimi passi