
# Organizzare elenchi e contatti

Le liste raggruppano i tuoi contatti in modo da poter inviare i messaggi giusti alle persone giuste: una lista "Nuovi lead", una lista "Clienti VIP", una lista "Iscritti alla newsletter" e così via.

Questa guida spiega come trovare e gestire le tue liste, consultare i contatti al loro interno, modificare un contatto e gestire i contatti in blocco dalla tabella principale.


---

## Dove trovare i tuoi elenchi

Entrambe si trovano all'interno della stessa area **Contatti**, accessibile tramite le due schede nella parte superiore della pagina:

- **Scheda Contatti** — un selettore di liste compatto si trova sopra la tabella, insieme a un pulsante **+ Crea lista** sempre visibile accanto ad esso.
- **Scheda Liste** (fai clic su **Liste** accanto a **Contatti**) — una pagina dedicata per creare, rinominare, eliminare e consultare ogni lista, con un conteggio dei membri e un indicatore **"Alimenta N campagne/broadcast"** per riga.


### Il selettore di liste (scheda Contatti)

1. Nella barra laterale sinistra, fai clic su **Contatti**.
2. Sopra la tabella, fai clic sulla pillola del **selettore di liste**. Si aprirà un menu a discesa con tutte le liste, ognuna delle quali mostra il proprio nome e il numero di contatti. Selezionane una per filtrare la tabella solo per quella lista, oppure seleziona **Tutti i contatti** per rimuovere il filtro.
3. Una volta selezionata una lista, fai nuovamente clic sul suo menu a discesa per visualizzare **Modifica lista**, **Copia ID lista**, **Elimina lista** ed **Elimina lista e contatti**: le stesse azioni descritte di seguito, senza dover lasciare la pagina Contatti.


Accanto al selettore si trova un pulsante **+ Crea lista** sempre disponibile: non è necessario selezionare nulla prima.

### La pagina Liste

Fai clic sulla scheda **Liste** accanto a **Contatti**. Ogni lista appare come una riga con il suo nome, il numero di membri e l'indicatore **"Alimenta N campagne/broadcast"**, che indica quanti broadcast o campagne attivi inviano automaticamente messaggi a chiunque si aggiunga a quella lista (vedi [Aggiunta di contatti a una lista](#adding-contacts-to-a-list) per capire perché è importante).


Apri il **menu della riga** ("⋯") di una lista per visualizzarne le azioni:

| Opzione | Cosa fa |
|---|---|
| **Modifica lista** | Rinomina la lista e ti permette di cambiare i contatti in essa contenuti. |
| **Copia ID lista** | Copia l'ID interno della lista negli appunti (utile per API o webhook). |
| **Elimina lista** | Elimina la lista stessa ma **mantiene tutti i contatti** nel tuo account: vengono semplicemente rimossi da questa lista. |
| **Elimina lista e contatti** | Elimina la lista **e rimuove permanentemente tutti i contatti** in essa contenuti. Questa operazione non può essere annullata. |

Le due opzioni di eliminazione sono contrassegnate in rosso e ognuna richiede una conferma: l'eliminazione di una lista e l'eliminazione dei contatti di una lista sono sempre due passaggi separati di "sei sicuro?", in modo da non poter eliminare accidentalmente i contatti di una lista quando intendevi solo rimuovere la lista stessa.

> **Se un elenco è utilizzato da una trasmissione**, non è ancora possibile eliminarlo: la finestra di dialogo indica il nome di tale trasmissione. Apri la pagina **Trasmissioni** per scollegarlo da lì, eliminando la trasmissione o assegnandogli un elenco diverso, quindi torna indietro e riprova.

---

## Creare un nuovo elenco

Dal selettore di liste (scheda Contatti) o dal pulsante **+ Nuova lista** nella parte superiore della pagina Liste:

