Come caricare un elenco di contatti WhatsApp
Per importare il consenso per WhatsApp, devi essere Proprietario, Amministratore o Manager.
Scopri come caricare su Klaviyo un file CSV degli iscritti a WhatsApp. Importare il consenso per WhatsApp è una parte fondamentale della migrazione tra provider e del consolidamento del tuo stack tecnologico di marketing. Dopo l'importazione in Klaviyo, puoi iniziare a inviare messaggi al tuo pubblico su WhatsApp in tutto il mondo.
Prima di iniziare
Ecco come importare un elenco di contatti WhatsApp che hanno espresso il consenso:
- Configura WhatsApp in Klaviyo.
- Imposta eventuali flussi di benvenuto in modalità manuale (quelli attivati dalla metrica Iscrizione al marketing via WhatsApp o Iscrizione ai messaggi transazionali via WhatsApp o dall'elenco in cui stai importando).
- Aspetta almeno due ore dall'importazione prima di riattivare nuovamente il flusso.
Perché devo prima configurare WhatsApp?
Se prima non configuri WhatsApp, l’importazione può aggiungere i profili e i relativi numeri di telefono, ma non aggiungerà il consenso per WhatsApp. che non verrebbe aggiunto neppure retroattivamente effettuando il collegamento a WhatsApp in un secondo momento.
Perché devo disattivare i flussi di benvenuto?
L'importazione dei contatti può attivare flussi di benvenuto pertinenti. Imposta i flussi di benvenuto in modalità manuale prima di importare per evitare che i messaggi vengano inviati automaticamente. I flussi di benvenuto comprendono i flussi attivati da:
- La metrica Iscrizione al marketing via WhatsApp o Iscrizione ai messaggi transazionali via WhatsApp
- L'elenco che stai caricando.
Inoltre, dovresti aspettare almeno due ore dal termine dell'importazione per riattivare nuovamente questi flussi.
Prepara il file CSV per l'importazione
Inserisci un numero di telefono come prima o seconda colonna
Klaviyo utilizza l'e-mail o il numero di telefono come identificatore unico di un profilo.
Durante l'importazione:
- Se hai un indirizzo e-mail per ciascuna persona, usa l'e-mail come prima colonna.
- Altrimenti, usa il numero di telefono come prima colonna.
Non ti serve una colonna separata per il paese quando ogni numero di telefono include un "+" e il prefisso internazionale, anche se importi il consenso per SMS e WhatsApp. Per ulteriori indicazioni, scopri come includere il paese dell’iscritto.
Formatta i numeri di telefono con un "+" e il prefisso internazionale
Inserisci ogni numero di telefono in formato internazionale: un segno più (+), poi il prefisso internazionale, poi il numero, senza spazi, trattini o parentesi.
I numeri senza il prefisso "+" potrebbero non essere importati correttamente.
Suggerimento: le app per fogli di calcolo come Excel e Google Sheets spesso rimuovono automaticamente il "+" iniziale, anche quando incolli un numero o apri un CSV esportato. Per mantenerlo:
- Formatta la colonna del numero di telefono come Testo prima di inserire o incollare i numeri.
- Oppure digita un apostrofo prima del numero (ad esempio, '+85212345678).
- Controlla di nuovo la colonna prima di salvare e caricare il CSV.
Prima di reimportare i numeri di telefono esportati da Klaviyo, verifica che ogni numero inizi ancora con "+". Aggiungilo solo se manca.
Facoltativo: indica se il consenso riguarda i messaggi WhatsApp di marketing o "utility"
Al momento puoi importare il consenso per i messaggi WhatsApp di marketing o "utility" (detti anche "transazionali" in Klaviyo).
Se il file CSV contiene messaggi di entrambi i tipi, puoi indicare la tipologia di consenso aggiungendo due colonne e le relative intestazioni:
- Consenso al marketing via WhatsApp
- Il consenso per i messaggi di marketing ti consente di inviare qualsiasi tipo di comunicazione su WhatsApp: sia promozionale (annunci di prodotti, promemoria per l'abbandono, ecc.) che transazionale.
- Consenso transazionale WhatsApp
- Il consenso transazionale di WhatsApp significa che puoi inviare solo messaggi utility approvati da Meta.
Facoltativo: aggiungi lo stato del consenso ("Iscrizione effettuata", "Iscrizione annullata", "Iscrizione mai effettuata")
Ti consigliamo di inserire lo stato del consenso se il tuo file CSV comprende una combinazione di:
- utenti che hanno effettuato l'iscrizione e utenti che hanno annullato l'iscrizione;
- utenti che si sono iscritti solo ai messaggi di marketing e utenti che si sono iscritti solo ai messaggi transazionali.
Sono disponibili tre stati del consenso:
- Iscriviti
La persona ha accettato di ricevere messaggi. - Iscrizione annullata
La persona era iscritta ma ha successivamente annullato l'iscrizione. L’importazione di questo valore registra un opt-out per il tipo di messaggio WhatsApp corrispondente. Il consenso per gli altri canali è separato (ad esempio, un opt-out SMS non esclude automaticamente una persona dall’e-mail). - Mai iscritto
La persona non ha mai acconsentito a quel tipo di messaggio. L’importazione di questo valore non aggiunge il consenso né rimuove eventuali consensi già memorizzati in Klaviyo.
Una cella del consenso vuota lascia invariato il consenso esistente, a meno che non venga compilato il timestamp del consenso corrispondente. Un timestamp senza un valore di consenso viene considerato come consenso a iscriviti.
Facoltativo: aggiungi data e ora del consenso
Sebbene si tratti di un'opzione facoltativa, di solito è buona prassi aggiungere la data e l'ora se disponibili. Per farlo, controlla che:
- Il timestamp è in un formato data/ora accettato, ad esempio 2026-01-15T14:30:00Z.
- la colonna sia nominata con una delle seguenti intestazioni:
- Data e ora del consenso al marketing via WhatsApp
- Timestamp del consenso transazionale di WhatsApp (per il consenso transazionale)
Se includi uno stato di consenso senza un timestamp, iscriviti può comunque aggiungere il consenso. Se ometti sia le colonne del consenso WhatsApp sia quelle del timestamp, conferma il consenso WhatsApp durante l’importazione.
Includi il timestamp originale del consenso quando è disponibile. Se la rinuncia del profilo è più recente di quel timestamp, il consenso non verrà aggiunto di nuovo. Iscrivi di nuovo solo chi ha acconsentito di nuovo dopo aver rinunciato, usando il nuovo timestamp del consenso.
Importa un elenco di numeri di telefono con il consenso per WhatsApp
- Vai su Pubblico > Elenchi e segmenti.

2. Seleziona l'elenco a cui vuoi aggiungere i contatti (ad esempio, WhatsApp iscritti).
3. Apri il menu a discesa Gestisci elenco in alto a destra.
4. Scegli Importa contatti dal menu a discesa.
- Devi essere Proprietario, Amministratore o Manager per usare questa opzione.

5. Clicca su Carica e seleziona il tuo file CSV con gli iscritti a WhatsApp.
6. Associa ogni colonna del tuo CSV alla proprietà Klaviyo appropriata, inclusi Numero di telefono e qualsiasi campo relativo al consenso WhatsApp o al timestamp. Assicurati che ogni numero di telefono inizi con "+" e il prefisso internazionale (vedi "Formatta i numeri di telefono con un '+' e il prefisso internazionale" sopra).
Le colonne di consenso e timestamp di WhatsApp mappate determinano il consenso di ogni profilo. Se mappi una di queste colonne, WhatsApp non verrà visualizzato nelle successive opzioni di consenso di massa.
- Esempio: se includi una colonna WhatsApp Transactional Consent (ma non una per il consenso di marketing).
- Iscriviti aggiunge il consenso alle comunicazioni transazionali via WhatsApp. Non aggiunge né rimuove il consenso al marketing.
- Annulla l’iscrizione registra una rinuncia transazionale. Mai iscritto lascia invariato il consenso esistente.
7. Se vedi Avanti, fai clic e completa la conferma del consenso qui sotto. Se vedi Importa, passa al passaggio 8.
- In I contatti hanno effettuato l’iscrizione alle comunicazioni?, seleziona Sì solo se hai il consenso da applicare a tutti i contatti importati per i canali selezionati. Per lasciare invariato il consenso per i canali non coperti dal tuo file CSV, seleziona No e vai direttamente al passaggio 8.

- Se hai selezionato Sì, scegli solo i canali a cui questi contatti hanno acconsentito. Seleziona E-mail o messaggio di testo solo se vuoi anche importare il consenso per questi canali.
- Se viene offerto WhatsApp, scegli i tipi di messaggi da applicare:
- Per il consenso solo transazionale, seleziona Messaggi transazionali e lascia deselezionati Messaggi di marketing.
- Per entrambi i tipi di consenso, seleziona Messaggi di marketing e Messaggi transazionali.
- Per il consenso solo per il marketing, seleziona Messaggi di marketing e lascia Messaggi transazionali non selezionato.
8. Quando è tutto pronto per proseguire, fai clic su Importa.
Il completamento del processo di importazione può richiedere fino a un paio d'ore.
Dopo aver completato l'importazione di tutti i numeri, Klaviyo creerà un nuovo profilo o assocerà i dati a un profilo esistente. Ad esempio, se importi un file CSV con solo numeri di telefono, Klaviyo cercherà i profili con lo stesso numero di telefono, aggiornerà il consenso WhatsApp di quel profilo in base ai valori del file CSV o ai tipi di consenso che hai selezionato e includerà eventuali altre Proprietà del profilo attribuite a quel contatto.