# Come aggiungere informazioni ad un lead

{% stepper %}
{% step %}

### Accedere ai contatti

* Entra nella sezione **Contatti** dal menu a sinistra.
* Cerca e seleziona il lead di cui vuoi aggiornare le informazioni.
  {% endstep %}

{% step %}

### Aprire la scheda del lead

* Cliccando sul lead si aprirà la schermata con la conversazione relativa (vedi il tutorial “Come usare la pagina Conversazione” per i dettagli sulla pagina conversazione).
* A destra troverai la scheda con tutte le informazioni già registrate del contatto.
  {% endstep %}

{% step %}

### Modificare le informazioni esistenti

* Le informazioni mostrate sono modificabili: puoi cancellare o aggiornare i dati già presenti.

{% hint style="warning" %}
Il numero di telefono non può essere modificato. Se è necessario aggiornare il numero, crea un nuovo contatto con il nuovo numero.
{% endhint %}
{% endstep %}

{% step %}

### Aggiungere informazioni base

* Compila o aggiorna i campi disponibili, come:
  * Nome
  * Cognome
  * Email
  * Altri dettagli utili
* Dopo aver aggiunto o modificato i dati, assicurati di salvare la scheda del lead per rendere effettive le modifiche.
  {% endstep %}
  {% endstepper %}

***

Inserimento Avanzato di Informazioni

<details>

<summary>Panoramica avanzata</summary>

Dopo aver inserito i dati principali (nome, cognome, numero di telefono), nella scheda del lead troverai la modalità **Custom Fiels,** di default avrai General come stringa, puoi aggiungerne quante ne vuoi **Tramite Impostazioni** --> **Custom fields**

</details>

{% stepper %}
{% step %}

### Custom field generale

* Usa questa sezione per informazioni libere e descrittive.
* Esempi: provenienza del lead, tipo di piano di abbonamento, note libere.
  {% endstep %}

{% step %}

### Campi strutturati

* I campi strutturati permettono di aggiungere coppie chiave–valore riutilizzabili.
* Ogni campo è composto da:
  * Chiave (es. Età, Città, Tipo abbonamento)
  * Valore (es. 27, Milano, Premium)

Esempio:

* Chiave: Età
* Valore: 27

Queste chiavi/valore possono essere poi utilizzate come contesto nelle task (es. nelle istruzioni della task puoi inserire un riferimento come {extrafields\_età}).
{% endstep %}

{% step %}

### Uso dei campi strutturati nelle task

* Nella descrizione o nel contesto di una task puoi inserire riferimenti ai campi strutturati del lead.
* Esempio di frase in una task:
  * "Stai parlando con un lead che ha {extrafields\_età} anni"
* Tutte le chiavi strutturate aggiunte possono dunque essere interpolate nelle task per personalizzare il contesto.
  {% endstep %}

{% step %}

### Come inviare i campi strutturati via webhook

* I campi strutturati possono essere aggiunti manualmente oppure inviati a Bookli tramite webhook.
* Vedi il tutorial “Come inviare lead a bookli tramite webhook” per i dettagli sull’integrazione.

Esempio di payload JSON che puoi inviare via webhook:

{% code title="Esempio JSON" %}

```json
{
  "full_name": "Mario Rossi",
  "phone": "+391234567890",
  "email": "mario.rossi@example.com",
  "extrafields_età": 27,
  "extrafields_città": "Milano"
}
```

{% endcode %}
{% endstep %}
{% endstepper %}

Note finali

* Tutte le informazioni inserite nella scheda del lead sono salvabili e modificabili eccetto il numero di telefono.
* Le chiavi dei campi strutturati devono essere coerenti se si vuole riutilizzarle automaticamente nelle task (es. usare sempre extrafields\_età per l’età).
* Per esempi di utilizzo avanzato e integrazioni (webhook, automazioni, ecc.) consultare i tutorial specifici menzionati.

{% content-ref url="/pages/2534f9fce35b663111ea251615b322e421601661" %}
[Come usare la pagina Conversazione](/conversazioni/come-usare-la-pagina-conversazione.md)
{% endcontent-ref %}


---

# 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.bookli.ai/contatti/come-aggiungere-informazioni-ad-un-lead.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.