Quando importi i tuoi contatti in Brevo, alcuni dati, ad esempio gli indirizzi email e i numeri di telefono, devono essere in un formato specifico per essere importati correttamente. Seguendo i requisiti e le linee guida presenti in questo articolo, puoi configurare correttamente i file che contengono le informazioni dei tuoi contatti.
A scopo illustrativo, creeremo un file .CSV da zero per importare contatti con attributi predefiniti e personalizzati per un istruttore di yoga, che puoi adattare facilmente alle tue esigenze.
📂 Requisiti dei file
I tuoi file devono soddisfare i seguenti requisiti:
- Non è previsto alcun limite al numero di contatti che puoi importare contemporaneamente. Tuttavia, le dimensioni del tuo file non devono essere superiori a 250 MB. Se il tuo file supera questo limite, dividilo in file più piccoli da importare separatamente.
- Includi solo un foglio nel tuo file.
- Salva il tuo file in uno dei formati seguenti e assicurati che il separatore sia un punto e virgola, una virgola o una tabulazione:
.CSV |
.XLSX |
.TXT |
- Salva il tuo file con codifica UTF-8 o Windows-1252. Questi tipi di codifica dei file consentono di leggere il contenuto del tuo file quando contiene caratteri speciali.
- Per creare un contatto è richiesto almeno uno dei seguenti campi: EMAIL, SMS, WHATSAPP, LANDLINE_NUMBER o EXT_ID.
Fase 1: creazione del file
Per creare il tuo file:
- Apri il tuo programma per fogli di calcolo (Excel, Fogli Google) per creare un nuovo file.
- Scegli uno dei metodi seguenti per iniziare:
- Scarica il nostro file .CSV di esempio.
- Esporta i contatti già presenti in Brevo (Esportazione dei contatti da Brevo) o in un'altra app.
- Comincia da zero.
Fase 2: preparazione della riga di intestazione del file
Puoi creare nuovi attributi attributo durante la fase di abbinamento della procedura di importazione; non è necessario crearli in anticipo.
Aggiungi le informazioni che desideri importare per i tuoi contatti nella riga di intestazione del tuo file.
Ogni cella di intestazione rappresenta le informazioni che verranno abbinate a un attributo di contatto Brevo durante l'importazione. Anche se non è obbligatorio, ti consigliamo di utilizzare i nomi esatti degli attributi di contatto nella riga di intestazione, in quanto ciò aiuta il nostro sistema ad abbinarli automaticamente.
Nel nostro esempio, abbiamo aggiunto attributi predefiniti come EMAIL o FIRSTNAME (NOME), ma abbiamo incluso anche degli attributi personalizzati relativi alle lezioni di yoga (FIRST_CLASS (PRIMA_LEZIONE), LEVEL (LIVELLO), FREE_TRIAL (PROVA_GRATUITA)).
Per ulteriori informazioni sul formato previsto per ciascun attributo di contatto, consulta la sezione successiva.
Fase 3: aggiunta delle informazioni dei contatti al file
Ora puoi inserire le informazioni dei tuoi contatti nel file:
- Puoi copiare i dati da un altro programma o da un file esportato, oppure
- Digita direttamente nel file.
Assicurati che ogni colonna contenga informazioni corrispondenti all'attributo nella riga di intestazione del tuo file e che ogni riga contenga informazioni su un singolo contatto.
Le informazioni nel tuo file devono seguire un formato specifico per essere importate correttamente. Esistono linee guida specifiche per:
Attributi di contatto predefiniti
Per impostazione predefinita, in Brevo sono disponibili alcuni attributi di contatto. Richiedono un formato specifico per essere importati correttamente. Espandi i seguenti paragrafi comprimibili per ulteriori informazioni sul formato previsto per ciascun attributo di contatto:
L'attributo CONTACT_ID (ID_CONTATTO) viene creato automaticamente da Brevo quando importi i tuoi contatti. È un numero fisso che non può essere modificato. Puoi recuperare l'ID di contatto dei tuoi contatti solo esportandoli da Brevo.
Per importare il nome e il cognome dei tuoi contatti, utilizza gli attributi di contatto FIRSTNAME (NOME) e LASTNAME (COGNOME).
Per importare l'indirizzo email dei tuoi contatti, utilizza l'attributo di contatto EMAIL.Ogni contatto può avere un solo indirizzo email, che deve essere univoco per quel contatto.
Non includere caratteri speciali.
Assicurati che gli indirizzi email nel tuo file siano validi e che non manchi nessuna parte.
Nel nostro esempio sbagliato qui sotto, nell'indirizzo email manca il suffisso del dominio e l'indirizzo contiene un carattere speciale:
❌ | rose&@example | ✅ | rose@example.com |
Per importare il numero di telefono di un contatto, utilizza i seguenti attributi del contatto predefiniti come intestazioni di colonna:
- SMS per il numero di telefono utilizzato per i messaggi SMS e le chiamate tramite l'app Phone.
- WHATSAPP per il numero di telefono utilizzato per i messaggi WhatsApp e le chiamate tramite l'app Phone.
- LANDLINE_NUMBER (NUMERO DI RETE FISSA) per il numero di telefono utilizzato per le chiamate attraverso l'app Phone.
Non separare le cifre con caratteri speciali.
Assicurati che i numeri di telefono presenti nel tuo file includano il segno + e il prefisso internazionale del Paese e che le cifre non siano separate da caratteri speciali.
Nel nostro esempio sbagliato qui sotto, nel numero di telefono mancano il segno + e il prefisso internazionale, inoltre le cifre sono separate da caratteri speciali:
❌ | (337) 456-9342 | ✅ | +13374569342 |
Per importare l'ID esterno di un contatto creato al di fuori di Brevo, utilizza il attributo del contatto EXT_ID.
Attributi di contatto personalizzati
Puoi creare attributi di contatto personalizzati in Brevo per soddisfare le tue esigenze. Per essere importati correttamente, richiedono un formato specifico in base al tipo di attributo. Espandi i seguenti paragrafi comprimibili per ulteriori informazioni sul formato previsto per ciascun tipo di attributo:
Gli attributi di tipo testo memorizzano una stringa di caratteri alfanumerici, ad esempio una parola, una frase o un insieme di frasi. Puoi utilizzare un attributo di tipo testo per importare dati aggiuntivi sui tuoi contatti. Quando vengono importati, gli attributi di tipo testo non hanno limiti di caratteri.
Gli attributi di tipo numero memorizzano una stringa di cifre o numeri scritti in formato decimale. Puoi utilizzare un attributo di tipo numero per importare numeri o valori di valuta nei tuoi contatti.
Gli attributi di tipo data vengono utilizzati per memorizzare un valore di data. Mantieni il formato del valore di questo attributo simile a quello selezionato nelle impostazioni del tuo account (GG-MM-AAAA o MM-GG-AAAA).
Gli attributi di tipo categoria memorizzano un insieme di valori possibili. Ad esempio, puoi creare un attributo di contatto denominato LEVEL (LIVELLO) e definire i valori possibili come BEGINNER (PRINCIPIANTE), INTERMEDIATE (INTERMEDIO) ed EXPERT (ESPERTO). L'attributo di ogni contatto conterrà quindi solo un valore fra questi tre.
Gli attributi del tipo a scelta multipla memorizzano un insieme di valori possibili. Ad esempio, puoi creare un attributo di contatto chiamato SPORTS (SPORT) e definire i valori possibili come BASEBALL, FOOTBALL (CALCIO) e YOGA. L'attributo di ciascun contatto conterrà quindi solo un valore fra questi tre.
L'attributo di contatto del tipo a scelta multipla deve seguire il formato: ['Opzione1'|'Opzione2'|'Opzione3'].
Assicurati che gli attributi di contatto a scelta multipla nel tuo file seguano il formato: ['Opzione1'|'Opzione2'|'Opzione3'].
Nell'esempio sbagliato riportato di seguito, le opzioni sono separate da una virgola anziché da una barra verticale e a ciascuna opzione mancano le virgolette singole.
❌ | [Baseball,Volleyball,Dance] ([Baseball,Pallavolo,Danza]) | ✅ | [['Baseball'|'Volleyball'|'Dance'] (['Baseball'|'Pallavolo'|'Danza']) |
Gli attributi di tipo booleano possono memorizzare come valore solo Yes (Sì) o No.
Fase 4: salvataggio del file
Dopo aver completato e formattato correttamente il tuo file, salvalo in formato .CSV, .XLSX o .TXT utilizzando la codifica UTF-8 o Windows-1252.
Espandi i paragrafi comprimibili sottostanti per informazioni su come codificare un file in UTF-8 utilizzando diversi editor di fogli di calcolo: ⬇️
- Apri il tuo file in Microsoft Excel.
- Clicca su File > Save As (Salva con nome).
- Assegna un nome al tuo file.
- Seleziona CSV UTF-8 (Comma delimited) (.csv) (CSV UTF-8 (delimitato da virgole) (.csv)) come formato del file.
- Clicca su Save (Salva).
- Apri il tuo file in Fogli Google.
- Clicca su File > Download (Scarica).
- Seleziona Comma-separated values (.csv, current sheet) (Valori separati da virgole (.csv, foglio corrente)) come formato del file.
- Apri il tuo file in Blocco note.
- Clicca su File > Save as (Salva con nome).
- Assegna un nome al tuo file e aggiungi l'estensione .csv alla fine.
- Nel menu a discesa Save as type (Salva come), seleziona All files (Tutti i file).
- Nel menu a discesa Encoding (Codifica), seleziona UTF-8.
- Clicca su Save (Salva).
- Apri il tuo file in LibreOffice.
- Clicca su File > Save as (Salva con nome).
- Assegna un nome al tuo file.
- Nel menu a discesa Save as type (Salva come), seleziona Text CSV (.csv) (Testo CSV (.csv)).
- Abilita l'opzione Edit filter settings (Modifica impostazioni filtro).
- Clicca su Save (Salva).
- Nella finestra di dialogo Export Text File (Esportazione file di testo) , seleziona l'opzione Unicode (UTF-8) nel menu a discesa Character set (Tipo di carattere).
- Imposta Field delimiter (Separatore di campo) e String delimiter (Separatore di testo).
- Clicca su OK.
- Apri il tuo file in Numbers.
- Clicca su File.
- Seleziona Export to... (Esporta come...) > CSV...
- Clicca su Advanced options (Opzioni avanzate).
- Clicca sul menu a discesa Text Encoding (Codifica testo).
- Seleziona Unicode (UTF-8).
- Clicca su Next (Avanti).
- Assegna un nome al tuo file e scegli una posizione.
- Clicca su Save (Salva).
Fase 5: importazione del file in Brevo
È il momento di importare i dati dei tuoi contatti in Brevo!
➡️ Per informazioni su come importare i tuoi file in Brevo, consulta il nostro articolo dedicato Importazione dei contatti in Brevo.
❓ FAQ
Puoi associare i tuoi contatti alle trattative e alle aziende aggiungendo campi specifici al tuo file e importandolo in Brevo. Per ulteriori informazioni, consulta il nostro articolo dedicato Associazione di aziende, trattative e contatti.
Se il segno "+" scompare quando lo aggiungi a un numero di telefono nel tuo file, aggiungi un apostrofo prima del segno. Questo consente al tuo programma per fogli di calcolo di riconoscere il numero come numero di telefono.
Sì, puoi importare un file che contiene campi vuoti. I risultati dipendono dal tipo di contatti che stai importando e dalle opzioni che hai abilitato durante la finalizzazione dell'importazione:
- Se stai importando nuovi contatti, i campi vuoti del tuo file saranno vuoti anche in Brevo.
- Se stai importando contatti esistenti e hai rimosso alcuni dati dal file, i casi sono due:
- Se hai abilitato l'opzione Import empty fields to erase existing attribute data (Importa campi vuoti per cancellare i dati degli attributi esistenti) al momento della finalizzazione dell'importazione, i campi vuoti cancelleranno i dati esistenti in Brevo.
- Se hai disabilitato l'opzione Import empty fields to erase existing attribute data (Importa campi vuoti per cancellare i dati degli attributi esistenti) al momento della finalizzazione dell'importazione, i campi vuoti non influenzeranno i dati esistenti.
Se i dati del tuo contatto contengono il carattere sostitutivo UTF-8 "�", vengono ignorati e l'attributo del contatto corrispondente non viene importato in Brevo. Questo carattere può comparire durante l'esportazione dei dati da alcuni strumenti, in quanto viene utilizzato per sostituire caratteri sconosciuti, non riconosciuti o non rappresentabili.
Il sistema non supporta i file Excel (.xls), ACT!, .vcf (Apple vCard) o altri tipi di file, quindi devi convertire il tuo file in uno dei formati supportati (.CSV, .XLSX, o .TXT).
Per convertire il tuo file, puoi utilizzare strumenti online gratuiti. Prima di caricarlo su Brevo, assicurati che il file convertito segua le raccomandazioni per la configurazione di un file di importazione riportate in questo articolo.
⏭️ E adesso?
- Importazione di contatti in Brevo
- Risoluzione dei problemi - Perché non riesco a importare i contatti?
- Informazioni sugli attributi dei contatti
- Creazione e gestione degli attributi dei contatti personalizzati
🤔 Domande?
In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarci qui.
Se stai cercando aiuto per un progetto che prevede l'utilizzo di Brevo, possiamo metterti in contatto con l'agenzia partner di Brevo giusta per te.
- CSV_sample.csv393 byte