Questo articolo ti aiuterà a formattare correttamente il file CSV prima di importarlo in GoHighLevel / Squadd. Seguendo questa guida, eviterai gli errori di importazione più comuni, risparmierai tempo e garantirai che i tuoi dati vengano trasferiti senza problemi nel CRM.
INDICE DEI CONTENUTI
- Vantaggi chiave della preparazione del file CSV
- Cos'è il formato CSV?
- Strutturare il file
- Elenco dei paesi supportati nelle importazioni CSV
- Fusi orari supportati
- Domande frequenti
- Articoli correlati
Vantaggi chiave della preparazione del file CSV
Prendersi il tempo necessario per formattare correttamente il file CSV prima dell'importazione garantisce che i dati dei contatti siano puliti, completi e mappati con precisione.
- Riduce il rischio di errori di importazione o fallimenti nel caricamento
- Aiuta GoHighLevel / Squadd a mappare automaticamente i campi durante l'importazione
- Consente la deduplicazione dei contatti e aggiornamenti accurati
- Supporta i campi personalizzati (Custom Fields) e la segmentazione avanzata
- Risparmia tempo evitando la pulizia dei dati dopo l'importazione
- Aumenta il tasso di successo nelle importazioni massive di contatti/opportunità
Cos'è il formato CSV?
CSV sta per "Comma-Separated Values" (valori separati da virgola). È un formato di file semplice utilizzato per memorizzare dati tabulari, come fogli di calcolo o database. Ogni riga in un file CSV rappresenta un singolo record, e i campi all'interno del record sono separati da virgole. È uno dei formati più diffusi per importare ed esportare dati tra sistemi diversi.
I file CSV hanno solitamente l'estensione
.csv.Puoi crearli o modificarli con strumenti come Excel, Google Sheets o Blocco note.
Assicurati che nel file sia presente un solo foglio per evitare problemi di importazione.
Esempio:
| Nome | Cognome | Telefono | |
|---|---|---|---|
| Jane | Doe | jane@example.com | +11234567890 |
| John | Smith | john@example.com | +10987654321 |
Strutturare il file
Per garantire una mappatura accurata dei dati, struttura il file CSV con intestazioni di colonna corrispondenti ai campi standard o personalizzati in GoHighLevel / Squadd.
1. Esempio di formato CSV
| Nome | Cognome | Telefono | Azienda | Tag | Stato | Data creazione | Telefono aggiuntivo | |
|---|---|---|---|---|---|---|---|---|
| John | Doe | john@example.com | +11234567890 | ABC Corp | VIP, Lead | Nuovo | 01/01/2024 | +17877123462 |
| Jane | Smith | jane@example.com | +15556667777 | XYZ Ltd | Cliente | Attivo | 02/02/2024 | +17877123464 |
Ogni riga rappresenta un singolo contatto o un'opportunità.
Ogni colonna rappresenta una proprietà distinta.
La riga di intestazione è obbligatoria per mappare correttamente i campi.
2. Campi obbligatori
Per creare o aggiornare un contatto è richiesto almeno uno dei seguenti campi:
Nome
Indirizzo email
Numero di telefono
Nota: Per l'aggiornamento dei contatti è richiesto un identificatore univoco (ID contatto, email o telefono) in base alle impostazioni di deduplicazione. Per le opportunità, includi l'ID opportunità se intendi aggiornarle. Senza di esso, verrà creata una nuova opportunità.
3. Formattazione dei campi
Segui queste regole di formattazione specifiche per evitare errori di importazione:
| Tipo di campo | Formati accettati / Note |
| Selettore data (Campi data) | MM/GG/AAAA, AAAA/MM/GG, MM-GG-AAAA, AAAA-MM-GG |
| Selezione multipla / Casella di controllo | Virgole: VIP, Lead, Punto e virgola: Gold; Silver, Punti: Sì. No❌ Barre = Non valido |
| Opzione singola (Menu a tendina) | Un solo valore. Esempio: Blu |
| Proprietario del contatto | Nome Cognome — es. Logan Paul |
| Tag | Virgole, punto e virgola o punti. es. Blu, Giallo, Blu; Giallo |
| Numero di telefono | E.164: +11234567890 (consigliato); anche 123-456-7890, (123) 456-7890 (solo USA) |
| Formati di telefono non validi | 1234567, abc1234567 |
| Campi numerici | 1.23, 1234, .123 |
| Campi monetari | 1234, 1,234,234.33 |
| Follower del contatto | Nome Cognome, Nome2 Cognome2 — es. Adam Smith, David Lee |
| Email aggiuntive | abc@email.com, abc1@email.com |
| Numeri di telefono aggiuntivi | +1 7877123460, +1 7877123461 |
4. Tipo di file e dimensione supportati
Il file deve soddisfare alcuni requisiti di base per un caricamento corretto.
| Requisito | Dettagli |
|---|---|
| Formato file | Solo .csv |
| Fogli consentiti | Un foglio per file |
| Dimensione massima | 30 MB |
5. Campi obbligatori e facoltativi per l'importazione
Includere i campi corretti aiuta GoHighLevel / Squadd a identificare ed elaborare i record con precisione.
| Azione di importazione | Campi obbligatori/facoltativi | Note |
| Nuovo contatto | Nome o Email, o Telefono | È richiesto almeno uno |
| Aggiornamento contatto esistente | ID contatto o Nome/Email/Telefono | Dipende dalle impostazioni di deduplicazione |
| Riga di intestazione | Obbligatoria | Le intestazioni devono corrispondere ai campi standard o personalizzati in GoHighLevel / Squadd |
6. Linee guida di formattazione per tipo di campo
Per evitare errori di importazione, segui queste regole di formattazione per ogni tipo di dato nel file CSV.
| Tipo di campo | Formato | Esempio | Note |
| Numero di telefono | E.164 o formati USA standard | +1 1234567890123-456-7890 | Formattazione pulita e coerente |
| Indirizzo email | Formato standard | nome@esempio.com | Deve contenere @ e il dominio |
| Data | Più formati accettati | 04/16/2025, 2025-04-16 | Scegli un formato e mantienilo per tutto il file |
| Campi a selezione multipla | Separati da ,, ; o . | Blu, Giallo, Verde | Deve corrispondere alle opzioni del campo nel CRM |
| Email aggiuntive | Separate da virgola | email1@example.com, email2@example.com | Aggiungi in una colonna separata |
| Telefoni aggiuntivi | Separati da virgola | 1234567890, 9876543210 | Aggiungi in una colonna separata |
Suggerimento: Prima di importare il CSV, assicurati che i campi personalizzati siano già stati creati nel tuo account GoHighLevel / Squadd con le stesse etichette e tipi di dato. Per assistenza nella creazione dei campi personalizzati, consulta Panoramica dei campi di unione e variabili personalizzate
Elenco dei paesi supportati nelle importazioni CSV
Questa sezione contiene una tabella con i nomi dei paesi accettati durante le importazioni CSV in GoHighLevel / Squadd. Si tratta dei valori ufficiali da utilizzare nel file CSV quando si mappa un campo paese, standard o personalizzato. Utilizza nel file CSV esattamente i nomi o i codici brevi elencati di seguito.
Scopo: GoHighLevel / Squadd convalida i nomi dei paesi durante l'importazione. Se il CSV include un campo
Country, ogni riga deve corrispondere a uno dei nomi esatti presenti in questo elenco.Formato: Deve corrispondere esattamente — rispettando maiuscole/minuscole e ortografia. Ad esempio,
United Statesè accettato, maUSAoU.S.causeranno un errore.Uso con campi personalizzati: Se utilizzi un campo paese personalizzato, ti consigliamo comunque di attenerti a questo elenco per garantire la compatibilità.
| Nome paese (Codice) | Nome paese (Codice) | Nome paese (Codice) |
| Afghanistan (AF) | Albania (AL) | Algeria (DZ) |
| Andorra (AD) | Angola (AO) | Antigua and Barbuda (AG) |
| Argentina (AR) | Armenia (AM) | Australia (AU) |
| Austria (AT) | Azerbaijan (AZ) | Bahamas (BS) |
| Bahrain (BH) | Bangladesh (BD) | Barbados (BB) |
| Belarus (BY) | Belgium (BE) | Belize (BZ) |
| Benin (BJ) | Bhutan (BT) | Bolivia (BO) |
| Bosnia and Herzegovina (BA) | Botswana (BW) | Brazil (BR) |
| Brunei (BN) | Bulgaria (BG) | Burkina Faso (BF) |
| Burundi (BI) | Cabo Verde (CV) | Cambodia (KH) |
| Cameroon (CM) | Canada (CA) | Central African Republic (CF) |
| Chad (TD) | Chile (CL) | China (CN) |
| Colombia (CO) | Comoros (KM) | Congo (CG) |
| Congo (Kinshasa) (CD) | Costa Rica (CR) | Croatia (HR) |
| Cuba (CU) | Cyprus (CY) | Czech Republic (CZ) |
| Denmark (DK) | Djibouti (DJ) | Dominica (DM) |
| Dominican Republic (DO) | East Timor (TL) | Ecuador (EC) |
| Egypt (EG) | El Salvador (SV) | Equatorial Guinea (GQ) |
| Eritrea (ER) | Estonia (EE) | Eswatini (SZ) |
| Ethiopia (ET) | Fiji (FJ) | Finland (FI) |
| France (FR) | Gabon (GA) | Gambia (GM) |
| Georgia (GE) | Germany (DE) | Ghana (GH) |
| Greece (GR) | Grenada (GD) | Guatemala (GT) |
| Guinea (GN) | Guinea-Bissau (GW) | Guyana (GY) |
| Haiti (HT) | Honduras (HN) | Hungary (HU) |
| Iceland (IS) | India (IN) | Indonesia (ID) |
| Iran (IR) | Iraq (IQ) | Ireland (IE) |
| Israel (IL) | Italy (IT) | Jamaica (JM) |
| Japan (JP) | Jordan (JO) | Kazakhstan (KZ) |
| Kenya (KE) | Kiribati (KI) | Korea, North (KP) |
| Korea, South (KR) | Kosovo (XK) | Kuwait (KW) |
| Kyrgyzstan (KG) | Laos (LA) | Latvia (LV) |
| Lebanon (LB) | Lesotho (LS) | Liberia (LR) |
| Libya (LY) | Liechtenstein (LI) | Lithuania (LT) |
| Luxembourg (LU) | Madagascar (MG) | Malawi (MW) |
| Malaysia (MY) | Maldives (MV) | Mali (ML) |
| Malta (MT) | Marshall Islands (MH) | Mauritania (MR) |
| Mauritius (MU) | Mexico (MX) | Micronesia (FM) |
| Moldova (MD) | Monaco (MC) | Mongolia (MN) |
| Montenegro (ME) | Morocco (MA) | Mozambique (MZ) |
| Myanmar (MM) | Namibia (NA) | Nauru (NR) |
| Nepal (NP) | Netherlands (NL) | New Zealand (NZ) |
| Nicaragua (NI) | Niger (NE) | Nigeria (NG) |
| North Macedonia (MK) | Norway (NO) | Oman (OM) |
| Pakistan (PK) | Palau (PW) | Panama (PA) |
| Papua New Guinea (PG) | Paraguay (PY) | Peru (PE) |
| Philippines (PH) | Poland (PL) | Portugal (PT) |
| Qatar (QA) | Romania (RO) | Russia (RU) |
| Rwanda (RW) | Saint Kitts and Nevis (KN) | Saint Lucia (LC) |
| Saint Vincent and the Grenadines (VC) | Samoa (WS) | San Marino (SM) |
| Sao Tome and Principe (ST) | Saudi Arabia (SA) | Senegal (SN) |
| Serbia (RS) | Seychelles (SC) | Sierra Leone (SL) |
| Singapore (SG) | Slovakia (SK) | Slovenia (SI) |
| Solomon Islands (SB) | Somalia (SO) | South Africa (ZA) |
| South Sudan (SS) | Spain (ES) | Sri Lanka (LK) |
| Sudan (SD) | Suriname (SR) | Sweden (SE) |
| Switzerland (CH) | Syria (SY) | Taiwan (TW) |
| Tajikistan (TJ) | Tanzania (TZ) | Thailand (TH) |
| Togo (TG) | Tonga (TO) | Trinidad and Tobago (TT) |
| Tunisia (TN) | Turkey (TR) | Turkmenistan (TM) |
| Tuvalu (TV) | Uganda (UG) | Ukraine (UA) |
| United Arab Emirates (AE) | United Kingdom (GB) | United States (US) |
| Uruguay (UY) | Uzbekistan (UZ) | Vanuatu (VU) |
| Vatican City (VA) | Venezuela (VE) | Vietnam (VN) |
| Yemen (YE) | Zambia (ZM) | Zimbabwe (ZW) |
Fusi orari supportati
Utilizza uno dei seguenti formati di fuso orario nel CSV. Sono sensibili alle maiuscole/minuscole e devono corrispondere esattamente.
| Fuso orario | Fuso orario | Fuso orario |
| Etc/GMT+12 | Pacific/Midway | Pacific/Honolulu |
| America/Juneau | US/Alaska | America/Dawson |
| America/Los_Angeles | America/Phoenix | America/Tijuana |
| US/Arizona | America/Belize | America/Boise |
| America/Chihuahua | America/Denver | America/Edmonton |
| America/Guatemala | America/Managua | America/Regina |
| Canada/Saskatchewan | US/Mountain | America/Bahia_Banderas |
| America/Bogota | America/Cancun | America/Chicago |
| America/Mexico City | US/Central | America/Caracas |
| America/Detroit | America/Indiana/Indianapolis | America/Louisville |
| America/Manaus | America/New_York | America/Santiago |
| America/Santo_Domingo | America/Toronto | US/East-Indiana |
| US/Eastern | America/Argentina/Buenos_Aires | America/Glace_Bay |
| America/Montevideo | America/Sao_Paulo | Canada/Atlantic |
| America/St_Johns | Canada/Newfoundland | America/Godthab |
| America/Noronha | Etc/GMT+2 | Atlantic/Cape_Verde |
| Atlantic/Azores | UTC | Africa/Algiers |
| Africa/Casablanca | Africa/Lagos | Atlantic/Canary |
| Europe/London | Africa/Cairo | Africa/Harare |
| Europe/Amsterdam | Europe/Belgrade | Europe/Brussels |
| Europe/Madrid | Europe/Oslo | Europe/Sarajevo |
| Africa/Nairobi | Asia/Amman | Asia/Baghdad |
| Asia/Jerusalem | Asia/Kuwait | Asia/Qatar |
| Europe/Athens | Europe/Bucharest | Europe/Helsinki |
| Europe/Moscow | Asia/Baku | Asia/Dubai |
| Asia/Kabul | Asia/Tehran | Asia/Karachi |
| Asia/Yekaterinburg | Asia/Colombo | Asia/Kolkata |
| Asia/Calcutta | Asia/Kathmandu | Asia/Almaty |
| Asia/Dhaka | Asia/Rangoon | Asia/Bangkok |
| Asia/Krasnoyarsk | Asia/Irkutsk | Asia/Kuala_Lumpur |
| Asia/Shanghai | Asia/Taipei | Australia/Perth |
| Asia/Seoul | Asia/Tokyo | Asia/Yakutsk |
| Australia/Adelaide | Australia/Darwin | Asia/Vladivostok |
| Australia/Brisbane | Australia/Canberra | Australia/Hobart |
| Australia/Sydney | Pacific/Guam | Asia/Magadan |
| Pacific/Auckland | Pacific/Fiji | Pacific/Tongatapu |
Domande frequenti
D: Posso importare contatti con più di un numero di telefono o indirizzo email?
Sì! Utilizza colonne separate come Additional phone numbers e Additional email addresses, e separa le voci con le virgole.
D: Cosa succede se includo nel CSV un campo che non esiste in GoHighLevel / Squadd?
Quel campo verrà ignorato, a meno che tu non lo mappi su un campo standard o personalizzato esistente durante il processo di importazione.
D: GoHighLevel / Squadd rileva automaticamente i duplicati?
Sì, in base alle tue Impostazioni di rilevamento duplicati, può abbinare i record tramite ID contatto, telefono o email, e poi unire o ignorare i duplicati.
D: Posso aggiornare i contatti con un'importazione CSV?
Assolutamente sì. Assicurati solo di includere un campo utilizzato nella corrispondenza duplicati (come ID contatto, email o telefono).
D: Devo eliminare le righe e le colonne vuote?
Sì. È buona prassi rimuovere tutti i dati non necessari per evitare comportamenti imprevisti durante l'importazione.
Articoli correlati
- Importare le opportunità tramite file CSV
- Importare i contatti tramite file CSV