# Clienti

La sezione Gestione clienti è l'area di Aurora in cui puoi raccogliere, organizzare e consultare le persone con cui la piattaforma dovrà interagire. In un flusso operativo basato su chiamate inbound e outbound, questa sezione ha l'obiettivo di costruire e mantenere ordinata la base dei contatti su cui lavorare.

In termini pratici, i clienti rappresentano i contatti che possono essere coinvolti in campagne, richiamati nel tempo, analizzati in base allo storico delle interazioni e consultati in modo più strutturato. Per questo motivo, la sezione non va letta come una semplice rubrica, ma come un punto di organizzazione operativo all'interno della piattaforma.

### A cosa serve la lista clienti

La pagina principale dei clienti ti offre una vista ordinata dell'elenco dei contatti già registrati in Aurora. È la schermata da cui normalmente si parte per cercare una persona, controllarne lo stato, selezionare più record insieme oppure avviare operazioni rapide come l'aggiunta a una campagna.

<figure><img src="/files/nFROOQ8GQ4IYJX4FQV3H" alt=""><figcaption></figcaption></figure>

Questa pagina è particolarmente utile quando il numero di contatti inizia a crescere e hai bisogno di una base dati chiara, filtrabile e facilmente leggibile.

***

### Cosa puoi fare nella pagina clienti

Nella schermata principale puoi:

* visualizzare l'elenco dei clienti registrati
* filtrare e cercare i record
* usare filtri rapidi
* creare manualmente un nuovo cliente
* importare clienti da file CSV o XLSX
* selezionare uno o più clienti
* aggiungere clienti a una campagna
* eliminare uno o più clienti
* aprire il dettaglio di un cliente

### Creazione manuale di un cliente

Se devi inserire un cliente manualmente, puoi usare il comando dedicato alla creazione di un nuovo record.

<figure><img src="/files/lhzOsTXVQTMvlYs14ffC" alt=""><figcaption></figcaption></figure>

La creazione manuale è utile soprattutto quando:

* devi aggiungere pochi contatti
* vuoi registrare un cliente singolo in modo immediato
* stai completando un database già esistente

#### Campi principali del cliente

Nel form di creazione trovi questi campi:

<figure><img src="/files/mZSL7pMo9jo0cJmOJm6m" alt=""><figcaption></figcaption></figure>

**Customer ID**

È un campo obbligatorio, ma è importante chiarire bene il suo significato. Il `Customer ID` che inserisci non corrisponde all'identificativo tecnico interno con cui Aurora registra il cliente nel proprio sistema. Si tratta invece di un codice assegnato da te o dalla tua organizzazione, utile per mantenere un riferimento coerente con i tuoi processi, con il tuo CRM o con altri archivi esterni.

**Nome**

È il nome del cliente ed è obbligatorio. Serve a identificare il contatto in modo leggibile nella piattaforma.

**Cognome**

È obbligatorio e completa l'identificazione anagrafica del cliente.

**Email**

È un campo obbligatorio. Viene normalizzato in minuscolo e deve essere inserito in un formato valido. È utile sia per la consultazione sia per eventuali attività di contatto o riconciliazione dei dati.

**Telefono**

È un campo obbligatorio. Nel form può essere già suggerito un prefisso iniziale, ma l'utente può modificarlo liberamente. È importante verificare che il numero sia corretto, perché il telefono è uno degli elementi più rilevanti nelle attività operative di Aurora.

**Stato**

Il campo stato permette di classificare il cliente all'interno del flusso di lavoro. Puoi usare questi valori:

* `nuovo`
* `contatta`
* `qualificato`
* `convertito`

Questo ti aiuta a capire rapidamente in quale fase si trova il contatto.

***

### Importazione clienti da file

Se devi caricare molti clienti insieme, Aurora mette a disposizione una funzione di importazione.

<figure><img src="/files/7e4L70Kckamtwql495Cy" alt=""><figcaption></figcaption></figure>

Questa modalità è particolarmente utile quando:

* hai già una lista clienti in un file
* devi inizializzare rapidamente il database
* devi aggiornare o integrare contatti esistenti

Durante questa operazione, Aurora mette anche a disposizione un fac simile scaricabile. Questo file di esempio è particolarmente utile perché mostra in modo pratico quali campi inserire e con quale struttura preparare il documento da importare. Se devi caricare una nuova lista clienti o vuoi evitare errori di formattazione, è consigliabile partire proprio da questo modello, compilarlo con i tuoi dati e poi procedere con l'importazione.

<figure><img src="/files/LKsiI0ZSBIOB1lKWO3zS" alt=""><figcaption></figcaption></figure>

La piattaforma accetta file:

* CSV
* XLSX

Durante l'importazione, Aurora controlla il contenuto del file e restituisce un riepilogo con:

* totale dei record letti
* record creati
* record aggiornati
* record saltati
* eventuali errori riga per riga

Questo è un aspetto importante, perché permette di capire subito se il file è stato acquisito correttamente oppure se ci sono dati da correggere.

***

### Filtri e ricerca

La pagina clienti è pensata anche per la consultazione operativa quotidiana. Per questo mette a disposizione strumenti di filtro e ricerca che ti permettono di restringere l'elenco e trovare rapidamente i contatti rilevanti.

In pratica, i filtri sono utili quando:

* devi lavorare solo su un certo stato cliente
* vuoi trovare un contatto specifico
* vuoi isolare un gruppo di record prima di eseguire un'azione

Accanto ai filtri principali, la piattaforma può mostrare anche filtri rapidi, utili per passare velocemente da una vista generale a un insieme più mirato di clienti.

***

### Selezione multipla e operazioni di gruppo

Una delle funzionalità più utili della sezione clienti è la possibilità di selezionare più record contemporaneamente.

