Prima di iniziare

Prima di caricare il file, crea eventuali attributi dei contatti necessari (es. Numero Ordine, Tipo Cliente) in Superchat in modo da poter mappare correttamente i campi dei dati CSV durante l'importazione. Assicurati inoltre che i dati CSV siano formattati correttamente. Puoi trovare tutte le linee guida sulla formattazione nella sezione FAQ qui sotto.

Chi può importare i contatti?

Ruolo	Permesso
Amministratore	Può creare importazioni di contatti, visualizzare ed eliminare le importazioni storiche
Supervisore	Può creare importazioni di contatti
Membro	Può creare importazioni di contatti

Formattazione e requisiti dei dati

Qual è il formato corretto per i numeri di telefono?

I numeri di telefono devono seguire il formato E.164, che include il segno + e il prefisso internazionale (es. +391234567890).

Qual è il formato corretto per gli indirizzi email?

Le email devono essere indirizzi email validi (es. mario.rossi@gmail.com).
Se un indirizzo email non è valido, verrà ignorato durante l'importazione e non verrà aggiunto al contatto.

Qual è il formato corretto per le date e le date con ora?

Solo data: Usa il formato AAAA-MM-GG (es. 2025-07-22).
Data e ora: Usa il formato AAAA-MM-GG HH:MM:SSZ (es. 2025-07-22 10:15:00Z).
- Nota: Il sistema si aspetta l'ora in UTC. Se accedi a Superchat dalla Germania, un timestamp come 2024-08-22 10:15:00Z (UTC) verrà automaticamente convertito e visualizzato come 12:15 ora locale.

Qual è il formato corretto per i numeri?

Sono supportati solo i numeri interi (es. 1200).
I decimali non sono supportati — se carichi 4.5, verrà importato solo 4 e tutto ciò che segue il punto decimale verrà ignorato.
Non includere simboli di valuta o separatori delle migliaia (es. €1.200 → 1200).

Qual è il formato corretto per gli attributi a selezione singola e multipla?

Selezione singola: Il valore deve corrispondere esattamente a una delle opzioni predefinite (es. VIP).
Selezione multipla: Separa ogni opzione con una virgola (es. Opzione 1, Opzione 2, Opzione 3).

Come importare i contatti su Desktop

1. Vai a Contact Hub.

2. Clicca su Importa.

3. Carica il tuo file CSV con i contatti.

4. Verifica la tua importazione nell'anteprima del file:

Se tutto sembra corretto, clicca su Avanti.
Se ci sono problemi, consulta la sezione di gestione degli errori alla fine di questo articolo.

5. Conferma se la prima riga è una riga di titolo/intestazione.

Seleziona Sì se la prima riga contiene i nomi delle colonne (es. "Nome", "Numero di telefono", "Email").
Seleziona No se la prima riga contiene già dati effettivi dei contatti.

6. Mappa le tue colonne CSV agli attributi dei contatti che hai creato in Superchat, poi clicca su Avanti.

7. Opzionale: Aggiungi i contatti importati a una o più liste di contatti.

8. Completa l'importazione. Il caricamento potrebbe richiedere alcuni minuti per essere elaborato. Riceverai una email una volta che l'importazione sarà completata.

Come importare i contatti su Mobile

Sull'app mobile, puoi concedere a Superchat l'accesso ai contatti del tuo telefono e scegliere di caricare contatti selezionati o tutti i contatti.

Come importare i contatti:

Vai su Impostazioni nell'app mobile di Superchat.
Tocca Importa contatti.
Consenti all'app Superchat di accedere ai contatti del tuo telefono.
Scegli se caricare tutti i contatti o selezionare contatti specifici.
Completa l'importazione.

⚠️ Importante:

Questo potrebbe includere contatti personali che potresti non voler condividere.
Tutti i contatti che importi saranno visibili a tutti gli utenti nel tuo workspace.

Risoluzione dei problemi e errori

Perché l'anteprima del mio CSV sembra errata (colonne o caratteri non sono corretti)?

Questo di solito accade a causa di una codifica del file o di un delimitatore errato.

Come risolvere questo problema?

Salva il tuo CSV con codifica UTF-8.
Scegli il delimitatore corretto (virgola , o punto e virgola ;) nelle impostazioni di anteprima.

Perché un contatto potrebbe non essere caricato?

Motivi comuni includono:

La scheda del contatto non contiene un numero di telefono o un indirizzo email valido (almeno uno di questi è richiesto per importare un contatto).
Voci duplicate basate su identificatori univoci (es. stessa email o numero di telefono).
Superamento dei limiti di dimensione del file o dei campi. Il limite di dimensione del file è 20MB e puoi importare fino a 10.000 contatti per file CSV.

Perché alcuni campi di dati di un contatto sono vuoti anche se erano presenti nel CSV?

Se alcuni campi risultano vuoti dopo l'importazione, di solito significa che i dati non hanno superato la convalida o non erano nel formato corretto.
In questi casi, Superchat non importa il valore non valido e lascia semplicemente l'attributo vuoto (null) per quel contatto.
Controlla le regole di formattazione sopra (es. numeri di telefono in formato E.164, email valide, formati data corretti, corrispondenze esatte per gli attributi a selezione) e correggi il tuo CSV prima di ricaricarlo.

FAQ

Quanti contatti posso caricare contemporaneamente?

Puoi caricare fino a 10.000 contatti per file CSV.
La dimensione massima del file è 20 MB.
Se il tuo file supera uno di questi limiti, suddividilo in file più piccoli e caricali separatamente.

Posso caricare più indirizzi email o numeri di telefono per contatto?

No, attualmente ogni contatto supporta solo un'email primaria e un numero di telefono primario durante l'importazione. Tuttavia, puoi aggiungere manualmente email e numeri di telefono aggiuntivi nella barra laterale del contatto all'interno della Inbox unificata o del Contact Hub.

Cosa succede ai contatti già caricati se li importo di nuovo?

Quando importi un contatto che esiste già in Superchat, lo identifichiamo utilizzando l'indirizzo email e/o il numero di telefono e lo aggiorniamo secondo queste regole:

Se il contatto esistente non ha un valore per un campo → viene aggiunto il valore importato.
Se il contatto esistente ha un valore diverso → il valore importato sovrascrive quello vecchio.
Se il contatto esistente ha già un valore e l'importazione non ne ha → non cambiamo nulla (il valore esistente rimane).

Come posso aggiornare i contatti utilizzando l'importazione dei contatti?

Puoi aggiornare in massa i contatti reimportandoli con dati aggiornati.

Includi l'email o il numero di telefono di ogni contatto (per il matching).
Eventuali attributi nuovi o modificati verranno aggiornati automaticamente secondo queste regole:
- I valori mancanti vengono aggiunti,
- I valori diversi sovrascrivono quelli vecchi,
- I valori vuoti nell'importazione non rimuovono i dati esistenti.

Come importare i contatti in Superchat