1. Fai clic su **+ Crea lista** / **+ Nuova lista**.
2. Sotto **Tipo di lista**, lascia selezionato **Lista statica**: è una lista normale, in cui scegli tu stesso i contatti. (La **Lista smart** si riempie automaticamente in base a delle regole; vedi [Liste smart](#smart-lists-auto-updating) qui sotto.)
3. Digita un nome (ad esempio, `Summer Sale Contacts`).
4. *(Opzionale)* Aggiungi subito i contatti se la finestra di dialogo lo consente.
5. Fai clic su **Crea lista**.


Il nuovo elenco appare immediatamente sia nel selettore che nella pagina Elenchi.

> **Se Crea elenco non è presente:** il tuo account non ha l'autorizzazione per modificare i contatti. Chiedi al proprietario dell'account di aggiornare il tuo ruolo nel team.

---

## Liste smart (aggiornamento automatico)

Una **lista smart** è una lista che non devi compilare manualmente. Imposti le regole una volta sola — "ha il tag `hot-lead` ed è stato attivo negli ultimi 90 giorni" — e la lista si mantiene aggiornata da sola: le persone che soddisfano i criteri vengono aggiunte, quelle che smettono di soddisfarli vengono rimosse, senza che tu debba fare nulla.

Una lista normale (**statica**) è l'opposto: chiunque vi inserisca rimane nella lista finché non lo rimuovi. Entrambi i tipi funzionano allo stesso modo in tutto il resto del sistema: puoi inviare un broadcast a una lista smart, filtrare la tabella Contatti in base ad essa ed esportarla, esattamente come qualsiasi altra lista.

### Creazione di una lista smart

1. Nella scheda **Liste**, fai clic su **+ Nuova lista**.
2. Sotto **Tipo di lista**, scegli **Lista smart**.
3. Assegna un nome (ad esempio, `Hot leads (active)`).
4. Sotto **Regole**, seleziona **Corrisponde a: Tutte le regole** o **Qualsiasi regola** (vedi sotto), quindi crea la tua prima regola: scegli cosa controllare, come confrontarlo e il valore.
5. Fai clic su **+ Aggiungi regola** per ogni condizione aggiuntiva. Una lista smart può utilizzare fino a 20 regole.
6. Osserva la riga sotto le regole: conta i contatti che corrispondono attualmente ("≈ 3 contatti corrispondono") e ne elenca alcuni, così puoi verificare prima di salvare se le regole catturano ciò che intendevi.
7. Fai clic su **Crea lista**.


La lista viene popolata nel momento in cui la crei, quindi si apre con i suoi membri già presenti.

### Corrisponde a tutte le regole vs. Qualsiasi regola

- **Tutte le regole** — un contatto è nella lista solo quando *ogni* regola è vera. Usalo per restringere il campo ("taggato `hot-lead` **e** attivo negli ultimi 90 giorni").
- **Qualsiasi regola** — un contatto è nella lista quando *almeno una* regola è vera. Usalo per raggruppare ("taggato `newsletter` **o** taggato `webinar`").

### Su cosa puoi basare le regole

| Gruppo | Cosa puoi controllare |
|---|---|
| **Chi sono** | **Tag** (ne ha almeno uno / li ha tutti / non ne ha nessuno), **Elenchi** (è presente / non è presente — solo elenchi normali), **Canale** (WhatsApp, SMS, Instagram, ecc.), **Stato** |
| **Cosa hanno fatto** | **Aggiunto il**, **Ultima attività**, **Ultimo messaggio ricevuto**, **Ultimo messaggio inviato**, **Prima conversazione AI**, **Ultima conversazione AI** — ognuno come "nelle ultime N ore/giorni", "non nelle ultime N ore/giorni" (che include anche chi non l'ha mai fatto), prima o dopo una data specifica — con un'ora del giorno opzionale e un pulsante **Ora** che inserisce il momento attuale (utile per catturare solo i contatti aggiunti da ora in poi, ad esempio subito prima di una grande importazione), o semplicemente compilato / vuoto. Inoltre **Ha parlato con l'AI**, impostato su Attivo o Disattivo |
| **Impostazioni** | **Risposte AI** attive o disattive, **Non disturbare**, **Contatto privato**, **Ha mai risposto** |
| **Le loro trattative** | **Fase della trattativa** — ha una [trattativa](../deals/sales-pipeline.md) in una (o nessuna) delle fasi della pipeline che selezioni, o semplicemente **ha una trattativa** / **non ha alcuna trattativa** |
| **Dettagli** | **Email**, **Numero di telefono**, **Nome**, **Cognome** — compilato, vuoto, contiene o non contiene del testo; **Campagna assegnata** e **Collaboratore assegnato**; e uno qualsiasi dei tuoi **Campi personalizzati** per nome |

Maiuscole e minuscole non contano mai in un confronto di testo, e una regola che richiede qualcosa "non negli ultimi 30 giorni" corrisponde anche ai contatti a cui l'evento non è mai accaduto.

#### Contatti gestiti effettivamente dalla tua AI

**Ha parlato con l'AI** è impostato su sì per ogni contatto a cui la tua AI ha inviato almeno un messaggio, e su no per tutti gli altri — incluse le persone a cui ha risposto solo il tuo team. Viene impostato la prima volta che l'AI scrive a qualcuno e non cambia più in seguito, anche se successivamente disattivi le risposte AI per quel contatto o lo sposti in un'altra campagna.

Se hai bisogno dei contatti gestiti dalla tua AI **in un periodo particolare** — il motivo principale per cui le agenzie lo richiedono — usa invece **Ultima conversazione AI** con "negli ultimi 30 giorni". Si tratta di una finestra mobile che riflette sempre l'ultimo mese.

Due regole che spesso vengono confuse con questa:

- **Risposte AI** (sotto Impostazioni) è un interruttore: indica che l'AI è *autorizzata* a rispondere a questo contatto, non che l'abbia mai fatto.
- **Ha mai risposto** riguarda il *contatto* che scrive — a chiunque, incluso il tuo team.

Puoi anche filtrare la tabella dei Contatti allo stesso modo senza creare un elenco: apri **Filtro** e imposta **Ha parlato con l'IA** su Attivo, oppure fai clic sulla chip rapida **Ha parlato con l'IA** sopra la tabella. Lo stesso filtro è presente nella [pagina Chat](../chats/chat-interface.md#chat-filters) come chip **Ha parlato con l'IA**, per quando desideri le conversazioni anziché le schede dei contatti.



### Riconoscere una lista smart

Nella pagina Liste, una lista smart presenta un badge **Smart**, un riepilogo in linguaggio semplice delle sue regole sotto il nome e l'indicazione di quando è stata aggiornata l'ultima volta ("Aggiornato 4 minuti fa"). Il conteggio dei membri è il conteggio in tempo reale.


### Quando si aggiorna una Smart List

- **Immediatamente quando un contatto cambia.** Aggiungi un tag a qualcuno, cambia il suo stato, compila un campo personalizzato: se questo lo rende conforme (o non più conforme), la lista si aggiorna entro pochi secondi. Anche spostare una trattativa in un'altra fase della pipeline conta: una regola sulla **Fase della trattativa** reagisce nel momento in cui la bacheca cambia.
- **Ogni 15 minuti per le regole basate sul tempo.** Regole come "nessuna attività negli ultimi 30 giorni" diventano vere col passare del tempo, senza che nessuno tocchi il contatto, quindi ogni smart list viene ricontrollata anche con un ciclo di un quarto d'ora.
- **Su richiesta.** Apri il menu **⋯** della lista e clicca su **Aggiorna ora** per rieseguire immediatamente le regole; il conteggio dei membri della riga e la riga "Aggiornato…" si allineeranno subito.

### Non è possibile aggiungere o rimuovere persone manualmente

Questo è il senso di una smart list: i suoi membri vengono determinati dalle regole, quindi qualsiasi operazione manuale verrebbe annullata al controllo successivo. In pratica:

- La lista espansa non ha il pulsante **Aggiungi contatti** né l'opzione **Rimuovi** su un membro; al suo posto appare la scritta *"I membri sono calcolati in base alle regole di questa lista"*.
- Le smart list non compaiono nell'azione collettiva **Lista** nella pagina Contatti, nel selettore di liste di un contatto o come destinazione di un'importazione.

Per modificare chi è presente nella lista, apri il suo menu **⋯** e fai clic su **Modifica regole**.

### Smart List e Broadcast

Un broadcast può avere come target una smart list come qualsiasi altra lista, ed è qui che risultano più utili: puntane uno su "tag `hot-lead`, nessuna risposta in 7 giorni" e il pubblico si gestirà da solo.

> **Attenzione: questo può inviare messaggi autonomamente.** Se un broadcast o una campagna attiva su quella lista ha l'opzione **Invia ai nuovi membri della lista** attivata, ogni contatto che soddisfa le tue regole riceverà automaticamente il messaggio di apertura. È proprio questo il senso di abbinarli, ma significa che le persone possono ricevere messaggi senza che tu debba cliccare nulla, e ogni messaggio utilizza dei crediti. Controlla cosa alimenta una lista (la colonna **Feed** nella pagina Liste) prima di ampliare le sue regole.

---

## Navigazione e ricerca dei membri della lista

Nella pagina Elenchi, fai clic sulla riga di un elenco per espanderlo e vedere tutti i membri, con una casella di ricerca per trovare qualcuno per nome, telefono o email. Da lì puoi **rimuovere un singolo contatto dall'elenco**: questo lo rimuove solo dall'elenco, non elimina il contatto né influisce sugli altri suoi elenchi.

In una [smart list](#smart-lists-auto-updating) lo stesso pannello è di sola lettura: puoi sfogliare e cercare i suoi membri, ma non c'è l'opzione Rimuovi, poiché i membri derivano dalle sue regole.

---

## Aggiunta di contatti a una lista

Aggiungi contatti a una lista dalla vista lista espansa, dal pannello di visualizzazione rapida o dalla scheda completa di un contatto, oppure con l'azione collettiva **Aggiungi alla lista** qui sotto. Le [smart list](#smart-lists-auto-updating) non sono disponibili in nessuno di questi punti: si riempiono automaticamente in base alle loro regole.

> **Attenzione: aggiungere qualcuno a una lista può inviare un messaggio.** Se una trasmissione in diretta su quella lista ha l'opzione **Invia ai nuovi membri della lista** attivata, l'aggiunta di un contatto invia immediatamente il messaggio di apertura, utilizza crediti e inoltra le risposte all'agente di quella trasmissione.
>
> Visualizzerai un avviso prima che ciò accada. Indipendentemente dal modo in cui aggiungi qualcuno — l'azione massiva **Aggiungi alla lista**, la schermata **Aggiungi membri** di una lista o gli interruttori della lista su un contatto — la schermata ti indica quale trasmissione verrà inviata e ti chiede di confermare. Rimuovere qualcuno da una lista non invia mai nulla, quindi l'operazione rimane istantanea.
>
> Se **più di una** trasmissione in diretta sulla stessa lista ha l'interruttore attivato, il nuovo contatto riceve **un messaggio di apertura da ciascuna di esse**, addebitato separatamente. L'avviso indica quante. Puoi impedirlo dal passaggio Pubblico della trasmissione — vedi [Trasmissioni](../broadcasts/broadcasts.md).

---

## Modifica di un contatto

1. Nella tabella Contatti, fai clic in un punto qualsiasi della **riga** del contatto per aprire il [pannello di visualizzazione rapida](creating-contacts.md).
2. Fai clic su **Modifica**.
3. Aggiorna nome, numero di telefono, email, canale, tag o Note.
4. Fai clic su **Salva**.

> **Clic sulla riga rispetto al nome.** Cliccare su una riga apre il pannello di visualizzazione rapida. Cliccare sul **nome** del contatto apre invece una chat con lui: vedi [Aggiungere un nuovo contatto](creating-contacts.md).

L'appartenenza all'elenco si modifica dalla sezione **Elenchi** del pannello di visualizzazione rapida, non dal modulo di modifica stesso: fai clic sul **+** accanto a **Elenchi** nel pannello e seleziona o deseleziona gli elenchi.

---

## Azioni in blocco (Selezionare molti contatti contemporaneamente)

1. Spunta la casella all'inizio della riga di un contatto. Spuntane quante ne vuoi, oppure usa la casella di controllo nell'intestazione per selezionare tutti i contatti attualmente visualizzati. Con l'intera pagina selezionata, **appare una barra blu appena sopra le righe della tabella** che offre **Seleziona tutti gli N contatti che corrispondono ai tuoi filtri**: un clic estende la selezione a ogni corrispondenza, non solo alla pagina visibile, in modo che un'azione possa coprire migliaia di contatti contemporaneamente. Quella barra sceglie solo *chi* è selezionato; i pulsanti che *eseguono* qualcosa si trovano nella barra delle azioni in basso.
2. Una **barra delle azioni mobile appare nella parte inferiore dello schermo** con:
   - **Bot attivo / Bot disattivato** — attiva o disattiva il bot AI per ogni contatto selezionato.
   - **Privato / Rendi pubblico** — modifica la privacy.
   - **DND / Disabilita DND** — attiva o disattiva la modalità Non disturbare.
   - **Segna come spam / Rimuovi da spam**.
   - **Archivia / Estrai dall'archivio** — chiudi la chat di ogni contatto selezionato e spostala nell'archivio chat, oppure ripristinali tutti. È lo stesso archivio della pagina Chat: vedi [Chiusura di una conversazione](../chats/chat-interface.md#closing-a-conversation-when-youre-done).
   - **Assegna campagna** — instrada la selezione verso una campagna. **Solo account con campagne classiche**: vedi la nota qui sotto.
   - **Aggiungi all'elenco**.
   - **Tag** — applica un tag a ogni contatto selezionato.
   - **Tag automatico** — lascia che l'agente AI di ogni contatto legga l'intera conversazione e applichi le proprie regole di tag, oppure scegli le regole di un agente per tutti i contatti selezionati. Stesso prezzo del tagging in tempo reale: 1 credito per tag applicato, nulla per i contatti che non ricevono nuovi tag. Fino a 500 contatti per esecuzione. Vedi [Tagging di una conversazione su richiesta](../get-started/creating-tags.md#tagging-a-conversation-on-demand).
   - **Automazione** — aggiungi la selezione a un'automazione. Appare solo se il tuo account dispone di Automazioni.
   - **Esporta** — scarica la selezione come file.
   - **Elimina** — elimina definitivamente ogni contatto selezionato.
3. Fai clic sull'azione desiderata. Le azioni distruttive (Elimina, Segna come spam) richiedono prima una conferma.

> **Non vedi il pulsante "Assegna campagna"? È normale per un account con Agenti AI.** Se il tuo menu mostra **Agenti AI** e non la voce **Campagne**, l'assegnazione dei contatti a una campagna non è più applicabile. Inserisci invece i contatti in una **lista**, quindi invia a tale lista tramite un [Broadcast](../broadcasts/broadcasts.md), oppure lascia che un [Punto di ingresso](../ai-agents/entry-points.md) assegni le nuove conversazioni all'Agente corretto. Mappatura completa dal vecchio al nuovo metodo: [Passare dalle Campagne ai Broadcast e agli Agenti](../moving-from-campaigns.md).

Fai clic sulla piccola **×** alla fine della barra, o deseleziona le caselle di controllo, per cancellare la selezione.

> **Non è la stessa cosa della pagina Chat.** In **Contatti**, la barra delle azioni collettive fluttua nella parte inferiore dello schermo. Nella pagina **Chat**, la barra equivalente si trova *sopra l'elenco delle chat*, all'interno della colonna dell'elenco, con la sua casella di controllo principale: vedi [Azioni collettive nella posta in arrivo](../chats/chat-interface.md#bulk-inbox-actions). Entrambe le pagine mostrano lo stesso tipo di striscia "seleziona tutti gli N" sopra le loro righe quando la pagina visibile è completamente selezionata.

> **Suggerimento: dividere i contatti in gruppi uguali.** Non esiste un pulsante automatico "dividi in elenchi da 50", ma la tabella stessa ti permette di farlo rapidamente: mostra esattamente **50 contatti per pagina** e la casella di controllo nell'intestazione seleziona l'intera pagina. Quindi, spunta la casella di controllo dell'intestazione, fai clic su **Aggiungi all'elenco**, premi **+ Nuovo elenco** nel popup e nominalo (ad esempio "Gruppo 1"): nel momento in cui crei l'elenco, i contatti selezionati verranno aggiunti automaticamente. Quindi passa alla pagina successiva e ripeti. Alcune centinaia di contatti vengono suddivisi in elenchi uguali da 50 in un paio di minuti, senza dover aggiungere i contatti uno per uno. Se ti servono dei gruppi solo per l'**invio** (non per l'organizzazione), puoi evitare del tutto gli elenchi: una [Campagna](../broadcasts/broadcasts.md) in **modalità Drip** elabora automaticamente un grande elenco in gruppi per te.

---

## Prossimi passi

- [Aggiungere un nuovo contatto](creating-contacts.md) — aggiungi i contatti uno alla volta, oltre a una panoramica completa della schermata Contatti.
- [Importare contatti da un file](importing-contacts.md) — carica un foglio di calcolo di contatti.
- [Esportare i tuoi contatti](exporting-contacts.md) — scarica i tuoi contatti in un file.
