Creazione di un file per importare i contatti

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.

contacts_import_file_en-us.jpg

📂 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
(Microsoft Excel, OpenOffice Calc, Fogli Google, Numbers)

.XLSX
(formato aperto di Microsoft Excel)

.TXT
(Blocco note di Microsoft)

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

  1. Apri il tuo programma per fogli di calcolo (Excel, Fogli Google) per creare un nuovo file.
  2. Scegli uno dei metodi seguenti per iniziare:

Fase 2: preparazione della riga di intestazione del file

💡 Buono a sapersi

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.

➡️  Esempio

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)).contacts_header_row_en-us.jpg

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:

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

❗️ Importante
Ti consigliamo di includere l'attributo CONTACT_ID (ID_CONTATTO) nel tuo file solo se desideri aggiornare i contatti esistenti attraverso un'importazione. Se stai importando nuovi contatti, escludi la colonna CONTACT_ID (ID_CONTATTO).

contacts_contactID_en-us.jpg

👤 FIRSTNAME (NOME) / LASTNAME (COGNOME)

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

contacts_name_en-us.jpg

✉️ EMAIL

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.

contacts_email_en-us.jpg

❗️ Importante
L'attributo di contatto EMAIL non supporta i caratteri speciali, anche con codifica UTF-8 o Windows-1252.

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
📱 SMS / WHATSAPP / LANDLINE_NUMBER (NUMERO DI RETE FISSA)
💡 Buono a sapersi
Un contatto può avere lo stesso numero di telefono per SMS, WhatsApp e rete fissa. 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 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.

❗️ Importante
Se stai importando numeri con prefissi internazionali diversi, includi sempre un apostrofo ('), il segno + e il prefisso internazionale all'inizio del numero di telefono. Se manca il segno più, Brevo applicherà il prefisso internazionale predefinito durante la mappatura, il che può comportare numeri errati. L'apostrofo assicura che il segno + venga mantenuto nel file, impedendo che il prefisso internazionale venga sovrascritto quando viene applicato un valore predefinito.

contacts_phone_en-us.jpg

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
👽 EXT_ID

Per importare l'ID esterno di un contatto creato al di fuori di Brevo, utilizza il attributo del contatto EXT_ID.

contacts_ext-id-attribute-example_EN-US.png

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:

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

contacts_city_en-us.jpg

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

contacts_firstclass_en-us.jpg

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

contacts_import_category-attribute_en-us.jpg

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

contacts_multi-choice-attribute_EN-US.png

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'])
👍👎 BOOLEAN (BOOLEANO)

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: ⬇️

Microsoft Excel
  1. Apri il tuo file in Microsoft Excel.
  2. Clicca su File > Save As (Salva con nome).
  3. Assegna un nome al tuo file.
  4. Seleziona CSV UTF-8 (Comma delimited) (.csv) (CSV UTF-8 (delimitato da virgole) (.csv)) come formato del file.
    excel_EN.png
  5. Clicca su Save (Salva).
📗 Fogli Google
  1. Apri il tuo file in Fogli Google.
  2. Clicca su File > Download (Scarica).
  3. Seleziona Comma-separated values (.csv, current sheet) (Valori separati da virgole (.csv, foglio corrente)) come formato del file.
    utf8_googlespreadsheet.jpg
🗒 Blocco note
  1. Apri il tuo file in Blocco note.
  2. Clicca su File > Save as (Salva con nome).
  3. Assegna un nome al tuo file e aggiungi l'estensione .csv alla fine.
  4. Nel menu a discesa Save as type (Salva come), seleziona All files (Tutti i file).
  5. Nel menu a discesa Encoding (Codifica), seleziona UTF-8.
    utf8_notepad.jpg
  6. Clicca su Save (Salva).
📄 LibreOffice
  1. Apri il tuo file in LibreOffice.
  2. Clicca su File > Save as (Salva con nome).
  3. Assegna un nome al tuo file.
  4. Nel menu a discesa Save as type (Salva come), seleziona Text CSV (.csv) (Testo CSV (.csv)).
  5. Abilita l'opzione Edit filter settings (Modifica impostazioni filtro).
    utf8_libreoffice.png
  6. Clicca su Save (Salva).
  7. 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).
  8. Imposta Field delimiter (Separatore di campo) e String delimiter (Separatore di testo).
  9. Clicca su OK.
📊 Numbers
  1. Apri il tuo file in Numbers.
  2. Clicca su File.
  3. Seleziona Export to... (Esporta come...) > CSV...
    utf8_numbers.jpg
  4. Clicca su Advanced options (Opzioni avanzate).
  5. Clicca sul menu a discesa Text Encoding (Codifica testo).
  6. Seleziona Unicode (UTF-8).
    utf8_numbers2.jpg
  7. Clicca su Next (Avanti).
  8. Assegna un nome al tuo file e scegli una posizione.
  9. 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

🤝 Posso associare i miei contatti a trattative e aziende?

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.

📱 Il segno "+" per i numeri di telefono scompare quando lo aggiungo al mio file. Come posso fare in modo che resti visualizzato?

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.

🗒 Posso importare un file che contiene campi vuoti?

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:

Il mio file contiene il carattere sostitutivo UTF-8 "�". Cosa succede quando lo carico?

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.

💾 Non riesco a salvare il mio file in formato .CSV, .XLSX o .TXT

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?

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

💬 Questo articolo ti è stato utile?

Utenti che ritengono sia utile: 113 su 213