Che cos'è l'importazione dei contatti?
L'importazione dei contatti consente di aggiungere e aggiornare più contatti sulla piattaforma.
L'importazione dei contatti è utile per i seguenti motivi:
Sincronizza un elenco contatti sulla piattaforma
Sincronizzare la tua lista contatti con la piattaforma ti aiuta a identificare i contatti quando ti inviano un messaggio.Aggiorna in massa i contatti sulla piattaforma
Aggiorna le informazioni di più contatti esistenti sulla piattaforma invece di aggiornarli uno per uno.Inizia una conversazione con il contatto
Avvia conversazioni con i contatti nella tua lista contatti senza dover aspettare il loro primo messaggio.
L'invio del primo messaggio è applicabile solo per WhatsApp, SMS e email, a condizione che sia aggiunto il numero di telefono o l'indirizzo email del contatto.
Importazione Contatti
Il processo di importazione dei contatti è suddiviso in 3 parti: Carica file CSV, Mappatura e Revisione.
Parte 1: Iniziare un'importazione dei contatti
Per importare i contatti, è necessario caricare un file CSV. Ogni riga nel file CSV rappresenta un contatto e ogni colonna rappresenta un campo di contatto.
Passo 1: Nel modulo Contatti, clicca sulla freccia nel pulsante Aggiungi contatto > Importa contatti.
In alternativa, vai su Impostazioni > Importa dati> fai clic sul pulsante Importa contatti.
Passo 2: Carica un file CSV con i contatti e i dettagli che desideri importare.
Assicurati che il file CSV soddisfi i seguenti requisiti:
Solo i file CSV sono accettati per l'importazione.
La dimensione del file deve essere inferiore a 20MB.
Il file deve contenere almeno una riga.
Il file deve contenere meno di 200.000 righe.
È necessaria una colonna Nome per aggiungere nuovi contatti.
Almeno una colonna deve essere mappata ad un identificatore (eccetto per l'opzione di importazione AggiungiTutti i contatti nonostante i duplicati).
Tutti i numeri di telefono nel file CSV devono includere il codice paese e si raccomanda di utilizzare il segno "+", ad esempio +60189988776.
Formato raccomandato per il campo Data: "AAAA-MM-GG". es. 2023-10-25
Per vedere un esempio di file CSV popolato, scaricare il campione facendo clic sul collegamento ipertestuale.
Passo 3: Selezionare lo scopo di importazione per questo file.
Scopo dell'importazione | Azione |
|---|---|
Aggiungi solo nuovi contatti | Aggiunge al Workspace solo i nuovi contatti presenti nel file CSV. |
Aggiorna solo i contatti esistenti | Aggiorna solo i contatti esistenti nel Workspace con i valori del file. |
Aggiungi & aggiorna contatti | Aggiorna i contatti esistenti e aggiunge nuovi contatti al Workspace. |
Aggiungi tutti i contatti nonostante i duplicati | Tutti i contatti nel file saranno trattati come nuovi contatti. Puoi rivedere e unire manualmente i contatti duplicati sulla piattaforma. |
Passo 4: Selezionare un identificatore per riconoscere i contatti esistenti. L'identificatore può essere un numero di telefono o un'email. Se il tuo scopo di importazione è Aggiorna solo i contatti esistenti, puoi anche selezionare ID contatto come identificatore.
Si noti che gli indirizzi email non fanno distinzione tra maiuscole e minuscole. Ciò significa che john.smith@gmail.com e John.Smith@gmail.com saranno riconosciuti come lo stesso indirizzo email sulla piattaforma.
L'identificatore non è disponibile per la selezione se hai selezionato l'opzione Aggiungi tutti i contatti nonostante i duplicati come scopo dell'importazione nel passaggio precedente.
Passo 5: Aggiungi tag per tutti i contatti che vengono aggiunti o aggiornati sul Workspace secondo necessità. Quindi, fai clic su Successivo.
Un tag di importazione verrà generato automaticamente per identificare ogni lotto importato. Questo tag può essere rimosso.
Parte 2: Mappa Intestazioni CSV ai campi di contatto
Mappa le intestazioni delle colonne nel file CSV ai campi di contatto nel tuo Workspace. Questo determina quale campo di contatto sarà aggiornato con i valori di una colonna. Se un'intestazione di colonna nel file corrisponde esattamente al nome di un campo di contatto (es. Numero di telefono), verrà mappata automaticamente.
Assicurati che l'identificatore definito sia mappato. Ogni campo di contatto può essere mappato una sola volta.
Se desideri ignorare una colonna in modo che i suoi valori non vengano importati, deseleziona la casella di controllo alla sua sinistra. Deve essere selezionata almeno una colonna per procedere con l'importazione.
“Casella "Do Not Overwrite" e sue funzioni
Se hai selezionato l'opzione Aggiorna solo i contatti esistenti o Aggiungi & aggiorna contatti come scopo dell'importazione, apparirà un'opzione Do Not Overwrite.
Quando Do Not Overwrite è selezionato:
I campi con valori esistenti non verranno sovrascritti, i valori verranno aggiunti solo quando il campo è vuoto.
I nuovi tag saranno aggiunti senza rimuovere i tag esistenti.
Per impostazione predefinita, un valore nel file CSV sostituirà il corrispondente valore del campo esistente nel tuo Workspace.
Esempio:
Il contatto A nel tuo Workspace ha l'e-mail contactabc@email.com. Nel file CSV caricato, il contatto A è identificato dal suo numero di telefono e ha l'indirizzo email contact123@email.com.
Se la casella di controllo non è selezionata (predefinita), il valore esistente verrà sovrascritto e l'email del contatto A sarà aggiornata a _contact123@email.com._
Se la casella di controllo è selezionata, il valore esistente non verrà sovrascritto e l'email del contatto A rimarrà come contactabc@email.com.
Una volta che le colonne sono state mappate, fare clic su Successivo. Il file di importazione verrà quindi convalidato. Tieni presente che l'importazione di file CSV più grandi richiederà più tempo.
Parte 3: Riesame dell'importazione
Verrà riportato il numero di contatti che saranno aggiunti e aggiornati dopo l'importazione, o saltati a causa di errori. Una volta pronto, fai clic su Importa per procedere.
Le righe contenenti errori non verranno importate. Per identificare gli errori nelle righe originali, fai clic su "Scarica file errori" per scaricare un file CSV con una colonna "Errore". Risolvi gli errori descritti nei messaggi di errore. Una volta fatto, carica il file CSV corretto o torna alla Parte 1 per riconfigurare l'importazione.
Una volta che il file è stato convalidato, fai clic su Importa per procedere. Apparirà una finestra di dialogo per confermare che l'importazione è iniziata.
Il processo di importazione può richiedere un certo tempo. Puoi monitorarne l'avanzamento andando su Impostazioni > Importa dati.
Controlla risultati importazione
Riceverai una notifica via e-mail e nel centro notifiche della piattaforma quando il lavoro di importazione sarà completato.
Puoi scaricare il file dei risultati dalla tua email o dalla tabella Cronologia importazioni in Impostazioni > Importa dati. Questo file sarà disponibile per 7 giorni. Il file dei risultati conterrà 2 colonne aggiuntive: Stato importazione e Errori.
La colonna Stato importazione può avere uno dei 4 stati possibili:
Stato Importazione | Risultato |
|---|---|
Importato | Contatto aggiunto con successo. |
Aggiornato | Contatto aggiornato con successo. |
Saltato | Il contatto è stato saltato in base allo scopo di importazione (es. nuovo contatto in un'importazione Aggiorna solo contatti esistenti). |
Errore | Il contatto non è stato importato a causa di errori. |
La colonna Errori contrassegnerà le righe con errori rilevati durante l'importazione. I contatti in queste righe non sono stati importati. Per importare questi contatti, risolvi gli errori e riprova.
FAQ e risoluzione dei problemi
Quanti file posso importare alla volta?
Puoi importare solo un file per importazione.
Perché non riesco a importare contatti tramite file CSV?
Potresti non riuscire a importare i contatti se ci sono problemi nella creazione o nel formato del tuo file CSV.
Per evitare problemi durante l'importazione dei contatti, verifica quanto segue:
Il file è salvato come file CSV valido (.csv).
Il file è codificato in UTF-8.
I numeri di telefono dei contatti sono nel formato E.164.
Perché i nomi dei contatti con caratteri speciali appaiono in modo errato nel mio file CSV?
Questo accade perché Excel utilizza la codifica ANSI, che non supporta alcuni caratteri speciali o non latini, come i caratteri cinesi o i logogrammi.
Per garantire che i nomi dei contatti vengano visualizzati correttamente, il file CSV deve essere importato usando codifica UTF-8.
Cosa puoi fare
Apri Excel e seleziona Dati > Recupera dati > Da testo/CSV.
Nella scheda Dati, sotto Origine file, scegli 65001: Unicode (UTF-8).
Fai clic su Importa.
Salva le impostazioni.
Riapri il file per confermare che i caratteri vengano visualizzati correttamente.
Perché non riesco a iniziare una nuova importazione?
È possibile avere una sola attività di importazione in corso alla volta. Ti preghiamo di attendere che l'attività di importazione sia completata prima di iniziarne una nuova.
Cosa significa l'errore "Sessione scaduta"?
Hai una finestra di 1 ora per procedere con un'attività di importazione. Se un'importazione non viene avviata entro 1 ora nella fase di revisione, verrà automaticamente annullata e dovrai riavviare il processo di importazione.
Cosa succede se ci sono due Contatti con lo stesso identificatore nel file CSV?
Entrambi i contatti nel file CSV verranno segnalati nella colonna Errori del file di errore. I loro valori non verranno aggiunti o aggiornati nello Spazio di lavoro.
Cosa succede se ci sono due Contatti esistenti con lo stesso identificatore nello Spazio di lavoro?
Se più contatti condividono un valore di identificatore nello Spazio di lavoro (ad esempio profili di contatto duplicati o un indirizzo email o numero di telefono condiviso utilizzato da due contatti), verrà indicato un errore nella riga con lo stesso valore nel file CSV.
I Tag sono obbligatori per le importazioni di Contatti?
No, non lo sono. Puoi aggiungere, aggiornare e rimuovere i Tag come desideri.
Un Tag di importazione verrà generato automaticamente per ogni importazione per identificare quali Contatti sono stati aggiunti o aggiornati durante l'importazione. Questo Tag è facoltativo e può essere rimosso.
Perché alcuni Contatti esistenti non vengono identificati dall'identificatore del numero di telefono?
Il formato del numero di telefono deve essere identico nel file CSV e nello Spazio di lavoro affinché il numero venga identificato. Se lo stesso numero di telefono ha formati diversi (ad esempio, uno manca di un prefisso), il Contatto esistente non può essere identificato e il Contatto nel file sarà considerato un nuovo Contatto.
Se stai cercando di aggiornare solo i Contatti esistenti, questo Contatto sarà saltato.
Se stai cercando di caricare nuovi Contatti, verrà creato un nuovo profilo di Contatto per questo Contatto.
Perché i numeri di telefono appaiono in notazione scientifica nel mio file CSV?
Quando prepari un file CSV per l'importazione dei contatti, i numeri di telefono troppo lunghi possono essere convertiti automaticamente in notazione scientifica (ad esempio, 4.48E+11).
Questo accade perché strumenti per fogli di calcolo, come Excel, modificano automaticamente il formato delle celle. Una volta convertito, il formato del numero di telefono diventa non valido, causando il fallimento dell'importazione dei contatti.
Cosa puoi fare
Cambia il formato della colonna dei numeri di telefono in Testo semplice.
Salva il tuo file CSV.
Ricarica il tuo file CSV su importa contatti.