Questa funzione è utile soprattutto quando devi:

* aggiungere molti clienti a una campagna
* eliminare più record insieme

Quando selezioni uno o più clienti, Aurora mostra una barra di azioni dedicate. In questo modo non devi lavorare cliente per cliente, ma puoi gestire gruppi di contatti in modo più efficiente.

### Aggiungere clienti a una campagna

Dal punto di vista operativo, una delle azioni più importanti è l'inserimento dei clienti in una campagna.

<figure><img src="/files/Uztf4A03wW7zutq85DLM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/dCZftlD567gM8wJPHRvy" alt=""><figcaption></figcaption></figure>

Questa operazione può essere fatta:

* su un singolo cliente
* su un gruppo di clienti selezionati

<figure><img src="/files/VprLB073aQJJgNnz5cbs" alt=""><figcaption></figcaption></figure>

Quando attivi questa funzione, Aurora ti propone la scelta della campagna di destinazione. In genere vengono mostrate le campagne ancora attive o comunque utilizzabili. Una volta confermata la selezione, i clienti vengono aggiunti alla campagna e la piattaforma ti restituisce un riscontro sull'esito dell'operazione.

<figure><img src="/files/kYmT0AtwGAjLU0dJEcMW" alt=""><figcaption></figcaption></figure>

Questa funzione è particolarmente importante perché collega direttamente il database clienti alle attività outbound della piattaforma.

### Eliminazione dei clienti

La sezione clienti permette anche di eliminare record singoli o multipli.

<figure><img src="/files/6SUomVSzdxNErsEtMEoA" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/p5SWGcpVTkPtVYknh1IP" alt=""><figcaption></figcaption></figure>

Prima dell'eliminazione, la piattaforma chiede una conferma. Questo passaggio è importante perché evita cancellazioni accidentali, soprattutto quando si lavora in selezione multipla.

<figure><img src="/files/yEH9Zrunm4j5i8T8UYiV" alt=""><figcaption></figcaption></figure>

Dal punto di vista operativo, conviene usare l'eliminazione con attenzione, in particolare quando i clienti sono già stati coinvolti in campagne o attività precedenti.

***

### Pagina di dettaglio del cliente

Aprendo un cliente dalla lista, accedi alla pagina di dettaglio.

Questa schermata è utile quando vuoi consultare in modo più approfondito la situazione di uno specifico contatto. Nella situazione attuale, la pagina di dettaglio mostra soprattutto informazioni legate all'operatività e allo storico.

<figure><img src="/files/OlBU4am5HELo27zdstTc" alt=""><figcaption></figcaption></figure>

#### Informazioni principali visibili nel dettaglio

Nel dettaglio cliente puoi trovare:

* dati anagrafici principali
* numero di telefono
* email
* stato del cliente
* statistiche sulle interazioni
* ultima chiamata disponibile
* presenza del cliente nelle campagne

#### Ultima chiamata

Una delle aree più rilevanti è quella dedicata all'ultima chiamata. Qui puoi consultare un riepilogo dell'interazione più recente e alcuni indicatori legati all'esito della conversazione, come ad esempio:

* esito dell'obiettivo
* sentiment del cliente
* eventuale necessità di follow-up
* eventuale escalation

<figure><img src="/files/wG6LxtIeW1kAJwXKGuhH" alt=""><figcaption></figcaption></figure>

Questa parte è molto utile per chi deve capire rapidamente come si è evoluto il rapporto con il contatto e quale sia il suo stato operativo più recente.

#### Presenza nelle campagne

La pagina di dettaglio mostra anche in quali campagne è presente il cliente. Questo ti permette di capire se il contatto è già stato coinvolto in attività specifiche e, quando disponibile, di aprire direttamente la campagna o il target collegato.

<figure><img src="/files/QL9lTnhVk2rFgqovUYqq" alt=""><figcaption></figcaption></figure>

Questa visibilità è importante perché evita di trattare il cliente come un record isolato: lo colloca invece nel contesto reale delle attività svolte in Aurora.

#### Statistiche

La sezione statistiche aiuta a leggere il contatto in modo più operativo. Puoi trovare indicatori come:

* chiamate totali
* chiamate con risposta
* chiamate fallite
* invii WhatsApp

<figure><img src="/files/gf8ku4KcrYt2I1DK1gSw" alt=""><figcaption></figcaption></figure>

Questi dati aiutano a capire, in modo sintetico, quanto il cliente sia già stato coinvolto nei processi della piattaforma.

***

### Un approccio consigliato

Se stai iniziando a usare Aurora, il metodo più efficace è questo:

1. crea o importa prima una base clienti ordinata
2. verifica che dati come telefono, email e stato siano coerenti
3. usa filtri e selezione multipla per organizzare i contatti
4. consulta il dettaglio cliente quando hai bisogno di capire lo storico operativo di un singolo contatto

Questo approccio riduce errori e rende più ordinata la gestione successiva delle attività outbound.

***

### Errori comuni da evitare

I casi più frequenti in questa sezione sono:

* creare clienti con dati incompleti o poco coerenti
* usare stati non aggiornati rispetto alla situazione reale
* importare file senza controllare il risultato finale
* aggiungere clienti a campagne senza aver verificato bene la selezione
* eliminare record senza aver prima controllato il loro utilizzo operativo

Una gestione accurata della base clienti migliora in modo diretto la qualità del lavoro svolto nelle campagne e nelle attività di contatto.

### Hai bisogno di assistenza?

Se riscontri problemi nella gestione dei clienti o nelle operazioni di importazione, puoi contattare l'assistenza scrivendo a `assistenza@aurorasuite.ai`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aurorasuite.ai/funzionalita-operative/customer-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
