---
title: Import lead da CSV
description: Il wizard di importazione lead — mappatura delle colonne con status e owner, tag applicati in blocco, creazione automatica delle aziende, la deduplicazione a cascata e la lettura del report finale.
---

Da **Lead → Importa Lead** (o dalla ricerca: "Importa lead") importi lead
in massa da un file CSV o da un foglio Google. Serve il permesso di
creazione sui lead.

## Preparare il file

- Formato **CSV con separatore virgola**, prima riga di intestazioni
  (il link **"Scarica file CSV di esempio"** nel wizard mostra il formato
  atteso: Nome Completo, Numero Telefono, Email, ID Esterno, campi
  azienda, ecc.).
- L'unico campo **obbligatorio** è il **Nome Completo**; telefono, email e
  **ID Esterno** sono fortemente consigliati (guidano la deduplicazione).

## Il wizard

<Steps>
<Step>
**Carica il file** (trascina o seleziona). Il wizard legge intestazioni e
righe e passa alla mappatura.
</Step>
<Step>
**Mappa i campi lead**: per ogni campo scegli la colonna del file (accanto
vedi un valore campione). Se mappi **Status Lead**, la card **"Mappatura
Status"** associa ogni valore del file a una fase della tua pipeline, con
riconoscimento automatico dei valori comuni ("nuovo", "vinto", "perso",
"da richiamare"…) e l'anteprima della distribuzione — i valori non
riconosciuti finiscono su "Nuovo".
</Step>
<Step>
**Opzioni**: l'**Assegnazione Owner** (nessuno, tutti a un utente, o da
una colonna del file con mappatura); la card **"Tag"** per applicare uno o
più tag **a tutti** i lead importati (compare solo se hai già creato dei
tag in Impostazioni → Tag); **"Crea automaticamente le aziende"** con i
campi azienda; i **Parametri Custom** per salvare le colonne non mappate
sul lead.
</Step>
<Step>
**"Avvia Importazione"** e lascia la finestra aperta: la barra avanza riga
per riga con i contatori Successi/Errori. Alla fine il report mostra
**Lead importati / Errori / Totale righe**, con l'elenco degli errori per
riga ("Riga N: motivo").
</Step>
</Steps>

## Come vengono gestiti i duplicati

L'import **non crea mai doppioni**: per ogni riga cerca un lead esistente
in quest'ordine — **ID Esterno → telefono (normalizzato) → email** — e se
lo trova lo **aggiorna** invece di crearne uno nuovo. Regole prudenti:

- l'**owner** viene assegnato solo ai lead che non ne hanno già uno;
- l'ID Esterno viene scritto solo se il lead non ne aveva;
- i **tag** scelti vengono applicati anche ai lead aggiornati;
- un telefono già appartenente a un **altro** lead genera un errore di
  riga (la riga viene scartata, l'import prosegue).

<Callout type="info">
  Nel report, i lead **aggiornati contano come "importati"**: il numero di
  successi non coincide con il numero di lead *nuovi*. I lead creati
  hanno origine **Import** e possono attivare il trigger workflow "Nuovo
  Lead Creato" (filtrabile proprio sulla fonte Import).
</Callout>

## Verificare (ed esportare)

Dopo l'import, dalla lista **Lead** filtra per il **tag** applicato: il
conteggio deve tornare. Il pulsante **"Esporta"** (CSV o Excel) esporta
sempre il risultato dei **filtri correnti** — utile anche per estrarre il
sottoinsieme appena importato.

## Prossimi passi

<Cards>
  <Card
    href="/docs/sorgenti-dati"
    title="Sorgenti dati"
    description="Le importazioni automatiche e ricorrenti da API esterne."
  />
  <Card
    href="/docs/workflow/trigger"
    title="Trigger workflow"
    description="Automazioni sui nuovi lead, filtrabili per fonte Import."
  />
</Cards>