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. Pertanto, prima di importare i tuoi contatti, ti consigliamo di seguire questo articolo per configurare correttamente il file che contiene le informazioni dei tuoi contatti.

📂 Requisiti dei file

• 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:

• 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.

🛠 Creazione del file

A titolo di esempio, in questo articolo creeremo da zero un file .CSV per l'importazione di contatti con attributi predefiniti e personalizzati per un istruttore di yoga. Puoi adattare facilmente questo caso d'uso alle tue esigenze, rispettando i requisiti e le linee guida presenti in questo articolo.

Fase 1: configurazione del file con gli attributi di contatto

1. Apri il tuo programma per fogli di calcolo (Excel, Fogli Google) per creare un nuovo file. Hai 3 opzioni per iniziare:
   • Puoi scaricare il nostro file .CSV di esempio.
   • Puoi esportare i contatti che hai già in Brevo (Esportazione dei contatti da Brevo) o in un'altra app.
   • Puoi iniziare da zero.
2. Nella riga di intestazione del tuo file, aggiungi le informazioni che desideri importare sui tuoi contatti. Ogni cella rappresenta un'informazione che verrà abbinata a un attributo del contatto Brevo e importata.
   Nel nostro esempio, abbiamo aggiunto attributi predefiniti come EMAIL o FIRSTNAME (NOME), ma abbiamo incluso anche degli attributi personalizzati relativi alle classi di yoga (FIRST_CLASS (PRIMA CLASSE), LEVEL (LIVELLO), FREE_TRIAL (PROVA GRATUITA)). 
   
   Utilizza le schede sottostanti per conoscere meglio tutti gli attributi di contatto disponibili ⬇️
   
   Attributi di contatto predefiniti Attributi di contatto personalizzati

   Per impostazione predefinita, alcuni attributi di contatto vengono creati automaticamente da Brevo. Richiedono un formato specifico per essere importati correttamente:

   🆔 CONTACT_ID (ID 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. Ti consigliamo di includere l'attributo CONTACT_ID (ID CONTATTO) nel tuo file solo se desideri aggiornare i contatti esistenti attraverso un'importazione.

   

   👤 FIRSTNAME (NOME) / LASTNAME (COGNOME)

   Per importare il nome e il cognome dei tuoi contatti, utilizza gli attributi di contatto FIRSTNAME (NOME) e LASTNAME (COGNOME).

   

   ✉️ EMAIL

   Per importare l'indirizzo email dei tuoi contatti, utilizza l'attributo di contatto EMAIL.

   

   📱 SMS / WHATSAPP / LANDLINE_NUMBER (NUMERO DI RETE FISSA)

   💡 Buono a sapersi

   I contatti possono avere lo stesso numero di telefono per SMS, WhatsApp e Phone. Vengono utilizzate liste di blocco separate quando un contatto si disiscrive da SMS, WhatsApp o Phone.

   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.
   • WHATSAPP per il numero di telefono utilizzato per i messaggi di WhatsApp.
   • LANDLINE_NUMBER (NUMERO DI RETE FISSA) per il numero di telefono utilizzato per le chiamate attraverso l'app Phone.

   Includi sempre il segno + e il prefisso internazionale del Paese all'inizio del numero di telefono e non separare le cifre con caratteri speciali. 

   

   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:

   🔠 TEXT (TESTO)

   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.

   

   🔢 NUMBER (NUMERO)

   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.

   

   🔢 DATE (DATA)

   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).

   

   💡 Buono a sapersi

   I trattini - e le barre / sono intercambiabili. Ad esempio, 13-03-2022 e 13/03/2022 sono considerati identici.

   🗂 CATEGORY (️CATEGORIA)

   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.

   

   💡 Buono a sapersi

   Hai anche la possibilità di includere il numero ID del valore, invece del valore stesso. Puoi visualizzare il numero ID di un valore cliccando sull'icona a forma di ingranaggio ⚙️ accanto all'attributo di contatto desiderato nella pagina Contact Attributes (Attributi dei contatti).

   ✖️ MULTIPLE-CHOICE (SCELTA MULTIPLA)

   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'].

   

   💡 Buono a sapersi

   Hai anche la possibilità di includere il numero ID del valore, invece del valore stesso. Puoi visualizzare il numero ID di un valore cliccando sull'icona a forma di ingranaggio ⚙️ accanto all'attributo di contatto desiderato nella pagina Contact Attributes (Attributi dei contatti).

   👍👎 BOOLEAN (BOOLEANO)

   Gli attributi di tipo booleano possono memorizzare come valore solo Yes (Sì) o No. 

   

Quando importi il tuo file in Brevo, puoi creare direttamente nuovi attributi. Non devi necessariamente crearli in anticipo.

Fase 2: aggiunta delle informazioni dei contatti al file

Ora puoi compilare il file inserendo le informazioni dei tuoi contatti:

• Puoi copiare i dati da un altro programma o da un file esportato, oppure
• Puoi scrivere 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:

Fase 3: verifica del formato dei dati

Ora che il tuo file contiene tutti i dati che desideri importare, prenditi un po' di tempo per verificare che sia formattato correttamente. Una formattazione errata dei dati può comportare l'importazione di informazioni non corrette o la loro mancata importazione.

Ad esempio, ecco alcune cose che ti consigliamo di controllare:

• Indirizzo email dei tuoi contatti: assicurati che gli indirizzi email presenti 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:
  

  ❌

  rose@example

  ✅

  rose@example.com

• Numero di telefono dei tuoi contatti: 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

• Attributi di contatto del tipo a scelta multipla: 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'])

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 scoprire come codificare un file in UTF-8 utilizzando diversi editor di fogli di calcolo ⬇️

Fase 5: importazione del file in Brevo

È il momento di importare i dati dei tuoi contatti in Brevo! Troverai tutti i dettagli nel nostro articolo dedicato Importazione di contatti in Brevo.

❓ FAQ

⏭️ E adesso?

• Importazione di contatti in Brevo
• Perché non riesco a importare i miei contatti?

🤔 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 il giusto partner esperto certificato Brevo.

• CSV_sample.csv342 byte