snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/it/user-guide/ai/capabilities/ai-agents.mdx

@@ -0,0 +1,30 @@
+---
+title: Agenti AI
+description: Integra le funzionalità di AI direttamente nei tuoi workflow di automazione.
+---
+
+## Panoramica
+
+Integra le funzionalità di AI direttamente nei tuoi workflow di automazione per l'elaborazione intelligente dei dati e il processo decisionale.
+
+## Funzionalità
+
+| Funzionalità              | Descrizione                                           |
+| ------------------------- | ----------------------------------------------------- |
+| **Azioni AI**             | Aggiungi passaggi basati sull'AI a qualsiasi workflow |
+| **Arricchimento Dati**    | Arricchisci automaticamente i record con dati esterni |
+| **Classificazione**       | Classifica i record in base all'analisi dei contenuti |
+| **Sintesi**               | Genera sintesi dai campi di testo                     |
+| **Prompt personalizzati** | Definisci esattamente come l'AI elabora i tuoi dati   |
+
+## Casi d'uso
+
+* **Lead scoring**: Valuta e dai priorità automaticamente ai lead in ingresso
+* **Pulizia dei dati**: Standardizza i nomi delle aziende e le informazioni di contatto
+* **Bozze di email**: Genera bozze di email di follow-up basate sulle note della riunione
+* **Smistamento dei record**: Assegna i record al membro del team corretto in base al contenuto
+
+## Correlati
+
+* [Panoramica sui workflow](/l/it/user-guide/workflows/overview) — nozioni di base sull'automazione
+* [Autorizzazioni AI](/l/it/user-guide/ai/capabilities/permissions-access-control) — controllo degli accessi per gli agenti AI

packages/twenty-docs/l/it/user-guide/ai/capabilities/ai-chatbot.mdx

@@ -0,0 +1,37 @@
+---
+title: Chatbot con IA
+description: Un assistente intelligente che ti aiuta a interagire con i dati del tuo CRM usando il linguaggio naturale.
+---
+
+## Panoramica
+
+Fai domande in lingua naturale e l'assistente recupera e spiega i tuoi dati CRM per te.
+
+## Funzionalità
+
+| Funzionalità                     | Descrizione                                                                                     |
+| -------------------------------- | ----------------------------------------------------------------------------------------------- |
+| **Query in linguaggio naturale** | Fai domande in inglese semplice invece di creare filtri                                         |
+| **Accesso completo ai dati**     | Interroga record, relazioni e metriche in tutto il tuo spazio di lavoro                         |
+| **Contesto della pagina**        | Fai riferimento a "questa azienda" o "questa opportunità" in base alla visualizzazione corrente |
+| **Conversazionale**              | Le domande di follow-up mantengono il contesto delle query precedenti                           |
+
+## Esempi di interazioni
+
+### Ricerca dei record
+
+* "Mostrami tutte le opportunità superiori a $50,000"
+* "Trova i contatti a cui non ho inviato email da 2 settimane"
+* "Elenca le aziende del settore sanitario"
+
+### Ottenere approfondimenti
+
+* "Qual è il valore totale della pipeline?"
+* "Quante trattative si sono chiuse il mese scorso?"
+* "Quale fase ha il maggior numero di opportunità bloccate?"
+
+### Uso del contesto della pagina
+
+* "Riassumi le mie interazioni con questa persona" (nella pagina di un contatto)
+* "Quali opportunità sono collegate a questa azienda?" (nella pagina di un'azienda)
+* "Quando è stata aggiornata per l'ultima volta questa trattativa?" (nella pagina di un'opportunità)

packages/twenty-docs/l/it/user-guide/ai/capabilities/mcp.mdx

@@ -0,0 +1,137 @@
+---
+title: Server MCP
+description: Collega gli assistenti AI al tuo spazio di lavoro di Twenty utilizzando il Model Context Protocol.
+---
+
+Twenty espone un server [MCP](https://modelcontextprotocol.io/) affinché gli assistenti AI — Claude Desktop, Claude Code, Cursor, ChatGPT e altri — possano leggere e scrivere i dati del tuo CRM in linguaggio naturale.
+
+Usa l'**URL dello spazio di lavoro** (l'URL che usi per accedere a Twenty) come endpoint MCP. Su Twenty Cloud, l'URL del tuo spazio di lavoro potrebbe essere `https://{mycompany}.twenty.com` oppure un dominio personalizzato. Il server è disponibile all'indirizzo:
+
+| Ambiente          | Endpoint MCP                                                                   |
+| ----------------- | ------------------------------------------------------------------------------ |
+| **Cloud**         | `https://{your-workspace-url}/mcp` (ad es. `https://mycompany.twenty.com/mcp`) |
+| **Auto-ospitato** | `https://{your-domain}/mcp`                                                    |
+
+## Metodi di autenticazione
+
+Hai due modi per autenticare il tuo client MCP: **OAuth** (consigliato) o **API Key**.
+
+### Opzione A — OAuth (Consigliato)
+
+Con OAuth, il tuo client MCP apre una finestra del browser per effettuare l'accesso. Nessun segreto viene archiviato nei file di configurazione e i token si rinnovano automaticamente.
+
+<Note>
+OAuth richiede un client MCP che supporti la [specifica MCP Authorization](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). Claude Desktop, Claude Code, Cursor e ChatGPT lo supportano.
+</Note>
+
+Aggiungi questo alla configurazione del tuo client MCP, sostituendo `{your-workspace-url}` con l'host del tuo spazio di lavoro (ad es. `mycompany.twenty.com`):
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp"
+    }
+  }
+}
+```
+
+È tutto — non è necessaria alcuna chiave API. Quando il client si connette per la prima volta, eseguirà:
+
+1. Scoprire i metadati OAuth di Twenty tramite `/.well-known/oauth-protected-resource` e `/.well-known/oauth-authorization-server`
+2. Registrarsi come client OAuth tramite registrazione dinamica del client (RFC 7591)
+3. Aprire il browser per autorizzare l'accesso
+4. Ricevere i token e connettersi al server MCP
+
+Le connessioni successive riutilizzano i token memorizzati e li rinnovano automaticamente.
+
+### Opzione B — Chiave API
+
+Se il tuo client MCP non supporta OAuth, o preferisci credenziali statiche, passa una chiave API nell'header `Authorization`:
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+<Warning>
+La tua chiave API concede l'accesso ai dati dello spazio di lavoro. Mantienila fuori dal controllo versione e dai dotfile condivisi.
+</Warning>
+
+Per creare una chiave API, vai su **Impostazioni → MCP e API → API → + Crea chiave**. Vedi [API](/l/it/developers/extend/api#create-an-api-key) per i dettagli.
+
+## Avvio rapido
+
+### 1. Copia la configurazione
+
+Vai su **Impostazioni → MCP e API → MCP** in Twenty. Scegli il metodo di autenticazione (OAuth o Chiave API), copia lo snippet JSON (userà già l'URL del tuo spazio di lavoro) e incollalo nel file di configurazione del tuo client MCP.
+
+| Client             | Percorso del file di configurazione                                                                                                                                                     |
+| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o `%APPDATA%\Claude\claude_desktop_config.json` (Windows)                                                     |
+| **Claude Code**    | `~/.claude.json` (utente) o `.mcp.json` (progetto)                                                                                                                                      |
+| **Cursor**         | `.cursor/mcp.json` nel tuo progetto, oppure `~/.cursor/mcp.json` globalmente                                                                                                            |
+| **ChatGPT**        | Attiva la Modalità sviluppatore in **Impostazioni → App e Connettori → Impostazioni avanzate**, quindi usa **Crea** in **Impostazioni → App e Connettori** per aggiungere il server MCP |
+
+### 2. Connetti
+
+Riavvia il tuo client MCP (o ricarica la configurazione). Se usi OAuth verrai reindirizzato a Twenty per autorizzare l'accesso. Se usi una chiave API la connessione è immediata.
+
+### 3. Inizia a usarlo
+
+Chiedi al tuo assistente AI di interagire con il tuo CRM:
+
+* *"Mostrami le 5 aziende create più di recente"*
+* *"Crea una nuova persona di nome Jane Doe presso Acme Corp"*
+* *"Trova tutte le opportunità aperte di valore superiore a $10k"*
+
+## Strumenti disponibili
+
+Una volta connesso, il server MCP espone strumenti che rispecchiano l'API di Twenty. Il flusso di lavoro consigliato è:
+
+1. **`learn_tools`** — ottenere lo schema di input per strumenti specifici
+2. **`execute_tool`** — eseguire uno strumento
+
+Non è necessario ricordare i nomi degli strumenti. Chiedi al tuo assistente AI cosa può fare e chiamerà `learn_tools` automaticamente.
+
+## Permessi
+
+Le connessioni MCP ereditano le autorizzazioni dell'utente autenticato (OAuth) o il ruolo assegnato alla chiave API. Per limitare ciò che il server MCP può fare:
+
+* **OAuth**: si applica il ruolo dell'utente nello spazio di lavoro.
+* **Chiave API**: assegna un ruolo alla chiave API in **Impostazioni → Membri → Ruoli**. Vedi [Autorizzazioni](/l/it/user-guide/permissions-access/capabilities/permissions).
+
+## Configurazione self-hosted
+
+Per le istanze self-hosted, sostituisci `{your-workspace-url}` con l'URL del tuo server. Assicurati che `SERVER_URL` nel tuo ambiente corrisponda all'URL pubblico della tua istanza Twenty — viene utilizzato per generare i metadati di discovery OAuth.
+
+```bash
+SERVER_URL=https://twenty.yourcompany.com
+```
+
+L'endpoint MCP, gli endpoint OAuth e i metadati di discovery derivano tutti da questo valore.
+
+## Risoluzione dei problemi
+
+**Errori "Unauthorized" o 401**
+
+* OAuth: esegui nuovamente l'autorizzazione eliminando i token memorizzati nel tuo client MCP e riconnettiti.
+* Chiave API: verifica che la chiave sia valida e non sia scaduta. Rigenerala se necessario.
+
+**Il flusso OAuth non apre il browser**
+
+* Assicurati che il tuo client MCP supporti MCP Authorization. In caso contrario, ricorri al metodo con Chiave API.
+
+**Timeout di connessione**
+
+* Verifica che l'URL dell'endpoint MCP sia raggiungibile dalla tua macchina. Per le istanze self-hosted, controlla che il server sia in esecuzione e che `SERVER_URL` sia impostato correttamente.

packages/twenty-docs/l/it/user-guide/ai/capabilities/permissions-access-control.mdx

@@ -0,0 +1,35 @@
+---
+title: Autorizzazioni e controllo degli accessi
+description: Controlla a cosa gli agenti AI possono accedere e cosa possono modificare nel tuo spazio di lavoro.
+---
+
+## Panoramica
+
+Gli agenti AI rispettano la struttura delle autorizzazioni esistente. Ciò è particolarmente importante per i team che desiderano controllare esattamente a cosa i processi di AI automatizzati possono accedere o cosa possono modificare nel proprio spazio di lavoro.
+
+## Assegna un ruolo a un agente AI
+
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Clicca sul ruolo che vuoi assegnare
+3. Apri la scheda **Assegnazione**
+4. In **Agenti AI**, fai clic su **+ Assegna a un agente AI**
+5. Seleziona l'agente AI dall'elenco
+6. Conferma l'assegnazione
+
+## Perché assegnare ruoli agli agenti AI?
+
+| Vantaggio         | Descrizione                                                                 |
+| ----------------- | --------------------------------------------------------------------------- |
+| **Sicurezza**     | Limita i dati a cui gli agenti AI possono accedere o che possono modificare |
+| **Conformità**    | Garantisci che l'AI elabori solo i dati necessari                           |
+| **Controllo**     | Previeni azioni indesiderate da parte delle automazioni AI                  |
+| **Tracciabilità** | Tieni traccia di quali azioni sono state eseguite da ciascun agente         |
+
+<Note>
+Per gli agenti AI che operano all'interno dei flussi di lavoro, l'assegnazione di un ruolo garantisce che l'agente non possa accedere o modificare dati al di fuori dell'ambito previsto, anche se il flusso di lavoro dispone di autorizzazioni più ampie.
+</Note>
+
+## Correlati
+
+* [Autorizzazioni](/l/it/user-guide/permissions-access/capabilities/permissions) — informazioni dettagliate sulla creazione e gestione dei ruoli
+* [Agenti AI](/l/it/user-guide/ai/capabilities/ai-agents) — funzionalità di AI nei flussi di lavoro

packages/twenty-docs/l/it/user-guide/ai/how-tos/ai-faq.mdx

@@ -0,0 +1,31 @@
+---
+title: FAQ sull'IA
+description: Domande frequenti sulle funzionalità di IA in Twenty.
+---
+
+<AccordionGroup>
+
+  <Accordion title="Quali capacità di IA sono disponibili?">
+    Le due principali capacità dell'IA sono:
+
+    1. **Chatbot IA**: un assistente contestuale che può accedere ai tuoi dati di Twenty e aiutarti con le tue domande
+    2. **Agenti di IA nei flussi di lavoro**: automazione intelligente in grado di elaborare dati, prendere decisioni ed eseguire attività all'interno dei tuoi flussi di lavoro
+  </Accordion>
+
+  <Accordion title="Gli agenti di IA hanno accesso a tutti i miei dati?">
+    Gli agenti AI operano sotto il sistema di autorizzazione. Puoi assegnare ruoli specifici agli agenti di IA in **Impostazioni → Membri → Ruoli**, dandoti il pieno controllo sui dati a cui possono accedere e sulle azioni che possono eseguire.
+  </Accordion>
+
+  <Accordion title="Come funzionano i crediti di IA?">
+    Le azioni di IA consumano crediti dei flussi di lavoro in base alla complessità dell'attività e al modello di IA utilizzato.
+  </Accordion>
+
+  <Accordion title="Posso usare i miei modelli di IA?">
+    Nel cloud, puoi utilizzare solo i modelli di IA forniti da Twenty. Nella tua istanza self-hosted, puoi utilizzare i tuoi modelli di IA dopo aver ottenuto una licenza Organization.
+  </Accordion>
+
+  <Accordion title="Non vedo un ruolo che ho assegnato ad un agente di intelligenza artificiale, dove?">
+    Per impostazione predefinita, l'elenco Ruoli è filtrato per mostrare i ruoli assegnabili ai membri dello spazio di lavoro. Se un ruolo è assegnabile solo agli agenti AI, è necessario modificare il filtro per includere i ruoli dell'agente AI.
+  </Accordion>
+
+</AccordionGroup>

packages/twenty-docs/l/it/user-guide/ai/overview.mdx

@@ -0,0 +1,58 @@
+---
+title: AI
+description: Funzionalità basate sull'IA in Twenty.
+---
+
+<Frame>
+  <img src="/images/user-guide/workflows/robot.png" alt="AI" />
+</Frame>
+
+## Funzionalità
+
+Attualmente, Twenty offre:
+
+### 1. Chatbot con IA
+
+Un assistente conversazionale che comprende il tuo contesto e ha accesso a tutti i tuoi dati su Twenty.
+
+**Funzionalità principali:**
+
+* **Accesso completo ai dati**: Interroga qualsiasi record, relazione o metrica nel tuo spazio di lavoro
+* **Consapevolezza del contesto della pagina**: Fai riferimento a "questa azienda" o "questa opportunità" in base a dove ti trovi in Twenty
+* **Linguaggio naturale**: Fai domande e ottieni risposte senza navigare tra i menu
+
+**Esempi di prompt:**
+
+* "Quali opportunità si chiuderanno questo mese?"
+* "Quali affari sono in Negoziazione da più di 30 giorni?"
+* "Riassumi le mie interazioni con questa persona"
+
+### 2. Agenti di IA nei flussi di lavoro
+
+Estendi i tuoi flussi di lavoro con azioni basate sull'IA e agenti autonomi.
+
+**Funzionalità principali:**
+
+* **Azioni di IA**: Usa l'IA per arricchire i dati, classificare i record, generare riepiloghi e altro ancora
+* **Agenti autonomi**: Consenti agli agenti di eseguire attività in più passaggi all'interno di un flusso di lavoro
+* **Prompt personalizzati**: Definisci esattamente come l'IA deve elaborare i tuoi dati
+
+**Casi di utilizzo:**
+
+* Classifica automaticamente i lead in entrata
+* Arricchisci i dati aziendali da fonti pubbliche
+* Genera bozze di email di follow-up basate sulle note della riunione
+* Assegna un punteggio alle opportunità in base ai modelli di coinvolgimento
+
+## Autorizzazioni e controllo degli accessi
+
+Gli agenti di IA sono gestiti tramite il sistema di autorizzazioni esistente:
+
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Configura a quali dati può accedere ciascun agente di IA
+3. Imposta le autorizzazioni di lettura/scrittura per oggetto
+
+Questo garantisce che gli agenti di IA rispettino le tue politiche di governance dei dati e accedano solo a ciò di cui hanno bisogno.
+
+* Segui il nostro [GitHub](https://github.com/twentyhq/twenty) per gli aggiornamenti sullo sviluppo
+* Unisciti al nostro [Discord](https://discord.gg/UfGNZJfAG6) per condividere feedback e richieste di funzionalità

packages/twenty-docs/l/it/user-guide/billing/capabilities/credits.mdx

@@ -0,0 +1,74 @@
+---
+title: Crediti
+description: Un saldo semplice che alimenta i tuoi workflow, gli agenti AI e la chat AI — quanto vale un credito, fin dove può arrivare e come gestirlo.
+---
+
+## Cosa sono i crediti?
+
+I crediti sono un unico saldo che alimenta tutto ciò che eseguiamo per tuo conto e che ha un costo reale: **automazioni dei workflow**, **agenti AI** e la **chat AI**. Invece di destreggiarti tra quote separate per "automation runs" e "AI tokens", hai un unico saldo semplice da tenere d’occhio.
+
+**1 credito = $1 di utilizzo.** Un credito è semplicemente un dollaro di lavoro, quindi il tuo saldo è facile da capire — nessuna unità astratta da convertire.
+
+## Quanto può coprire un credito?
+
+Il costo varia in base al lavoro. Le automazioni quotidiane e i messaggi AI rapidi costano una piccola frazione di un credito; le grandi attività degli agenti AI multi-step costano di più. Ecco un quadro approssimativo:
+
+| Cosa fai                                                                                                                           | Costo approssimativo               | Cosa significa                    |
+| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | --------------------------------- |
+| Esegui un passaggio standard del flusso di lavoro (ricerca, crea o aggiorna record) o attiva la funzione logica di un'applicazione | $0.0001                            | **10.000 esecuzioni per credito** |
+| Chiama un'API esterna o esegui un nodo di codice                                                                                   | Una piccola frazione di un credito | Migliaia per credito              |
+| Invia un messaggio di chat AI rapido o uno step AI semplice                                                                        | Una frazione di un centesimo       | Centinaia per credito             |
+| Esegui una grande attività di agente AI (ad es. "configura 10 oggetti dello spazio di lavoro")                                     | Può arrivare a **~$1 o più**       | Alcuni per credito                |
+| Esegui una ricerca web con AI                                                                                                      | Un costo fisso per ricerca         | Centinaia di ricerche per credito |
+
+<Note>
+Per la maggior parte dei team, le automazioni standard sono di fatto gratuite — noterai un impatto sul saldo solo quando ti affidi alle funzionalità AI o esegui nodi di codice pesanti. È voluto: i crediti inclusi sono pensati per permetterti di costruire senza dover controllare un contatore.
+</Note>
+
+<Note>
+Non tutte le app addebitano le proprie esecuzioni. Registratore di chiamate e Ultimo contatto reagiscono ad ogni email e evento del calendario importati nel vostro workspace, quindi la loro funzione logica funziona sono liberi. Ti viene comunque addebitato il lavoro a consumo che svolgono, ad esempio i minuti delle chiamate registrate.
+</Note>
+
+## Come viene misurato l'utilizzo dell'AI
+
+Quando un'azione chiama un modello AI, misuriamo esattamente i token utilizzati e li tariffiamo alle **tariffe pubblicate dal provider del modello**, quindi convertiamo direttamente quell'importo in dollari in crediti — così ciò che spendi rispecchia il costo reale del lavoro, non una tariffa interna maggiorata. Un breve messaggio di chat costa una frazione di un centesimo. Una grande attività di agente — ad esempio, la configurazione di 10 oggetti di workspace — fa molte chiamate di modello su un contesto in crescita, così può aggiungere fino a un dollaro o più. Ti viene addebitato ciò che usi effettivamente, fino al singolo token.
+
+Il costo varia in base al modello: un modello leggero è drasticamente più economico per messaggio rispetto a un modello di ragionamento di fascia alta. Puoi vedere il dettaglio per azione — incluso quale modello è stato utilizzato — in **Impostazioni → Fatturazione**.
+
+## Cosa è incluso
+
+Ogni abbonamento include crediti e l'importo dipende dal tuo **ciclo di fatturazione**, non dal tuo piano:
+
+| Ciclo di fatturazione | Crediti inclusi | Uso Equivalente                 |
+| --------------------- | --------------- | ------------------------------- |
+| Mensile               | 5/mese          | Circa $5 di utilizzo ogni mese  |
+| Annuale               | 50/anno         | Circa $50 di utilizzo ogni anno |
+
+Questi crediti sono pensati per coprire comodamente le automazioni quotidiane. Cinque crediti coprono decine di migliaia di passaggi di automazione standard o centinaia di messaggi rapidi di AI — anche se una manciata di grandi, le attività di agente multi-step possono utilizzarle più velocemente. Puoi effettuare una ricarica in qualsiasi momento (vedi sotto).
+
+## Riporto dei crediti
+
+I crediti non utilizzati vengono riportati automaticamente al periodo di fatturazione successivo.
+
+* **Cap**: Il rollover è limitato alla piena allocazione di un periodo, quindi non potrai mai trasportare più di quanto il tuo ciclo di fatturazione fornisca per periodo.
+* **Visibilità**: Quando sono disponibili crediti riportati, compaiono come una voce separata **Crediti riportati** in **Impostazioni → Fatturazione**, accanto al saldo **Totale disponibile**.
+
+## Monitoraggio dell'utilizzo
+
+Tieni traccia del tuo saldo e di dove sta andando:
+
+1. Vai a **Impostazioni → Fatturazione**
+2. Vedi i **crediti rimanenti** e **l'utilizzo per il periodo corrente**
+3. Approfondisci il dettaglio per vedere quali workflow e azioni AI stanno consumando crediti — e quali modelli sono stati utilizzati dalle azioni AI
+
+Rivedere questo regolarmente rende facile individuare in anticipo un workflow pesante e decidere se ottimizzarlo o effettuare una ricarica.
+
+## Hai bisogno di più crediti?
+
+Se esaurisci i crediti — o vuoi un margine prima di una grande iniziativa di automazione — puoi acquistare pacchetti di crediti aggiuntivi in qualsiasi momento:
+
+1. Vai a **Impostazioni → Fatturazione**
+2. Clicca sul pulsante **Increase**
+3. Seleziona l'importo necessario e accetta le modifiche
+
+I crediti acquistati vengono aggiunti immediatamente al tuo saldo disponibile.

packages/twenty-docs/l/it/user-guide/billing/capabilities/pricing-plans.mdx

@@ -0,0 +1,100 @@
+---
+title: Piani tariffari
+description: Scopri i piani tariffari di Twenty e come passare da uno all'altro.
+---
+
+## Panoramica
+
+Twenty offre prezzi flessibili per team di ogni dimensione, sia con hosting cloud sia con self‑hosting.
+
+## Piani cloud
+
+### Pro (Cloud)
+
+Per i team pronti a scalare:
+
+* Tutte le funzionalità CRM di base
+* Sincronizzazione email e calendario
+* Flussi di lavoro e automazioni
+* Supporto standard
+
+<Note>
+Le funzionalità Premium (SSO, autorizzazioni a livello di riga, dati di utilizzo dell'IA e altro ancora) non sono incluse nel piano Pro.
+</Note>
+
+### Organizzazione (Cloud)
+
+Per i team più numerosi con esigenze avanzate:
+
+* Tutto ciò che è incluso in Pro
+* **Funzionalità Premium**: integrazione SSO, autorizzazioni a livello di riga, dati di utilizzo dell'IA e altro ancora
+* Supporto prioritario
+
+## Piani self‑hosted
+
+### Gratuito (self‑hosted)
+
+Esegui Twenty sulla tua infrastruttura senza costi:
+
+* Include tutte le funzionalità di Pro
+* Supporto della community via Discord
+* Pieno controllo sui tuoi dati
+
+### Organizzazione (self‑hosted)
+
+Per i team che necessitano di funzionalità premium con il self‑hosting:
+
+* Tutte le funzionalità di Pro
+* **Funzionalità Premium**: integrazione SSO, autorizzazioni a livello di riga, dati di utilizzo dell'IA e altro ancora
+* Supporto del team di Twenty
+* Nessun requisito di pubblicare il codice personalizzato come open source prima della distribuzione
+
+## Funzionalità premium
+
+Le funzionalità premium sono disponibili solo nei piani Organizzazione (Cloud o self‑hosted):
+
+* **Integrazione SSO**: Single Sign‑On con il tuo provider di identità
+* **Autorizzazioni a livello di riga**: controllo degli accessi granulare a livello di record
+* **Dati di utilizzo dell'IA**: Tieni traccia del consumo dell'IA nel tuo spazio di lavoro
+* **Log di controllo**: verifica cosa ha fatto ciascun membro dello spazio di lavoro
+* **Campagne email**: pianifica quali email devono essere inviate (disponibile a breve)
+* **Spazi di lavoro illimitati**: Crea tutti gli spazi di lavoro che desideri (solo self-hosted)
+* **Codice sorgente privato**: nessun obbligo di pubblicare le modifiche in un repository pubblico (solo self-hosted)
+
+## Cambio piano
+
+### Esegui l'upgrade a Organizzazione
+
+1. Vai a **Impostazioni → Fatturazione → Piani**
+2. Fai clic su **Passa a Organizzazione**
+3. Conferma l'upgrade
+
+### Esegui il downgrade a Pro
+
+1. Vai a **Impostazioni → Fatturazione → Piani**
+2. Fai clic su **Passa al Pro**
+3. Conferma il downgrade
+
+### Passa alla fatturazione annuale
+
+1. Vai a **Impostazioni → Fatturazione**
+2. Fai clic su **Passa all'annuale**
+3. Risparmia con la fatturazione annuale
+
+### Passa alla fatturazione mensile
+
+1. Vai a **Impostazioni → Fatturazione**
+2. Fai clic su **Effettua il downgrade a mensile**
+3. Risparmia con la fatturazione mensile
+
+## Ottieni una chiave Enterprise per l'Organization (Self-Hosted)
+
+Per utilizzare il piano Organization (Self-Hosted), devi ottenere una chiave Enterprise:
+
+1. Vai a **Impostazioni → Pannello di Amministrazione → Enterprise**
+
+<img src="/images/user-guide/billing/enterprise-key.png" alt="Chiave Enterprise" />
+
+2. Fai clic su **Ottieni la chiave Enterprise**
+3. Quando vieni reindirizzato a Stripe, inserisci i dati di pagamento e conferma
+4. Quando viene visualizzata la tua chiave Enterprise, incollala nella pagina delle impostazioni Enterprise e attiva la licenza dell'organizzazione

packages/twenty-docs/l/it/user-guide/billing/how-tos/billing-faq.mdx

@@ -0,0 +1,105 @@
+---
+title: FAQ sulla fatturazione
+description: Domande frequenti sui prezzi e sulla fatturazione di Twenty.
+---
+
+## Prezzi
+
+<AccordionGroup>
+<Accordion title="Posso usare Twenty gratuitamente mentre ospito autonomamente?">
+Sì, puoi usare Twenty gratuitamente mentre ospiti autonomamente. Otterrai accesso a tutto ciò che è incluso nel piano Pro (Cloud), tranne il supporto del nostro team di base. Il supporto è accessibile tramite la nostra comunità su Discord.
+
+Se vuoi effettuare il self-hosting e hai bisogno delle funzionalità Premium (SSO, autorizzazioni a livello di riga e altro), puoi scegliere la licenza a pagamento Organization (Self-Hosted). Questo include anche il supporto del team di Twenty e rimuove l'obbligo di pubblicare il codice personalizzato come open-source prima della distribuzione.
+</Accordion>
+
+<Accordion title="Quali sono le funzionalità Premium?">
+Le funzionalità Premium sono disponibili solo nei piani Organization (Cloud o Self-Hosted):
+* **Integrazione SSO**: Single Sign-On con il tuo provider di identità
+* **Autorizzazioni a livello di riga**: controllo degli accessi granulare a livello di record
+* **Dati di utilizzo dell'IA**: Tieni traccia del consumo dell'IA nel tuo spazio di lavoro
+* **Log di controllo**: verifica cosa ha fatto ogni membro dello spazio di lavoro
+* **Campagne email**: pianifica quali email devono essere inviate (disponibile a breve)
+* **Spazi di lavoro illimitati**: crea tutti gli spazi di lavoro che vuoi (solo self-hosted)
+* **Codice sorgente privato**: Nessun requisito per pubblicare le modifiche a un repository disponibile al pubblico (solo self-hosted)
+</Accordion>
+
+<Accordion title="Il Cloud e l'Organizzazione Auto-Ospitata progettano lo stesso?">
+Offrono le stesse funzionalità Premium. Tuttavia, un abbonamento cloud non può essere utilizzato per distribuzioni self-hosted. La modalità self-hosted richiede una chiave Enterprise.
+</Accordion>
+
+<Accordion title="Offrite posti gratuiti per utenti solo visualizzazione?">
+Non offriamo posti gratuiti. I prezzi sono per utente e ogni utente ha bisogno di una licenza per accedere a Venti.
+</Accordion>
+
+<Accordion title="Dove posso passare il mio abbonamento al piano Organization?">
+Puoi farlo in `Impostazioni → Fatturazione → Piani`. Poi clicca su `Passa all'Organizzazione`.
+</Accordion>
+
+<Accordion title="Dove posso passare il mio abbonamento al piano Pro?">
+Puoi farlo in `Impostazioni → Fatturazione → Piani`. Poi clicca su `Passa a Pro`.
+</Accordion>
+
+<Accordion title="Dove posso passare il mio abbonamento al piano annuale?">
+Puoi farlo sotto `Impostazioni → Fatturazione`. Poi clicca su `Passa al piano annuale`.
+</Accordion>
+
+<Accordion title="Dove posso passare il mio abbonamento al piano mensile?">
+Puoi farlo sotto `Impostazioni → Fatturazione`. Poi clicca su `Effettua il downgrade a mensile`.
+</Accordion>
+
+<Accordion title="Dove posso vedere l'uso dei miei crediti?">
+Lo troverai sotto `Impostazioni → Fatturazione`.
+</Accordion>
+
+<Accordion title="Quanti crediti di workflow abbiamo?">
+I crediti si basano sul tuo ciclo di fatturazione, non sul tuo piano:
+* **Abbonamenti mensili**: 5 crediti al mese
+* **Abbonamenti annuali**: 50 crediti all'anno
+</Accordion>
+
+<Accordion title="Come funziona il consumo dei crediti di workflow?">
+Ogni azione del flusso di lavoro consuma crediti in base alla sua complessità:
+* **Operazioni interne di base** (come ricerca, aggiornamento o creazione di record) consumano pochissimi crediti
+* Le operazioni più complesse come i nodi di codice e le richieste a servizi esterni consumano più crediti
+* Gli **AI prompts** consumano anche più crediti in base all'utilizzo
+* **Apps** consuma anche più crediti allo stesso modo dei nodi di codice
+
+I crediti vengono detratti in tempo reale quando i flussi di lavoro o le app vengono eseguiti. Puoi monitorare il tuo utilizzo in `Impostazioni → Fatturazione` per controllare il consumo e i crediti rimanenti.
+</Accordion>
+
+<Accordion title="Posso acquistare più crediti di workflow?">
+Puoi acquistare crediti aggiuntivi sotto `Impostazioni → Fatturazione`.
+</Accordion>
+
+<Accordion title="Posso acquistare più crediti per i flussi di lavoro solo per 1 mese?">
+Sì, vai a `Impostazioni → Fatturazione`, clicca sul pulsante `Increase`, scegli quanti crediti vuoi e confermi. Saranno applicate per il periodo di fatturazione corrente. Quindi clicca nuovamente sul pulsante `Increase`, cambia il valore di nuovo all'originale, e confermare — il declassamento sarà applicato a partire dal successivo periodo di fatturazione.
+</Accordion>
+</AccordionGroup>
+
+## Fatturazione
+
+<AccordionGroup>
+<Accordion title="Dove posso gestire i dettagli della fatturazione?">
+Puoi farlo sotto `Impostazioni → Fatturazione`.
+</Accordion>
+
+<Accordion title="Dove posso aggiornare il mio metodo di pagamento?">
+Puoi farlo sotto `Impostazioni → Fatturazione`. Poi clicca su `Visualizza dettagli di fatturazione`. Sarai in grado di aggiungere un nuovo metodo di pagamento lì.
+</Accordion>
+
+<Accordion title="Dove posso aggiornare le mie informazioni di fatturazione?">
+Puoi farlo sotto `Impostazioni → Fatturazione`. Poi clicca su `Visualizza dettagli di fatturazione`. Sarai in grado di modificare le informazioni di fatturazione lì.
+</Accordion>
+
+<Accordion title="Dove posso accedere alle mie fatture?">
+Puoi farlo sotto `Impostazioni → Fatturazione`. Poi clicca su `Visualizza dettagli di fatturazione`. Vedrai tutte le tue fatture in fondo allo schermo.
+</Accordion>
+
+<Accordion title="Perché il numero di posti è diverso dal numero di utenti nel mio spazio di lavoro?">
+Il conteggio dei posti dello spazio di lavoro è sincronizzato con il sistema di pagamento ogni 6 ore; le fatture vengono adeguate in base alla differenza.
+</Accordion>
+
+<Accordion title="Perché ho ricevuto una fattura per un nuovo membro dello spazio di lavoro?">
+Quando un nuovo membro del workspace viene aggiunto al workspace, viene inviata una fattura per coprire la differenza. Quando un membro dello spazio di lavoro viene rimosso, la modifica viene applicata nella successiva fattura standard mensile/annuale.
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/it/user-guide/billing/overview.mdx

@@ -0,0 +1,39 @@
+---
+title: Fatturazione
+description: Comprendi i prezzi di Twenty e gestisci il tuo abbonamento.
+---
+
+Twenty offre piani tariffari flessibili per soddisfare le esigenze del tuo team. Gestisci il tuo abbonamento, tieni traccia dei crediti dei flussi di lavoro e accedi alle fatture direttamente da **Impostazioni → Fatturazione**.
+
+## Cosa c'è in questa sezione
+
+<CardGroup cols={2}>
+  <Card title="Piani tariffari" icon="tags" href="/l/it/user-guide/billing/capabilities/pricing-plans">
+    Scopri i piani tariffari di Twenty e cosa includono.
+  </Card>
+  <Card title="FAQ" icon="circle-question" href="/l/it/user-guide/billing/how-tos/billing-faq">
+    Domande frequenti su prezzi e fatturazione.
+  </Card>
+</CardGroup>
+
+## A colpo d'occhio
+
+| Piano                            | Funzionalità principali                                                                                                                                                                                                     |
+| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Gratuito (self-hosted)**       | Tutte le funzionalità Pro, supporto della community                                                                                                                                                                         |
+| **Pro (Cloud)**                  | Tutto tranne le funzionalità Premium (SSO, autorizzazioni a livello di riga e altro), supporto standard                                                                                                                     |
+| **Organizzazione (Cloud)**       | Tutto dal piano Pro + le funzionalità Premium (SSO, autorizzazioni a livello di riga e altro), supporto prioritario                                                                                                         |
+| **Organizzazione (self-hosted)** | Tutto dal piano Pro + le funzionalità Premium (SSO, autorizzazioni a livello di riga e altro), supporto del team Twenty, non è richiesto pubblicare il tuo codice personalizzato come open-source prima della distribuzione |
+
+## Risposte rapide
+
+**Dove gestisco la fatturazione?**
+Vai su **Impostazioni → Fatturazione** per vedere il tuo piano, aggiornare i metodi di pagamento e accedere alle fatture.
+
+**Posso usare Twenty gratuitamente?**
+Sì! Ospita Twenty in self-hosting e ottieni tutte le funzionalità Pro senza costi.
+
+**Come effettuo l'upgrade?**
+Vai su **Impostazioni → Fatturazione** e fai clic su **Passa a Organizzazione** o **Passa ad Annuale**.
+
+Per altre domande, consulta le [FAQ sulla fatturazione](/l/it/user-guide/billing/how-tos/billing-faq).

packages/twenty-docs/l/it/user-guide/calendar-emails/capabilities/calendar.mdx

@@ -0,0 +1,43 @@
+---
+title: Calendario
+description: Informazioni sulle funzionalità di integrazione del calendario in Twenty.
+---
+
+**Nota**: Per connettere il tuo calendario e configurare le impostazioni di sincronizzazione, visita [Configurazione Email e Calendario](/l/it/user-guide/calendar-emails/overview).
+
+## Come funziona l'integrazione del calendario
+
+Twenty sincronizza automaticamente gli eventi del tuo calendario e li collega ai relativi record del CRM, offrendoti una visione completa della cronologia delle riunioni con contatti e aziende.
+
+## Scheda del calendario
+
+Accanto alla scheda Email nei record, troverai una scheda `Calendario` che contiene la cronologia delle riunioni programmate con il record.
+
+### Disponibile per
+
+* **Persone**: Visualizza tutte le riunioni programmate con un contatto specifico
+* **Aziende**: Vedi tutte le riunioni relative a un'azienda e ai suoi dipendenti
+* **Opportunità**: Accedi alla cronologia delle riunioni relative all'azienda collegata all'opportunità
+
+### Visualizzazione della cronologia delle riunioni
+
+1. **Naviga a un record**: Vai a qualsiasi record di Persona, Azienda o Opportunità
+2. **Seleziona la scheda Calendario**: Clicca sulla scheda `Calendario` accanto alla scheda Emails
+3. **Sfoglia la cronologia delle riunioni**: Visualizza tutte le riunioni programmate e i loro dettagli
+4. **Accedi al contesto della riunione**: Vedi i partecipanti, i tempi e le informazioni relative alle riunioni
+
+## Impostazioni di visibilità
+
+I dati del calendario seguono le stesse impostazioni di visibilità delle email, garantendo controlli della privacy coerenti su entrambi i canali di comunicazione.
+
+## Cosa viene sincronizzato
+
+* **Riunioni esterne**: Tutte le riunioni con contatti al di fuori della tua organizzazione
+* **Collegamento automatico**: Le riunioni si collegano ai record Persone e Aziende esistenti in base agli indirizzi email dei partecipanti
+* **Dettagli riunione**: Oggetto, orario, durata e partecipanti
+* **Aggiornamenti**: I nuovi eventi del calendario vengono sincronizzati automaticamente
+
+## Cosa non viene sincronizzato
+
+* **Riunioni interne**: Le riunioni solo tra colleghi (stesso dominio) rimangono private
+* **Eventi privati**: Eventi contrassegnati come privati nel tuo calendario

packages/twenty-docs/l/it/user-guide/calendar-emails/capabilities/mailbox.mdx

@@ -0,0 +1,102 @@
+---
+title: Casella di posta
+description: Comprendere le funzionalità di integrazione delle email in Twenty.
+---
+
+**Nota**: Per connettere i tuoi account email e configurare le impostazioni di sincronizzazione, visita [Configurazione Email e Calendario](/l/it/user-guide/calendar-emails/overview).
+
+## Come funziona l'integrazione dell'email
+
+Twenty collega automaticamente le email dalle tue caselle di posta connesse ai relativi record CRM, mantenendo la cronologia di comunicazione in un unico posto.
+
+### Oggetti in cui è possibile trovare le email
+
+Le conversazioni email appaiono in tre oggetti principali:
+
+* **Persone**: Visualizza tutte le email scambiate con un contatto specifico
+* **Aziende**: Vedi tutte le email relative ad un'azienda e ai suoi dipendenti
+* **Opportunità**: Accedi ai thread di email relativi all'azienda legati all'opportunità. I thread email delle singole persone sull'opportunità non sono ancora mostrati.
+
+### Visualizzazione dei thread email
+
+1. **Naviga a un record**: Vai a qualsiasi record di Persona, Azienda o Opportunità
+2. **Seleziona la scheda Email**: Clicca sulla scheda `Emails` per visualizzare le email sincronizzate
+3. **Apri un thread email**: Clicca su qualsiasi email per aprire e leggere l'intera conversazione
+4. **Sfoglia cronologia**: Scorri attraverso la cronologia completa delle email con quel contatto
+
+<img src="/images/user-guide/emails/show-inbox.png" style={{width:'100%'}} />
+
+## Cosa vedrai
+
+### Vista del thread email
+
+Quando apri un thread email, puoi:
+
+* **Leggere le conversazioni complete**: Vedi l'intero scambio di email
+* **Visualizzare i partecipanti**: Vedi tutte le persone coinvolte nel thread email
+* **Verificare i timestamp**: Scopri esattamente quando è stata inviata ciascuna email
+* **Accedere al contesto**: Comprendi la cronologia completa delle comunicazioni
+
+### Visibilità delle email
+
+A seconda delle impostazioni della casella di posta, potresti vedere:
+
+* **Contenuto completo**: Testo e dettagli email completi
+* **Oggetto + Metadati**: Riga dell'oggetto, mittente, destinatario e timestamp
+* **Solo metadati**: Informazioni di base senza contenuto email
+
+## Comportamento di sincronizzazione delle email
+
+### Velocità di sincronizzazione
+
+Twenty importa email a circa **400 messaggi al minuto**. Questa velocità è attualmente limitata dalle limitazioni di frequenza dell'API di Gmail (e vale in modo analogo per altri provider).
+
+A titolo di riferimento:
+
+* 1.000 email → ~2,5 minuti
+* 10.000 email → ~25 minuti
+* 50.000 email → ~2 ore
+
+### Cosa viene sincronizzato
+
+* **Email esterne**: Tutte le email con contatti al di fuori della tua organizzazione
+* **Collegamento automatico**: Le email si connettono ai record di Persone e Aziende esistenti
+* **Indirizzi multipli**: Le email provenienti da qualsiasi indirizzo si collegano allo stesso record contatto
+* **Aggiornamenti**: Nuove email appaiono immediatamente
+
+### Cosa non viene sincronizzato
+
+* **Email interne**: Per impostazione predefinita, le email tra colleghi (stesso dominio) restano private (configurabile in Impostazioni → Generale → Sicurezza)
+* **Email di gruppo**: Liste di distribuzione e email di gruppo sono escluse
+* **Cartelle escluse**: Cartelle che hai scelto di non sincronizzare (configurate in Impostazioni → Account → Email)
+
+### Email Interne
+
+Scegli se sincronizzare le email interne in Twenty:
+
+1. Vai a **Impostazioni → Generale → Sicurezza**
+2. Attiva/disattiva **Sincronizza email interne**
+
+### Sincronizzazione selettiva delle cartelle
+
+Controlla quali cartelle email sincronizzano con Twenty:
+
+1. Vai a **Impostazioni → Account** e seleziona il tuo account email collegato
+2. Configura le cartelle nella sezione Email
+3. Scegli cartelle specifiche da includere o escludere (Posta in arrivo, Inviati, Archivio, cartelle personalizzate)
+
+## Risoluzione dei problemi di sincronizzazione delle email
+
+### Problemi comuni di sincronizzazione
+
+* **Ritardi di sincronizzazione**: Le email appaiono immediatamente, ma le importazioni iniziali richiedono più tempo
+* **Email mancanti**: Verifica se:
+  * Le cartelle sono escluse nelle impostazioni della Cartella Messaggi
+  * La creazione automatica dei contatti è disabilitata (le email necessitano di record Twenty esistenti)
+  * L'email è di colleghi (stesso dominio) o liste di gruppo
+  * La casella di posta sta ancora completando la sincronizzazione iniziale
+
+### Limitazioni delle email
+
+* **Cartelle di sistema**: Alcune cartelle email potrebbero non essere disponibili per la sincronizzazione
+* **Alias**: Solo le vere caselle di posta possono essere connesse (non gli alias email)

packages/twenty-docs/l/it/user-guide/calendar-emails/how-tos/can-i-book-meetings-from-twenty.mdx

@@ -0,0 +1,25 @@
+---
+title: Posso prenotare riunioni da Twenty?
+description: Informazioni sulla prenotazione di riunioni direttamente da Twenty.
+---
+
+## Stato attuale
+
+L'integrazione del calendario di Twenty è progettata per **sincronizzare e visualizzare** gli eventi esistenti del tuo calendario.
+
+## Pianificazione di riunioni tramite flussi di lavoro
+
+Anche se non è possibile programmare le riunioni manualmente, è possibile pianificarle in Twenty utilizzando i flussi di lavoro.
+
+1. Crea un nuovo flusso di lavoro
+2. Seleziona un trigger in base alle tue esigenze
+3. Aggiungi il nodo **Create Calendar Event**
+4. Configura tutti i dati necessari
+5. Attiva il flusso di lavoro
+
+## Cosa puoi fare
+
+* **Visualizzare la cronologia delle riunioni** sui record di Persone, Aziende e Opportunità
+* **Vedere le riunioni in arrivo** con i contatti nel tuo CRM
+* **Tenere traccia del contesto delle riunioni** insieme alle comunicazioni email
+* **Creare automaticamente contatti** dai partecipanti alle riunioni

packages/twenty-docs/l/it/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx

@@ -0,0 +1,53 @@
+---
+title: Posso inviare email da Twenty?
+description: Informazioni sull'invio di email direttamente da Twenty.
+---
+
+## Stato attuale
+
+L'integrazione email di Twenty è progettata per **sincronizzare e visualizzare** la cronologia delle tue email, oltre a consentirti di comporre e inviare email.
+
+Quando visualizzi una conversazione email nella pagina di un record e fai clic su **Rispondi**, puoi comporre e inviare direttamente un'email.
+
+## Come inviare un messaggio da Twenty
+
+Prerequisito: un account di posta connesso con la possibilità di inviare email
+
+1. Apri il menu Comando con la scorciatoia **Ctrl+K** o **Cmd+K**
+2. Fare clic sull'opzione "Componi email"
+3. Scegli destinatari, aggiungi oggetto, corpo e allegati alla tua email
+4. Fare clic sul pulsante "Invia" per inviare l'email
+
+## Cosa puoi fare oggi
+
+* **Visualizzare la cronologia delle email** sui record di Persone, Aziende e Opportunità
+* **Leggere le conversazioni email complete** con i contatti nel tuo CRM
+* **Tenere traccia del contesto delle comunicazioni** accanto agli eventi del calendario
+* **Creare automaticamente contatti** dalle interazioni email
+* **Rispondere tramite reindirizzamento** — fai clic su Rispondi per passare alla tua casella di posta
+
+## Invio di email tramite flussi di lavoro
+
+È **possibile inviare email automaticamente utilizzando flussi di lavoro**. Questo è utile per:
+
+* Follow-up automatizzati
+* Notifiche ai contatti
+* Comunicazioni attivate in base alle modifiche dei record
+
+Le email inviate tramite flussi di lavoro passano attraverso l'account della casella di posta collegato.
+
+→ Scopri di più sull'[azione Invia email](/l/it/user-guide/workflows/capabilities/workflow-actions#send-email)
+
+## Sequenze di email e newsletter
+
+Per le sequenze di email e le newsletter, consigliamo di usare i flussi di lavoro per collegare Twenty a uno strumento dedicato di email marketing.
+
+<Warning>
+Le email di massa non dovrebbero essere inviate direttamente dalla tua casella di posta per proteggere la reputazione del tuo dominio. Usa uno strumento dedicato per le comunicazioni in massa.
+</Warning>
+
+→ Vedi [Come inviare email dai flussi di lavoro](/l/it/user-guide/workflows/capabilities/send-emails-from-workflows) per le istruzioni di configurazione
+
+## Piani futuri
+
+La composizione nativa delle email direttamente da Twenty è nella nostra roadmap. Partecipa alle nostre [discussioni su GitHub](https://github.com/twentyhq/twenty/discussions) per condividere il tuo caso d'uso e aiutarci a dare priorità a questa funzionalità.

packages/twenty-docs/l/it/user-guide/calendar-emails/how-tos/can-i-track-email-activity-on-all-objects.mdx

@@ -0,0 +1,35 @@
+---
+title: Posso monitorare l'attività email su tutti gli oggetti?
+description: Comprendere il tracciamento dell'attività email tra i diversi oggetti.
+---
+
+## Oggetti supportati
+
+L'attività email è attualmente disponibile su **tre oggetti standard**:
+
+| Oggetto         | Cosa vedrai                                                              |
+| --------------- | ------------------------------------------------------------------------ |
+| **Persone**     | Tutte le email scambiate con quel contatto specifico                     |
+| **Aziende**     | Tutte le email con chiunque di quella azienda (in base al dominio email) |
+| **Opportunità** | Email relative all'azienda collegata all'opportunità                     |
+
+## Perché solo questi oggetti?
+
+Persone, Aziende e Opportunità sono gli oggetti relazionali principali in cui il contesto delle email offre il maggior valore. I thread email vengono collegati automaticamente in base a:
+
+* **Indirizzo email** → associato ai record delle Persone
+* **Dominio email** → associato ai record delle Aziende
+* **Relazione con l'Azienda** → collegata alle Opportunità
+
+## Oggetti personalizzati
+
+**Il tracciamento delle email non è disponibile sugli oggetti personalizzati** al momento.
+
+Se ti serve il contesto delle email su un oggetto personalizzato, valuta:
+
+* Usare un campo relazione per collegare il tuo oggetto personalizzato a Persone o Aziende
+* Visualizzare la cronologia delle email sul record della Persona o dell'Azienda collegato.
+
+## Piani futuri
+
+Stiamo valutando di estendere la visibilità delle email agli oggetti personalizzati. Partecipa alle nostre [discussioni su GitHub](https://github.com/twentyhq/twenty/discussions) per condividere il tuo caso d'uso e aiutarci a dare priorità a questa funzionalità.

packages/twenty-docs/l/it/user-guide/calendar-emails/how-tos/connect-several-mailboxes-per-user.mdx

@@ -0,0 +1,42 @@
+---
+title: Collega più caselle di posta per utente
+description: Collega più account email per un singolo utente.
+---
+
+## Panoramica
+
+Twenty supporta **account email illimitati per utente**. Questo è utile se gestisci più caselle di posta, ad esempio:
+
+* Email di lavoro personale + casella di posta condivisa del team
+* Più indirizzi email rivolti ai clienti
+* Account email diversi per ruoli diversi
+
+## Come aggiungere più caselle di posta
+
+1. Vai a **Impostazioni → Account**
+2. Clicca su **Aggiungi account**
+3. Collega un account Google o Microsoft aggiuntivo, o qualsiasi altro provider di posta che supporti i protocolli IMAP/SMTP
+4. Configura le impostazioni di sincronizzazione per questa casella di posta
+5. Ripeti per ogni casella di posta che desideri collegare
+
+## Gestire più account
+
+Ogni casella di posta collegata ha le proprie impostazioni:
+
+* **Visibilità email**: Scegli cosa possono vedere i membri del team
+* **Creazione automatica dei contatti**: Abilita/disabilita per casella di posta
+* **Selezione delle cartelle**: Scegli quali cartelle sincronizzare
+
+## Come vengono visualizzate le email
+
+Le email di tutte le caselle di posta collegate vengono sincronizzate con Twenty e appaiono su:
+
+* **Record persone**: In base all'indirizzo email del contatto
+* **Record aziende**: In base al dominio email
+* **Opportunità**: In base all'azienda collegata
+
+<Note>Ogni email indica da quale casella è stata inviata o in quale è stata ricevuta, così puoi tracciare quale account è stato utilizzato per ogni comunicazione.</Note>
+
+## Note importanti
+
+<Warning>Possono essere collegate solo caselle di posta effettive. Gli alias email che inoltrano a un'altra casella di posta non possono essere collegati separatamente — si sincronizzeranno tramite la casella di posta principale.</Warning>

packages/twenty-docs/l/it/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records.mdx

@@ -0,0 +1,53 @@
+---
+title: Non vedo le email nei record
+description: Risoluzione dei problemi delle email mancanti nei record.
+---
+
+## Cause comuni
+
+### 1. Sincronizzazione iniziale ancora in corso
+
+La sincronizzazione delle email richiede tempo, soprattutto per le caselle di posta di grandi dimensioni. Twenty importa email a circa **400 messaggi al minuto** (limitato dal rate limiting dell'API di Gmail).
+
+* **Sincronizzazione del calendario**: si completa in pochi minuti
+* **Sincronizzazione delle email**: dipende dalla dimensione della casella (es., 10.000 email ≈ 25 minuti, 50.000 email ≈ 2 ore)
+
+**Soluzione**: Attendi il completamento dell'importazione iniziale. Puoi stimare i tempi in base alla dimensione della tua casella di posta.
+
+### 2. Il contatto non esiste in Twenty
+
+Le email compaiono solo nei record Persona esistenti. Se il contatto non è stato ancora creato:
+
+* Abilita la **Creazione automatica dei contatti** nelle impostazioni della tua casella di posta
+* Oppure crea prima manualmente il record Persona
+
+**Soluzione**: Vai su **Impostazioni → Account**, seleziona la tua casella di posta e abilita la creazione automatica dei contatti.
+
+### 3. Le email interne sono escluse
+
+Le email tra colleghi (stesso dominio email) non vengono mai sincronizzate per mantenere la privacy.
+
+**Soluzione**: Questo è il comportamento previsto. Vengono sincronizzate solo le email esterne.
+
+### 4. L'email proviene da un gruppo o da una lista di distribuzione
+
+Le email di gruppo e le liste di distribuzione sono escluse dalla sincronizzazione.
+
+**Soluzione**: Questo è il comportamento previsto.
+
+### 5. Cartella non selezionata per la sincronizzazione
+
+Se stai usando la funzionalità Cartella messaggi, alcune cartelle potrebbero essere escluse.
+
+**Soluzione**: Vai su **Impostazioni → Account**, seleziona la tua casella di posta e controlla le impostazioni di sincronizzazione delle cartelle.
+
+### 6. Indirizzo email errato nel record
+
+Il record Persona potrebbe avere un indirizzo email diverso da quello usato nell'email.
+
+**Soluzione**: Aggiungi l'indirizzo email corretto al record Persona.
+
+## Non funziona ancora?
+
+1. Prova a disconnettere e riconnettere la tua casella di posta
+2. Contatta il supporto se i problemi persistono

packages/twenty-docs/l/it/user-guide/calendar-emails/how-tos/limit-emails-imported.mdx

@@ -0,0 +1,58 @@
+---
+title: Email Limite Importate
+description: Controlla quali email vengono importate in Twenty.
+---
+
+## Panoramica
+
+Per impostazione predefinita, Twenty sincronizza tutte le email esterne dalla tua casella di posta collegata. Puoi limitare ciò che viene importato utilizzando la **selezione delle cartelle** e le **impostazioni di visibilità**.
+
+## Metodo 1: Selezione delle cartelle (consigliato)
+
+Controlla quali cartelle email sincronizzano con Twenty:
+
+1. Vai su **Impostazioni → Account**
+2. Seleziona il tuo account email collegato
+3. Scegli quali cartelle sincronizzare:
+
+| Cartella                    | Descrizione                               |
+| --------------------------- | ----------------------------------------- |
+| **Posta in arrivo**         | Email in arrivo principali                |
+| **Posta inviata**           | Email in uscita che hai inviato           |
+| **Archivio**                | Messaggi archiviati                       |
+| **Cartelle personalizzate** | Qualsiasi cartella specifica che desideri |
+
+4. Escludi le cartelle che non vuoi sincronizzare (Spam, Cestino, cartelle personali)
+
+<Note>Questo ti offre un controllo preciso su quali email compaiono nel tuo CRM senza sincronizzare tutto.</Note>
+
+## Metodo 2: Impostazioni per la creazione automatica dei contatti
+
+Controlla quando i contatti vengono creati dalle email:
+
+1. Vai a **Impostazioni → Account**
+2. Seleziona la tua casella di posta collegata
+3. Scegli un'opzione:
+   * **Disattivato**: Non vengono creati contatti, ma le email si sincronizzano comunque con i contatti esistenti
+   * **Inviati e ricevuti**: Crea contatti da tutte le email esterne
+   * **Solo inviati**: Crea contatti solo dalle email che invii
+
+## Email interne
+
+I messaggi tra colleghi (stesso dominio) possono essere sincronizzati in Twenty:
+
+1. Vai a **Impostazioni → Generale → Sicurezza**
+2. Attiva/disattiva **Sincronizza email interne**
+
+<Note>Per impostazione predefinita, questa opzione è disattivata.</Note>
+
+## Cosa viene sempre escluso
+
+Queste email non vengono mai sincronizzate, indipendentemente dalle impostazioni:
+
+* **Email di gruppo**: Liste di distribuzione e messaggi di gruppo
+* **Spam/Cestino**: Le cartelle di sistema sono generalmente escluse
+
+## Nota importante
+
+<Note>Al momento non forniamo ancora un indirizzo email di CC per la sincronizzazione selettiva. Usa la funzione di selezione delle cartelle sopra per ottenere lo stesso livello di controllo.</Note>

packages/twenty-docs/l/it/user-guide/calendar-emails/overview.mdx

@@ -0,0 +1,144 @@
+---
+title: Calendario & Email
+description: Collega i tuoi account email e calendario a Twenty.
+---
+
+## Opzioni di Connessione
+
+### Account Google (Gmail & Google Calendar)
+
+1. Vai a **Impostazioni → Account**
+2. Clicca su **Aggiungi account**
+3. Seleziona **Continua con Google**
+4. Autorizza Twenty ad accedere al tuo Gmail e Google Calendar
+5. Configura le impostazioni di sincronizzazione delle email (visibilità, creazione automatica) → fai clic su **Avanti**
+6. Configura le impostazioni di sincronizzazione del calendario (visibilità, creazione automatica) → fai clic su **Aggiungi account**
+7. Le tue email e gli eventi del calendario inizieranno a sincronizzarsi automaticamente
+
+### Account Microsoft (Outlook & Microsoft Calendar)
+
+1. Vai a **Impostazioni → Account**
+2. Clicca su **Aggiungi account**
+3. Seleziona **Continua con Microsoft**
+4. Autorizza Twenty ad accedere al tuo Outlook e Microsoft Calendar
+5. Configura le impostazioni di sincronizzazione delle email (visibilità, creazione automatica) → fai clic su **Avanti**
+6. Configura le impostazioni di sincronizzazione del calendario (visibilità, creazione automatica) → fai clic su **Aggiungi account**
+7. Le tue email e gli eventi del calendario inizieranno a sincronizzarsi automaticamente
+
+### Configurazione IMAP/SMTP/CalDAV (Altri Fornitori)
+
+Per altri fornitori di email e calendario:
+
+1. Vai a **Impostazioni → Account**
+2. Configura le impostazioni IMAP per sincronizzare le email in arrivo e le impostazioni SMTP per inviare email
+3. Configura le impostazioni CalDAV per il calendario
+4. Testa la connessione
+
+<Note>
+**Self-hosting su una rete air-gapped o interna**: Per impostazione predefinita, Twenty rifiuta le connessioni in uscita verso indirizzi IP privati/interni (protezione SSRF). Se il tuo server di posta o calendario è in esecuzione su un IP locale/privato (ad es. un server on-premise su una LAN), le connessioni verso di esso verranno bloccate. Per consentirle, imposta la seguente variabile di ambiente sul server:
+
+```
+OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
+```
+
+Questo disabilita la modalità sicura per **tutte** le richieste in uscita (azioni del flusso di lavoro HTTP, webhook e connessioni IMAP/SMTP/CalDAV), quindi impostalo solo su reti affidabili e isolate in cui la protezione SSRF non è necessaria.
+</Note>
+
+### Caselle Multiple
+
+* **Account Illimitati**: Collega vari account email per utente
+* **Gestione Account**: Passa tra diverse caselle di posta
+* **Impostazioni di Sincronizzazione**: Configura impostazioni differenti per ciascuna casella
+
+<Warning>
+Solo vere caselle di posta possono essere collegate (es. supporto@dominio.com con la propria inbox). Alias email che inoltrano ad un'altra casella non possono essere collegati a Twenty.
+</Warning>
+
+## Configurazione Email
+
+### Visibilità Messaggi
+
+Scegli diversi livelli di visibilità per le tue email:
+
+* **Solo Metadati**: Condividi solo informazioni di base (mittente, destinatario, data, ora)
+* **Oggetto e Metadati**: Condividi l'oggetto insieme ai metadati
+* **Tutto il Contenuto dell'Email**: Condividi l'intero contenuto dell'email inclusi gli allegati
+
+### Creazione Automatica Contatti
+
+* **Disattivato**: Nessuna creazione automatica di contatti
+* **Per i messaggi inviati e ricevuti**: Crea contatti per tutte le interazioni e-mail esterne
+* **Solo per messaggi inviati**: Crea contatti solo per email che invii
+* **Nota**: Per impostazione predefinita, le email interne (quando tutti i partecipanti condividono il tuo dominio) non vengono sincronizzate per proteggere la privacy
+
+<Note>Quando è attivata, i contatti vengono collegati automaticamente ai relativi record di Azienda in base al loro dominio email. Se l'Azienda non esiste ancora, Twenty la crea per te.</Note>
+
+<Note>
+**Sincronizzazione delle email interne**: Il comportamento "email interne non sincronizzate" è l’impostazione predefinita, ma può essere disattivato. L’interruttore si trova nelle impostazioni avanzate:
+1. Apri **Impostazioni** e abilita l’interruttore **Avanzate** in fondo alla pagina delle impostazioni
+2. Vai a **Generale → Sicurezza**
+3. Abilita l’interruttore **Sincronizza email interne** per includere le email in cui tutti i partecipanti condividono lo stesso dominio
+
+Questa è un’impostazione valida per l’intero spazio di lavoro (utile per università o organizzazioni con dominio condiviso).
+</Note>
+
+### Controlla quali email vengono sincronizzate con la Selezione Cartelle Messaggi
+
+Controlla quali cartelle email sincronizzano con Twenty:
+
+1. Vai a **Impostazioni → Account** e seleziona il tuo account email collegato
+2. Scegli quali cartelle sincronizzare:
+   * **Posta in Arrivo**: Email in entrata principali
+   * **Inviati**: Email in uscita che hai inviato
+   * **Cartelle Personalizzate**: Qualsiasi cartella specifica che vuoi includere
+   * **Escludi Cartelle**: Salta cartelle come Spam, Cestino o cartelle personali
+
+Questo ti offre un controllo preciso su quali email appaiono nel tuo CRM senza sincronizzare tutto.
+
+**Cosa viene sincronizzato:**
+
+* **Email Esterne**: Tutte le email con contatti esterni dalle cartelle selezionate
+* **Email Interne**: Non sincronizzate per impostazione predefinita (le email dello stesso dominio rimangono private). Abilita l’interruttore **Avanzate** in fondo a **Impostazioni**, quindi attiva **Sincronizza email interne** in **Generale → Sicurezza** per includerle a livello di spazio di lavoro.
+* **Allegati**: In arrivo nel H1 2026
+
+**Nota**: Non forniamo un indirizzo email CC per la sincronizzazione selettiva. Invece, usa la funzionalità Cartella Messaggi sopra per ottenere lo stesso livello di controllo su quali email sincronizzano con Twenty.
+
+## Configurazione Calendario
+
+### Visibilità Eventi
+
+Scegli cosa sarà visibile ad altri utenti nel tuo spazio di lavoro:
+
+* **Tutto**: I dettagli dell'evento saranno condivisi con il tuo team
+* **Metadata**: Solo data e partecipanti saranno condivisi con il tuo team
+
+### Creazione Automatica Contatti per Riunioni
+
+* **Sì**: Crea automaticamente contatti per i partecipanti alle riunioni non nel tuo CRM
+* **No**: Collega solo le riunioni ai contatti esistenti
+
+<Note>Quando è attivata, i contatti vengono collegati automaticamente ai relativi record di Azienda in base al loro dominio email. Se l'Azienda non esiste ancora, Twenty la crea per te.</Note>
+
+### Controlla quali eventi vengono sincronizzati
+
+* **Importazione Riunioni**: Importa automaticamente gli eventi del calendario
+* **Collegamento Contatti**: Collega le riunioni ai record di Persone e Aziende
+
+**Cosa viene sincronizzato:**
+
+* **Riunioni**: Eventi del calendario con partecipanti esterni
+* **Collegamento Contatti**: Eventi collegati automaticamente ai record CRM
+* **Eventi di Team**: Visibilità del calendario condiviso
+
+## Frequenza di Sincronizzazione
+
+**Aggiornamenti ogni 5 minuti**: Sia i dati delle email che del calendario vengono sincronizzati automaticamente ogni 5 minuti dopo l'importazione iniziale.
+
+<Note>
+**Tempistiche di sincronizzazione iniziale**: La sincronizzazione del calendario si completa rapidamente (di solito in pochi minuti), mentre la sincronizzazione delle email richiede più tempo per le caselle di posta di grandi dimensioni. Twenty importa email a circa **400 messaggi al minuto** (limitato dal rate limiting dell'API di Gmail), quindi una casella di posta con 10.000 email impiega circa 25 minuti. Non preoccuparti se vedi contatti provenienti dagli eventi del calendario apparire prima dei tuoi contatti email; è un comportamento normale.
+</Note>
+
+## Prossimi Passi
+
+* [Funzionalità della casella di posta](/l/it/user-guide/calendar-emails/capabilities/mailbox)
+* [Risolvi i problemi delle email mancanti](/l/it/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records)

packages/twenty-docs/l/it/user-guide/dashboards/capabilities/chart-settings.mdx

@@ -0,0 +1,275 @@
+---
+title: Impostazioni del grafico
+description: Configura i tuoi grafici per visualizzare i dati esattamente come ti serve.
+---
+
+import { ChartIcon } from '/snippets/chart-icon.mdx';
+
+## Accesso alle impostazioni del grafico
+
+1. Fai clic sul pulsante **Modifica** nell'angolo in alto a destra della dashboard
+
+<img src="/images/user-guide/dashboard/dashboard-edit.png" alt="Modalità modifica" />
+
+2. La dashboard entra in modalità modifica
+3. Fai clic su qualsiasi widget per selezionarlo
+4. Il pannello delle impostazioni si apre a destra
+
+Le impostazioni sono organizzate in sezioni:
+
+* **Dati**: quali dati recuperare e come filtrarli
+* **Asse X**: come raggruppare e ordinare le categorie (grafici a barre/a linee)
+* **Asse Y**: cosa misurare e come visualizzarlo (grafici a barre/a linee)
+* **Stile**: colori, etichette e opzioni di visualizzazione
+
+<Note>
+Alcune impostazioni compaiono solo quando ne sono configurate altre. Ad esempio, **Granularità della data** compare solo quando selezioni un campo data.
+</Note>
+
+---
+
+## Impostazioni dati
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="database" />Origine </span>
+
+Scegli da quale oggetto recuperare i dati.
+
+1. Fai clic su **Origine**
+2. Seleziona un oggetto (Opportunità, Persone, Aziende, ecc.)
+
+Tutti i tuoi oggetti standard e personalizzati sono disponibili. Modificare l'origine reimposta le altre impostazioni, poiché le opzioni dei campi dipendono dall'oggetto selezionato.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-source.png" alt="Fonte" />
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filter" />Filtro </span>
+
+Limita quali record sono inclusi nel grafico.
+
+1. Fai clic su **Filtro**
+2. Si apre il generatore di filtri
+3. Fai clic su **+ Aggiungi filtro**
+4. Seleziona un campo, una condizione e un valore
+5. Aggiungi altri filtri secondo necessità
+
+I filtri funzionano come nelle viste tabellari. Usali per concentrarti su segmenti specifici dei tuoi dati.
+
+**Esempio**: filtra le opportunità in cui la Fase è uguale a "Vinta" per mostrare solo le trattative chiuse.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-filters.png" alt="Filtro" />
+
+<Tip>
+Per i campi data, prova **È relativo** per creare filtri dinamici come "Ultimi 7 giorni" o "Questo mese" che si aggiornano automaticamente.
+</Tip>
+
+<Tip>
+Sono supportati filtri avanzati: aggiungi più regole di filtro e combinane la logica con **E** o **O**.
+</Tip>
+
+---
+
+## Impostazioni asse X
+
+Queste impostazioni controllano l'asse orizzontale dei grafici a barre e a linee: in genere come i dati vengono raggruppati in categorie.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-x" />Dati visualizzati </span>
+
+Seleziona il campo in base al quale raggruppare i dati. Questo determina le categorie mostrate sull'asse X.
+
+**Esempio**: seleziona "Fase" per vedere i dati raggruppati per fase della pipeline oppure "Data di creazione" per vedere i dati nel tempo.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-data-on-display.png" alt="Dati visualizzati" />
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />Granularità della data </span>
+
+Quando raggruppi per un campo data, scegli il periodo temporale per il raggruppamento.
+
+| Opzione                    | Raggruppa i dati per               | Esempio di output                                        |
+| -------------------------- | ---------------------------------- | -------------------------------------------------------- |
+| **Giorno**                 | Ogni giorno di calendario          | 1 gen, 2 gen, 3 gen...                                   |
+| **Settimana**              | Settimane di calendario            | Settimana 1, Settimana 2, Settimana 3...                 |
+| **Mese**                   | Mesi di calendario                 | gennaio, febbraio, marzo...                              |
+| **Trimestre**              | Trimestri fiscali                  | T1, T2, T3, T4                                           |
+| **Anno**                   | Anni di calendario                 | 2023, 2024, 2025                                         |
+| **Giorno della settimana** | Giorno della settimana (aggregato) | lunedì, martedì... (tutti i lunedì combinati)            |
+| **Mese dell'anno**         | Mese (aggregato)                   | gennaio, febbraio... (tutti i mesi di gennaio combinati) |
+| **Trimestre dell'anno**    | Trimestre (aggregato)              | T1, T2, T3, T4 (tutti i T1 combinati)                    |
+
+Le opzioni "della settimana/dell'anno" aggregano su tutto il periodo. Usa **Giorno della settimana** per vedere quale giorno della settimana in genere ottiene più trattative. Usa **Mese** per vedere le tendenze mese per mese.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />Ordina per </span>
+
+Controlla l'ordine delle categorie sull'asse X.
+
+* **Posizione** – usa l'ordine definito nelle impostazioni del campo Selezione
+* **Alfabetico** – dalla A alla Z (o cronologico per le date)
+* **Per valore** – ordinato per metrica (prima il più alto o il più basso)
+* **Manuale** – trascina per impostare un ordine personalizzato
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-sort.png" alt="Ordina per" />
+
+**Suggerimento**: per le fasi della pipeline, usa **Posizione** per mostrare le fasi nell'ordine del processo di vendita (Lead → Qualificata → Proposta → Vinta).
+
+<Note>
+Le opzioni mostrate dipendono dal tipo di campo. I campi Selezione hanno tutte le opzioni; i campi data e testo ne mostrano di meno.
+</Note>
+
+<Tip>
+Con l'ordinamento **Manuale**, trascina le categorie per creare un ordine personalizzato: perfetto per evidenziare segmenti specifici o raccontare una storia con i tuoi dati.
+</Tip>
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="eye-off" />Ometti i valori zero </span>
+
+Nascondi le categorie che hanno zero dati o nessun dato.
+
+* **Attivo**: le categorie senza record vengono nascoste
+* **Disattivo**: tutte le categorie vengono mostrate, anche se vuote
+
+Usalo per ripulire grafici con dati scarsi.
+
+---
+
+## Impostazioni asse Y
+
+Queste impostazioni controllano cosa stai misurando e come viene visualizzato.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-y" />Dati visualizzati </span>
+
+Seleziona il campo e l'operazione per calcolare la tua metrica.
+
+* **Conteggi** – Conta tutti, Conta vuoti, Conta non vuoti, Conta valori univoci
+* **Matematica** – Somma, Media, Min, Max (campi numerici)
+* **Percentuali** – Percentuale vuoti, Percentuale non vuoti
+
+I campi booleani aggiungono Conta vero/falso. I grafici aggregati con campi data mostrano Più antico/Più recente.
+
+**Esempio**: seleziona "Importo" con Somma per vedere il valore totale delle trattative per categoria, oppure Conta tutti per vedere il numero di trattative.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-data-on-display.png" alt="Dati visualizzati" />
+
+<Note>
+Le opzioni mostrate dipendono dal tipo di campo e di grafico. Se non vedi un'operazione prevista, verifica il tipo di campo.
+</Note>
+
+### Rapporto
+
+Per i campi Selezione, Selezione multipla o Booleano, puoi calcolare la percentuale di un valore specifico.
+
+1. Seleziona un campo di tipo Selezione, Selezione multipla o Booleano
+2. Abilita **Rapporto**
+3. Scegli l'opzione da misurare
+
+**Esempio**: mostra le trattative "Vinte" come percentuale di tutte le opportunità. Se hai 10 Vinte su 50 totali, il grafico mostra il 20%.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filters" />Raggruppa per </span>
+
+Aggiungi una seconda dimensione per creare più serie (più barre o linee).
+
+1. Imposta prima il campo dell'asse X
+2. Fai clic su **Raggruppa per**
+3. Seleziona un secondo campo
+
+**Esempio**: raggruppa le trattative per Fase (asse X) E per Proprietario (Raggruppa per) per vedere affiancato il dettaglio della pipeline di ciascuna persona.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-group-by.png" alt="Raggruppa per" />
+
+Quando Raggruppa per è impostato, vedrai più colori nel grafico e comparirà una legenda.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />Granularità della data </span>
+
+Quando Raggruppa per è un campo data, scegli il periodo temporale (stesse opzioni dell'asse X).
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />Ordina per </span>
+
+Quando **Raggruppa per** è impostato, controlla l'ordine delle serie raggruppate (ad es., quale barra del proprietario appare per prima in ogni categoria).
+
+Stesse opzioni dell'ordinamento dell'asse X — Posizione, Alfabetico e Manuale — tranne che **l'ordinamento basato sul valore non è disponibile** per il raggruppamento secondario.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="chart-bar-popular" />Cumulativo </span>
+
+Mostra totali progressivi invece dei valori individuali.
+
+* **Disattivo**: ogni barra/punto mostra il proprio valore
+* **Attivo**: ogni barra/punto mostra la somma di tutti i valori precedenti più il proprio
+
+**Esempio**: gennaio = 10, febbraio = 15
+
+* Cumulativo disattivo: mostra 10 e 15
+* Cumulativo attivo: mostra 10 e 25 (10 + 15)
+
+Usa il cumulativo per monitorare i progressi verso un obiettivo nel tempo.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-cumulative.png" alt="Cumulativo" />
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="math-min" />Intervallo minimo / <ChartIcon icon="math-max" />Intervallo massimo </span>
+
+Imposta valori minimi e massimi fissi per l'asse Y.
+
+* Lascia vuoto per la scalatura automatica
+* Inserisci un numero per fissare il limite
+
+**Quando usarlo:**
+
+* Imposta Min a 0 per confronti visivi accurati
+* Imposta entrambi per scale coerenti su più grafici
+* Concentrati su un intervallo di valori specifico impostando entrambi
+
+---
+
+## Impostazioni stile
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="color-swatch" />Colori </span>
+
+Imposta la combinazione di colori per il grafico. Scegli tra una varietà di palette di colori.
+
+<Note>
+Quando raggruppi per un campo Selezione, il grafico usa automaticamente i colori definiti per ogni opzione nelle impostazioni del campo.
+</Note>
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="gizmo" />Nome asse </span>
+
+Scegli quali etichette degli assi mostrare: **Nessuno**, **Asse X**, **Asse Y** o **Entrambi** (solo grafici a barre e a linee).
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="stack-2" />Barre impilate / Linee impilate </span>
+
+Quando Raggruppa per è impostato, scegli come visualizzare le serie multiple.
+
+* **Disattivo (Raggruppate)**: le serie appaiono affiancate. Usa quando confronti valori esatti tra gruppi.
+* **Attivo (Impilate)**: le serie si impilano una sull'altra. Usa quando mostri la composizione, cioè come le parti costituiscono un insieme.
+
+**Esempio**: trattative per fase, raggruppate per proprietario
+
+* Raggruppate: vedi i numeri esatti di ciascun proprietario affiancati
+* Impilate: vedi il totale delle trattative per fase, con il contributo di ciascun proprietario impilato
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="badge-2k" />Etichette dati </span>
+
+Mostra i valori direttamente sugli elementi del grafico (barre, punti, sezioni).
+
+* **Attivo**: i valori compaiono nel grafico
+* **Disattivo**: nessun valore mostrato (aspetto più pulito)
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="text-caption" />Legenda </span>
+
+Mostra o nascondi la legenda (compare solo quando Raggruppa per è impostato).
+
+* **Attivo**: la legenda mostra cosa rappresenta ciascun colore
+* **Disattivo**: nessuna legenda visualizzata
+
+<Tip>
+**Passa il mouse** su un elemento della legenda per evidenziare quel gruppo. **Fai clic** per nasconderlo temporaneamente dal grafico.
+</Tip>
+
+---
+
+## Note specifiche del grafico
+
+### Grafici a torta
+
+* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="chart-pie" size={16} /></span> **Ogni fetta rappresenta** – Definisci come vengono raggruppate le fette
+* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="eye-off" size={16} /></span> **Nascondi categoria vuota** – Rimuovi le fette a valore zero
+* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="number-123" size={16} /></span> **Mostra il valore al centro** – Visualizza il valore aggregato (somma, media, conteggio, ecc.)
+
+### Grafici aggregati
+
+* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-left" size={16} /></span> **Prefisso** – Aggiungi testo prima del numero (ad es., `$`)
+* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-right" size={16} /></span> **Suffisso** – Aggiungi testo dopo il numero (ad es., `%`)

packages/twenty-docs/l/it/user-guide/dashboards/capabilities/dashboards.mdx

@@ -0,0 +1,92 @@
+---
+title: Cruscotti
+description: Crea e organizza cruscotti con schede per visualizzare i tuoi dati CRM.
+---
+
+## Panoramica
+
+I cruscotti in Twenty sono organizzati in una gerarchia: **Cruscotti → Schede → Widget**. Ogni cruscotto può contenere più schede e ogni scheda contiene widget (grafici, numeri, iFrame).
+
+## Creare un cruscotto
+
+1. Vai a **Cruscotti** nella navigazione
+2. Fai clic su **+ Nuovo record**
+
+<img src="/images/user-guide/dashboard/dashboard-create-new.png" alt="Crea un nuovo cruscotto" />
+
+3. Assegna un nome al tuo cruscotto
+4. Inizia ad aggiungere schede e widget
+
+## Lavorare con le schede
+
+Le schede ti aiutano a organizzare il tuo cruscotto in sezioni logiche.
+
+### Creare schede
+
+1. In modalità modifica, fare clic su **+** nella barra delle schede, e un pannello laterale si aprirà a destra
+2. Assegna un nome alla scheda (ad es., "Panoramica della pipeline", "Prestazioni del team")
+3. Aggiungi widget alla scheda
+
+### Riordinare le schede
+
+1. In modalità modifica, fai clic e tieni premuto sulla scheda che desideri spostare
+2. Trascina e rilascia nella nuova posizione
+3. Puoi anche fare clic sulla scheda e usare il menu dei comandi per spostare la scheda a sinistra o a destra
+
+### Eliminare le schede
+
+1. In modalità modifica, fai clic sulla scheda che vuoi eliminare
+2. Fai clic sul pulsante **Elimina** nel menu dei comandi
+
+### Duplicare le schede
+
+1. Fai clic sulla scheda che vuoi duplicare
+2. Fai clic sul pulsante **Duplica** nel pannello laterale
+
+<img src="/images/user-guide/dashboard/dashboard-tabs.png" alt="Scheda del cruscotto" />
+
+## Layout del cruscotto
+
+### Disporre i widget
+
+* Trascina e rilascia per posizionare
+* Ridimensiona per mettere in evidenza
+* Raggruppa i grafici correlati
+
+### Duplicare un cruscotto
+
+1. Seleziona il cruscotto che vuoi duplicare
+2. Apri la barra dei comandi con **Cmd + K** (oppure **Ctrl + K** su Windows)
+3. Seleziona **Duplica cruscotto**
+
+<img src="/images/user-guide/dashboard/dashboard-duplicate.png" alt="Duplica un cruscotto" />
+
+### Migliori Pratiche
+
+* **Flusso logico**: disponi dalla panoramica al dettaglio
+* **Gerarchia visiva**: grafici più grandi per le metriche chiave
+* **Stile coerente**: usa colori e caratteri coordinati
+
+## Visibilità e accesso
+
+### Visibilità del cruscotto
+
+I cruscotti sono visibili a chiunque abbia accesso al tuo spazio di lavoro Twenty. Al momento non è disponibile un'opzione di cruscotto privato.
+
+### Preferiti
+
+Puoi aggiungere i cruscotti ai preferiti per un accesso rapido. Si tratta di un'impostazione personale—i tuoi preferiti non sono visibili agli altri utenti.
+
+Per aggiungere un cruscotto ai preferiti, apri il cruscotto e fai clic sull'icona a stella.
+
+### Comportamento del fuso orario
+
+Attualmente i cruscotti mostrano i dati in base al fuso orario dell'utente che li visualizza. Ciò significa che lo stesso cruscotto può mostrare metriche diverse per i membri del team in regioni differenti (ad es., APAC vs. USA).
+
+<Note>
+**In arrivo**: aggiungeremo la possibilità di impostare un fuso orario specifico per un cruscotto, in modo che tutti gli utenti vedano dati coerenti indipendentemente dalla loro posizione.
+</Note>
+
+<Note>
+**In arrivo**: i filtri a livello di cruscotto ti permetteranno di applicare filtri a tutti i widget contemporaneamente, rendendo più veloce l'esplorazione dei tuoi dati.
+</Note>

packages/twenty-docs/l/it/user-guide/dashboards/capabilities/widgets.mdx

@@ -0,0 +1,169 @@
+---
+title: Widget
+description: Esplora i tipi di widget e le opzioni di visualizzazione in Twenty.
+---
+
+import { ChartIcon } from '/snippets/chart-icon.mdx';
+
+## Widget disponibili
+
+Twenty offre diversi tipi di widget per visualizzare i dati del tuo CRM.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-bar-popular" />Grafici a barre</span>
+
+Mostra i dati come barre orizzontali o verticali.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="Grafico a barre" />
+</Frame>
+
+**Ideali per:**
+
+* Confrontare i valori tra categorie
+* Mostrare classifiche
+* Monitorare le metriche per periodo di tempo
+
+**Esempi di utilizzo:**
+
+* Opportunità per fase
+* Ricavi per rappresentante commerciale
+* Contatti aggiunti per mese
+
+<Note>
+**Limiti di visualizzazione**: I grafici a barre possono mostrare al massimo 100 barre e, quando si usa Raggruppa per, 50 gruppi per barra. Se visualizzi l'avviso "Undisplayed data: max X bars per chart", aggiungi filtri per restringere i dati o modifica il raggruppamento (ad es., raggruppa per settimana invece che per giorni).
+</Note>
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-pie" />Grafici a torta</span>
+
+Mostra le proporzioni del totale.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="Grafico a torta" />
+</Frame>
+
+**Ideali per:**
+
+* Mostrare composizione o distribuzione
+* Confrontare le parti con il totale
+* Evidenziare i segmenti principali
+
+**Esempi di utilizzo:**
+
+* Distribuzione delle opportunità per fonte
+* Ripartizione dei contatti per settore
+* Composizione della pipeline per proprietario
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-line" />Grafici a linee</span>
+
+Mostra le tendenze nel tempo.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="Grafico a linee" />
+</Frame>
+
+**Ideali per:**
+
+* Monitorare i cambiamenti nel tempo
+* Individuare le tendenze
+* Confrontare più metriche
+
+**Esempi di utilizzo:**
+
+* Andamento mensile del numero di opportunità
+* Crescita dei ricavi per trimestre
+* Livelli di attività nel tempo
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="sum" />Grafici aggregati</span>
+
+Mostra in evidenza singoli valori chiave.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="Grafico aggregato" />
+</Frame>
+
+**Ideali per:**
+
+* Mettere in evidenza i KPI
+* Mostrare totali o medie
+* Controlli rapidi dello stato
+
+**Esempi di utilizzo:**
+
+* Valore totale della pipeline
+* Numero di opportunità aperte
+* Tasso di conversione
+
+**Opzioni avanzate:**
+
+* **Rapporto**: Per i campi di tipo Select, calcola i rapporti tra i valori. Vai a **Dati visualizzati** → seleziona il tuo campo → abilita l'opzione **Rapporto**.
+* **Prefisso e suffisso**: Aggiungi un testo personalizzato prima o dopo il numero (ad es., prefisso "$" o suffisso "%") per una migliore leggibilità.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="frame" />iFrames</span>
+
+Incorpora strumenti e contenuti esterni direttamente nella tua dashboard.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-table.png" alt="Grafico tabella" />
+</Frame>
+
+**Ideali per:**
+
+* Ricerca di singoli elementi
+* Verifica dei valori esatti
+* Revisione o riferimento
+
+**Esempi di utilizzo:**
+
+* Opportunità in chiusura questo mese
+* Nuovi lead di questa settimana
+* Fatture scadute
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="table" />Tabella</span>
+
+Visualizza i record filtrati direttamente nella tua dashboard.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
+</Frame>
+
+**Ideale per:**
+
+* Visualizzare report o dashboard esterni
+* Integrare strumenti di vendita di terze parti
+* Mostrare contenuti in tempo reale da altri sistemi
+
+**Esempi di utilizzo:**
+
+* Metriche dal tuo strumento di assistenza
+* Metriche dal tuo dialer
+* Contenuti in tempo reale dal tuo strumento per sequenze di vendita
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="align-box-left-top" />Testo formattato</span>
+
+Aggiungi testo formattato e contenuti direttamente alla tua dashboard.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="Testo formattato" />
+</Frame>
+
+**Ideale per:**
+
+* Aggiunta di contesto o istruzioni
+* Descrizioni della dashboard
+* Note e annotazioni
+
+**Funzionalità:**
+
+* Formattazione del testo (grassetto, corsivo, elenchi, ecc.)
+* Caricamento di immagini e file
+* Modifica in stile Markdown
+
+<Note>
+**In arrivo**: I grafici a indicatore non sono ancora disponibili ma sono nella nostra roadmap.
+</Note>
+
+### Duplicazione dei widget
+
+1. Fai clic sul widget
+2. Apri **Opzioni**
+3. Fai clic su **Duplica widget**

packages/twenty-docs/l/it/user-guide/dashboards/how-tos/dashboards-faq.mdx

@@ -0,0 +1,54 @@
+---
+title: Domande frequenti sui cruscotti
+description: Domande frequenti sui cruscotti in Twenty.
+---
+
+<AccordionGroup>
+  <Accordion title="Posso creare cruscotti privati?">
+    No, al momento i cruscotti sono visibili a chiunque abbia accesso al tuo spazio di lavoro Twenty. I cruscotti privati non sono ancora disponibili.
+  </Accordion>
+
+  <Accordion title="Perché le mie metriche sono diverse da quelle del mio collega?">
+    Attualmente i cruscotti mostrano i dati in base al fuso orario di chi li visualizza. Se vi trovate in regioni diverse (ad es., APAC vs. USA), potreste vedere numeri leggermente diversi per lo stesso cruscotto. Stiamo lavorando per aggiungere un'impostazione del fuso orario per ogni cruscotto, per garantire dati coerenti tra i team.
+  </Accordion>
+
+  <Accordion title="Posso esportare il mio cruscotto?">
+    L'esportazione dei cruscotti non è disponibile al momento. Questa funzionalità è nella nostra roadmap.
+  </Accordion>
+
+  <Accordion title="Posso condividere i cruscotti con utenti esterni?">
+    No, al momento la condivisione dei cruscotti con utenti esterni al tuo spazio di lavoro Twenty (utenti non Twenty) non è supportata.
+  </Accordion>
+
+  <Accordion title="Come faccio ad aggiungere un cruscotto ai miei preferiti?">
+    Apri il cruscotto che vuoi aggiungere ai preferiti, quindi fai clic sull'icona a stella. I preferiti sono personali: non influiscono sugli altri utenti.
+  </Accordion>
+
+  <Accordion title="Qual è la differenza tra schede e widget?">
+    * **Le schede** organizzano il tuo cruscotto in sezioni (come pagine all'interno del cruscotto)
+    * **I widget** sono le singole visualizzazioni (grafici, numeri, iFrame) all'interno di ogni scheda
+
+    Struttura: Cruscotto → Schede → Widget
+  </Accordion>
+
+  <Accordion title="Posso filtrare un intero cruscotto in una volta sola?">
+    I filtri a livello di cruscotto non sono ancora disponibili, ma questa funzionalità è nella nostra roadmap. Attualmente è necessario applicare i filtri a ciascun widget singolarmente.
+  </Accordion>
+
+  <Accordion title="I grafici a indicatore sono disponibili?">
+    Non ancora. I grafici a indicatore sono nella nostra roadmap e verranno aggiunti in una versione futura.
+  </Accordion>
+
+  <Accordion title="Come faccio a duplicare un cruscotto?">
+    1. Assicurati di essere in modalità visualizzazione (non in modifica)
+    2. Apri la barra dei comandi con **Cmd + K** (oppure **Ctrl + K** su Windows)
+    3. Seleziona **Duplica cruscotto**
+  </Accordion>
+
+  <Accordion title="Con quale frequenza si aggiornano i dati del cruscotto?">
+    I widget si aggiornano automaticamente quando i dati del tuo CRM cambiano:
+    * Aggiornamenti in tempo reale per la maggior parte delle metriche
+    * Se necessario, usa il pulsante di aggiornamento per un aggiornamento manuale
+    * I dati storici sono conservati per l'analisi delle tendenze
+  </Accordion>
+</AccordionGroup>

packages/twenty-docs/l/it/user-guide/dashboards/how-tos/widget-faq.mdx

@@ -0,0 +1,67 @@
+---
+title: Domande frequenti sui widget
+description: Domande comuni e messaggi di errore spiegati.
+---
+
+<AccordionGroup>
+  <Accordion title="Come faccio a mostrare le percentuali invece dei conteggi?">
+    Tre opzioni:
+
+    * **Percentuale vuoti/non vuoti**: In Dati visualizzati, seleziona Percentuale di valori vuoti oppure Percentuale di valori non vuoti
+    * **Rapporto**: Per i campi Selezione o Casella di controllo, abilita Rapporto per mostrare un'opzione specifica come percentuale di tutti i record
+    * **Suffisso**: Per i grafici aggregati, aggiungi `%` come suffisso nelle impostazioni di stile
+  </Accordion>
+
+  <Accordion title="Qual è la differenza tra barre raggruppate e impilate?">
+    Quando usi **Raggruppa per**, puoi visualizzare le serie in due modi:
+
+    * **Raggruppate**: Barre affiancate—ideale per confrontare valori esatti
+    * **Impilate**: Barre una sopra l'altra—ideale per mostrare la composizione
+
+    Attiva/disattiva **Impilato** nelle impostazioni di stile per cambiare.
+  </Accordion>
+
+  <Accordion title="Perché non vedo le opzioni Somma o Media?">
+    Le operazioni disponibili dipendono dal **tipo di campo**:
+
+    * **Campi numerici**: Somma, Media, Minimo, Massimo
+    * **Campi data**: Più antico, Più recente (solo grafici aggregati)
+    * **Campi casella di controllo**: Conta valori veri, Conta valori falsi
+
+    Se non vedi un'opzione, verifica di aver selezionato un tipo di campo compatibile.
+  </Accordion>
+
+  <Accordion title="Perché alcune impostazioni sono disattivate o non disponibili?">
+    Molte impostazioni compaiono solo quando sono soddisfatti i prerequisiti:
+
+    * **Granularità della data**: seleziona prima un campo data
+    * **Raggruppa per, Legenda, Impilato**: imposta prima Origine
+    * **Interruttori Legenda e Impilato**: imposta prima Raggruppa per
+
+    Se un'impostazione non è presente, configura prima il relativo prerequisito.
+  </Accordion>
+
+  <Accordion title="Cosa significa 'Nessun dato'?">
+    Il grafico non ha trovato record che corrispondono alla tua configurazione.
+
+    **Per risolvere:** Rimuovi o modifica i filtri, verifica di aver selezionato l'oggetto Origine corretto o controlla che esistano record per il tuo intervallo di date.
+  </Accordion>
+
+  <Accordion title="Cosa significa 'Configurazione non valida'?">
+    Manca un'impostazione obbligatoria o è incompatibile.
+
+    **Per risolvere:** Assicurati che Origine sia impostata, che Dati visualizzati sia configurato e che eventuali campi di raggruppamento richiesti siano selezionati.
+  </Accordion>
+
+  <Accordion title="Cosa significa 'Dati non visualizzati'?">
+    I tuoi dati superano i limiti di visualizzazione (100 barre, 100 punti dati o 100 spicchi).
+
+    **Per risolvere:** Aggiungi filtri per restringere i dati oppure cambia la granularità della data da Giorno a Settimana o Mese.
+  </Accordion>
+
+  <Accordion title="Perché un asse non mostra dati?">
+    Il campo selezionato non ha valori per i record nel tuo filtro oppure il tipo di campo non corrisponde ai dati previsti.
+
+    **Per risolvere:** Prova un campo diverso oppure verifica che i record abbiano valori per il campo selezionato.
+  </Accordion>
+</AccordionGroup>

packages/twenty-docs/l/it/user-guide/dashboards/overview.mdx

@@ -0,0 +1,75 @@
+---
+title: Cruscotti
+description: Scopri le basi della reportistica e delle dashboard in Twenty.
+---
+
+## Comprendere le dashboard
+
+Le dashboard in Twenty offrono un modo visivo per monitorare le tue metriche chiave delle prestazioni e ottenere informazioni approfondite dai dati del tuo CRM.
+
+<img src="/images/user-guide/dashboard/dashboards_v2.png" alt="Cruscotti" />
+
+## Concetti chiave
+
+### Cruscotti
+
+Una dashboard è una raccolta di schede che mostra i dati del tuo CRM a colpo d'occhio. Puoi creare più dashboard per scopi diversi:
+
+* Prestazioni di vendita
+* Attività del team
+* Salute della pipeline
+* Metriche personalizzate
+
+### Schede
+
+Le schede ti consentono di organizzare la tua dashboard in sezioni. Ogni scheda contiene uno o più widget.
+
+### Widget
+
+I widget sono visualizzazioni singole che mostrano dati specifici. Tipi disponibili:
+
+* Grafici a barre
+* Grafici a torta
+* Grafici a linee
+* Grafici aggregati
+* iFrame
+* Testo formattato
+
+<Note>
+**Limitazioni attuali**:
+* L'esportazione delle dashboard e la condivisione con utenti esterni (utenti non Twenty) non sono disponibili al momento.
+* I grafici a indicatore non sono ancora disponibili.
+</Note>
+
+## Per iniziare
+
+### Creare la tua prima dashboard
+
+1. Vai alla sezione **Dashboard**
+2. Fai clic su **+ Nuova dashboard**
+3. Assegna un nome alla tua dashboard
+4. Aggiungi schede per organizzare i tuoi contenuti
+5. Aggiungi widget per visualizzare i tuoi dati
+6. Salva
+
+### Aggiungere widget
+
+1. Apri una scheda nella tua dashboard
+2. Fai clic su **+ Aggiungi widget**
+3. Seleziona il tipo di widget
+4. Scegli l'origine dati (oggetto)
+5. Configura le impostazioni del widget
+6. Salva e visualizza il tuo widget
+
+## Migliori Pratiche
+
+* **Inizia in modo semplice**: parti da alcune metriche chiave e aggiungine altre nel tempo
+* **Concentrati sui dati azionabili**: mostra metriche che guidano le decisioni
+* **Revisione regolare**: controlla regolarmente le tue dashboard per individuare le tendenze
+* **Condividi con il team**: rendi le dashboard visibili ai membri del team pertinenti
+
+## Prossimi Passi
+
+* [Widget e visualizzazioni](/l/it/user-guide/dashboards/capabilities/widgets)
+* [Riferimento alle impostazioni del grafico](/l/it/user-guide/dashboards/capabilities/chart-settings)
+* [FAQ sulle dashboard](/l/it/user-guide/dashboards/how-tos/dashboards-faq)

packages/twenty-docs/l/it/user-guide/data-migration/capabilities/error-handling.mdx

@@ -0,0 +1,76 @@
+---
+title: Gestione degli errori e convalida
+description: Esamina e correggi gli errori di importazione direttamente nell'interfaccia prima di confermare.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Convalida pre-importazione
+
+Dopo aver caricato il file e mappato i campi, Twenty convalida i tuoi dati **prima** dell'importazione. Questo ti permette di individuare e correggere gli errori senza influire sui dati esistenti.
+
+## Come Funziona
+
+1. **Carica** il tuo file CSV
+2. **Mappa** le colonne ai campi di Twenty
+3. **Esamina** i potenziali errori evidenziati in giallo
+4. **Correggi gli errori** direttamente nell'interfaccia
+5. **Conferma** l'importazione
+
+<VimeoEmbed videoId="1145273857" title="Dimostrazione video" />
+
+## Visualizzazione degli errori
+
+Le righe con problemi sono evidenziate in **giallo**. Puoi:
+
+* **Modifica direttamente la cella** per correggere l'errore
+* **Rimuovi la riga** per escluderla del tutto
+
+Questa modifica in linea fa risparmiare tempo — non è necessario tornare al foglio di calcolo, correggere gli errori e caricare nuovamente il file.
+
+## Tipi di errore comuni
+
+### Valori duplicati
+
+**Causa**: Un campo univoco (email, dominio) esiste già in Twenty o compare due volte nel tuo file.
+
+**Soluzione**:
+
+* Modifica il valore duplicato nell'interfaccia di importazione
+* Rimuovi una delle righe duplicate
+
+Vedi [Vincoli di unicità](/l/it/user-guide/data-migration/capabilities/uniqueness-constraints) per maggiori dettagli su come viene applicata l'unicità.
+
+### Formato non valido
+
+**Causa**: I dati non corrispondono al formato previsto (ad es., email non valida, formato data errato).
+
+**Soluzione**: Modifica la cella per usare il formato corretto.
+
+Vedi [Mappatura dei campi](/l/it/user-guide/data-migration/capabilities/field-mapping) per il formato previsto di ogni tipo di campo.
+
+### Campi obbligatori mancanti
+
+**Causa**: Un campo obbligatorio è vuoto.
+
+**Soluzione**: Inserisci un valore nel campo obbligatorio oppure rimuovi la riga.
+
+### Relazione non trovata
+
+**Causa**: Il record di riferimento non esiste (ad es., un dominio aziendale che non è stato importato).
+
+**Soluzione**:
+
+* Importa prima i record genitore
+* Oppure correggi il valore di riferimento
+
+Vedi [Importazione delle relazioni](/l/it/user-guide/data-migration/capabilities/import-relations) per l'ordine di importazione corretto e come collegare i record.
+
+## Suggerimenti per ridurre gli errori
+
+1. **Scarica il modello** per vedere il formato previsto prima di importare il tuo file
+2. **Pulisci i dati** nel foglio di calcolo prima
+3. **Importa i file nell'ordine corretto** per importare le relazioni (Aziende → Persone → Opportunità)
+4. **Esegui dei test con piccoli lotti** prima dell'importazione completa
+5. **Controlla i duplicati** prima del caricamento
+6. **Limita ogni file a 10.000 record**

packages/twenty-docs/l/it/user-guide/data-migration/capabilities/field-mapping.mdx

@@ -0,0 +1,198 @@
+---
+title: Mappatura dei campi
+description: Come funziona la mappatura dei campi durante l'importazione dei dati.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Come funziona la mappatura dei campi
+
+Quando carichi un file, Twenty analizza le colonne e tenta di abbinarle ai campi esistenti.
+
+### Mappatura automatica
+
+Twenty tenta di abbinare le colonne in base a:
+
+* Nomi delle intestazioni di colonna (corrispondenze esatte o simili)
+* Rilevamento del tipo di dati (date, numeri, email)
+* Modelli comuni dei campi
+
+<Note>**Suggerimento rapido:** Esporta alcune righe dall'oggetto che desideri importare. Il file esportato avrà esattamente i nomi di colonna che Twenty si aspetta, rendendo la mappatura automatica agevole durante l'importazione.</Note>
+
+### Opzioni di mappatura manuale
+
+Per ogni colonna, puoi:
+
+* **Mappa a un campo**: seleziona dal menu a discesa il campo di Twenty corrispondente
+* **Non mappare**: salta completamente la colonna (i dati non verranno importati)
+
+<Note>**I campi devono esistere prima dell'importazione.** L'importazione crea record, non campi. Crea i campi personalizzati in **Impostazioni → Modello dati** prima di importare.</Note>
+
+## Compatibilità dei tipi di campo
+
+Tutti i tipi di campo disponibili nel Modello dati sono supportati per l'importazione.
+
+Puoi anche importare valori di `id` per assegnare un ID specifico ai nuovi record oppure aggiornare quelli esistenti.
+
+<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />
+
+## Requisiti del formato dei dati
+
+<Note>**Alcuni campi hanno una sintassi speciale.** Consigliamo di scaricare il file di esempio prima di preparare l'importazione per vedere la sintassi prevista per ciascun tipo di campo.</Note>
+
+### Campi indirizzo
+
+Indirizzo è un campo annidato con più colonne. Alcuni possono essere lasciati vuoti.
+
+* **Indirizzo / Indirizzo 1**: Prima riga dell'indirizzo
+* **Indirizzo / Indirizzo 2**: Seconda riga dell'indirizzo
+* **Indirizzo / Città**: Nome della città
+* **Indirizzo / Stato**: Stato o provincia
+* **Indirizzo / Paese**: Nome del paese
+* **Indirizzo / Codice postale**: Codice postale/CAP
+
+### Campi array
+
+Usa il seguente formato:
+
+```
+["value1","value2"]
+```
+
+### Campi booleani
+
+Usa `TRUE` o `FALSE` (maiuscolo), non `true` o `false`
+
+### Campi valuta
+
+Valuta è un campo annidato con due colonne che **devono essere entrambe compilate**:
+
+* **Importo / Importo**: Il valore numerico (es. `1234.56`)
+* **Importo / Valuta**: Il codice valuta (es. `USD`, `EUR`)
+
+### Campi data
+
+Formati supportati:
+
+* `YYYY-MM-DD` (consigliato)
+* `MM/DD/YYYY`
+* `DD/MM/YYYY`
+* Formato ISO 8601
+
+### Campi dominio
+
+* Si consiglia di usare il formato `https://domain.com` per evitare la creazione di duplicati, poiché è il formato utilizzato per le Aziende create dalle sincronizzazioni della casella di posta e del calendario
+* Si possono compilare `Domain Label` e `Domain URL`: la pratica consigliata è inserire `domain.com` nell'etichetta e `https://domain.com` nell'URL
+* I domini devono essere univoci all'interno dell'oggetto Aziende
+* **I domini devono essere univoci all'interno del file da importare**
+
+### Campi email
+
+* Devono avere un formato email valido
+* Le email devono essere univoche all'interno dell'oggetto Persone
+* **Le email devono essere univoche all'interno del file da importare**
+* Per email aggiuntive: usa **Email / Email primaria** per l'email principale e **Email / Email aggiuntive** con questo formato:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### Campi ID
+
+Specificare un `id` durante l'importazione è facoltativo. Twenty ne genera automaticamente uno se non viene fornito.
+
+Casi d'uso per la mappatura di una colonna `id`:
+
+* **Imposta un ID specifico**: scegli l'UUID per i record appena creati
+* **Aggiorna i record esistenti**: abbinali ai record esistenti per aggiornarli, invece di creare duplicati. In tal caso, si consiglia di non mappare gli altri campi univoci: mappare un solo campo univoco garantisce un'importazione più fluida.
+
+<Note>Se fornisci un `id`, deve essere nel formato UUID (ad es. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+### Campi JSON
+
+Usa un formato JSON valido:
+
+```
+{"key":"value","key2":"value2"}
+```
+
+### Campi link
+
+Simili ai campi dominio:
+
+* Compila sia la colonna etichetta sia la colonna URL: **Link / URL del link** e **Link / Etichetta del link**
+* Usa il formato URL completo: `https://example.com`
+* Per i link secondari, usa la colonna **Link / Link secondari** con questo formato:
+
+```
+[{"url":"https://twenty.com","label":"Twenty"}]
+```
+
+### Campi a selezione multipla
+
+Usa i nomi API (non le etichette visualizzate) nel seguente formato:
+
+```
+["VALUE1","VALUE2"]
+```
+
+Vedi [qui](#finding-api-names-for-select-fields) dove trovare i nomi API.
+
+<Note>Le nuove opzioni di selezione non verranno create automaticamente dall'importazione. Devono essere aggiunte in **Impostazioni → Modello dati** prima di importare.</Note>
+
+<Warning>
+**Importa sovrascritto; non aggiunge.**
+
+Se un record ha già selezionato `VALUE2` e `VALUE3` e importi `["VALUE1"]`, il record avrà solo `VALUE1` dopo l'importazione. Le selezioni precedenti vengono sostituite, non unite.
+</Warning>
+
+### Campi numerici
+
+* Solo numeri
+* Per i decimali si usa il punto: `1234.56`
+* Nessun separatore delle migliaia
+
+### Campi telefono
+
+Telefono è un campo annidato con più colonne che **devono essere compilate**
+
+* **Telefoni / Numero di telefono principale**: Il numero di telefono (es. `4159095555`)
+* **Telefoni / Codice paese del telefono principale**: Codice paese (es. `US`)
+* **Telefoni / Prefisso di chiamata del telefono principale**: Prefisso di chiamata (es. `+1`)
+
+### Campi valutazione
+
+Usa il formato del nome API: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4`, `RATING_5`
+
+### Campi di Relazione
+
+Consulta il nostro articolo dedicato: [Importare relazioni tra oggetti](/l/it/user-guide/data-migration/capabilities/import-relations)
+
+### Campi Selezione
+
+Usa il nome API dell'opzione (non l'etichetta visualizzata):
+
+```
+VALUE1
+```
+
+Vedi [qui](#finding-api-names-for-select-fields) dove trovare i nomi API.
+<Note>Le nuove opzioni di Select non verranno create automaticamente dall'importazione. Devono essere aggiunte in **Impostazioni → Modello dati** prima dell'importazione.</Note>
+
+### Campi di testo
+
+* Nessuna formattazione speciale richiesta
+* Gli spazi iniziali e finali vengono rimossi
+
+## Trovare i nomi API
+
+Per i campi Select, Multi-Select e Array con opzioni predefinite, è necessario usare i **nomi API**, non le etichette visualizzate.
+
+### Come trovare i nomi API
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona l'oggetto e il campo
+3. Abilita la **Modalità avanzata** (interruttore in basso a destra nella pagina delle impostazioni)
+4. Visualizza il nome API per ogni opzione
+
+<VimeoEmbed videoId="1144910809" title="Dimostrazione video" />

packages/twenty-docs/l/it/user-guide/data-migration/capabilities/file-formats.mdx

@@ -0,0 +1,48 @@
+---
+title: Formati di file supportati
+description: Formati di file supportati per l'importazione dei dati in Twenty.
+---
+
+## Formati supportati
+
+Twenty supporta tre formati di file per l'importazione:
+
+| Formato            | Estensione | Note                            |
+| ------------------ | ---------- | ------------------------------- |
+| **CSV**            | .csv       | Consigliato, il più compatibile |
+| **Excel**          | .xlsx      | Formato Excel moderno           |
+| **Excel (Legacy)** | .xls       | Formato Excel precedente        |
+
+## Requisiti dei file
+
+| Requisito            | Valore                                                  |
+| -------------------- | ------------------------------------------------------- |
+| **Codifica**         | UTF-8 consigliato                                       |
+| **Limite di record** | 10.000 record per file                                  |
+| **Struttura**        | La prima riga deve contenere le intestazioni di colonna |
+| **Contenuto**        | Un solo tipo di oggetto per file                        |
+
+## Migliori pratiche per CSV
+
+* **Delimitatore**: usa la virgola (`,`) o il punto e virgola (`;`)
+* **Qualificatore di testo**: usa le virgolette doppie (`"`) per il testo che contiene virgole
+* **Terminatori di riga**: Windows (CRLF) o Unix (LF), entrambi supportati
+* **Valori vuoti**: lascia le celle vuote, non usare "NULL" o "N/A"
+
+## Migliori pratiche per Excel
+
+Durante l'esportazione da Excel:
+
+* Rimuovi le formule (esporta solo i valori)
+* Elimina le righe vuote alla fine
+* Assicurati che non ci siano celle unite
+* Usa solo il primo foglio
+
+## Set di dati di grandi dimensioni
+
+Per set di dati superiori a 10.000 record:
+
+* Suddividi in più file
+* Oppure usa l'[importazione tramite API](/l/it/user-guide/data-migration/how-tos/import-data-via-api) per un numero illimitato di record
+
+<Note>Per migrazioni molto grandi (oltre 100.000 record), le API sono significativamente più veloci e più affidabili delle importazioni CSV.</Note>

packages/twenty-docs/l/it/user-guide/data-migration/capabilities/import-relations.mdx

@@ -0,0 +1,148 @@
+---
+title: Importare le relazioni tra oggetti
+description: Importare le relazioni tra record tramite CSV.
+---
+
+## Panoramica
+
+Twenty supporta l'importazione delle relazioni tra oggetti durante l'importazione CSV. Ciò consente di collegare i record (ad es., associare Persone ad Aziende) come parte della migrazione dei dati.
+
+<Note>**Attualmente supportate per l'importazione**: Relazioni uno a molti che puntano a un singolo tipo di oggetto su ciascun lato (ad es., Persone → Aziende). Le relazioni che puntano a più tipi di oggetto non sono ancora supportate per importazione/esportazione.</Note>
+
+## Come funzionano le relazioni in Twenty
+
+### Uno a molti / Molti a uno
+
+Twenty supporta relazioni standard in cui un record è collegato a molti altri:
+
+* **Un'Azienda → Molte Persone**: Un'azienda può avere più dipendenti, ma ogni persona appartiene a un'unica azienda
+* **Un'Azienda → Molte Opportunità**: Un'azienda può avere più trattative, ma ogni opportunità appartiene a un'unica azienda
+
+### Relazioni che possono puntare a più tipi di oggetto
+
+Alcune relazioni possono collegarsi a diversi tipi di oggetti. Questo funziona in due modi:
+
+**Modello 1: Molti record che si collegano ognuno a un singolo record per ciascun tipo di oggetto**
+
+Diverse note o attività possono essere attaccate a più tipi di oggetti contemporaneamente:
+
+* **Le Note** possono essere collegate a una Persona, a un'Azienda e a un'Opportunità contemporaneamente
+* **I Task** possono essere collegati a una Persona, a un'Azienda e a un'Opportunità contemporaneamente
+
+Qui, le Note/i Task sono sul lato "molti". Ciascuno si collega a un record per tipo di oggetto.
+
+<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
+
+**Modello 2: Un record che riceve collegamenti da molti record di diversi tipi di oggetto**
+
+Un Progetto può ricevere collegamenti da più record di diversi tipi di oggetto:
+
+* **Un Progetto** può avere molte Persone collegate, molte Aziende collegate e molte Note allegate
+
+Qui, il Progetto è sul lato "uno". Più record di oggetti diversi possono collegarsi tutti allo stesso Progetto.
+
+<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
+
+<Warning>
+**Limitazione di import/export**: Le relazioni che puntano a più tipi di oggetto (come Note → Persone/Aziende/Opportunità) non sono ancora supportate nell'importazione o esportazione CSV.
+
+* **Importazione**: Possono essere importate solo relazioni uno a molti che puntano a un singolo tipo di oggetto su ciascun lato
+* **Esportazione**: Le colonne per le relazioni che puntano a più tipi di oggetto sono attualmente lasciate vuote
+
+È nella nostra roadmap.
+</Warning>
+
+### Cosa non è supportato oggi
+
+**Relazioni molti a molti** non sono ancora disponibili. Ad esempio, attualmente non è possibile creare una relazione in cui:
+
+* Molte Persone sono collegate a molti Progetti
+
+<Note>Molti a molte relazioni sono previsti per H2 2026.</Note>
+
+## Collegare i record durante l'importazione
+
+<Note>**Promemoria**: Possono essere importate solo relazioni uno a molti che puntano a un singolo tipo di oggetto (ad es., Persone → Aziende). Le relazioni che puntano a più tipi di oggetto (ad es., Note → Persone/Aziende/Opportunità) non sono ancora supportate.</Note>
+
+### Passaggio 1: Identifica i lati "Uno" e "Molti"
+
+Per prima cosa, determina quale oggetto è sul lato "uno" e quale è sul lato "molti" della relazione.
+
+**Esempio**:
+
+* **Azienda** è il lato "uno" (un'azienda ha molti dipendenti)
+* **Persone** è il lato "molti" (ogni persona appartiene a un'unica azienda)
+
+### Passaggio 2: Assicurati che i record del lato "uno" esistano
+
+Prima di importare il lato "molti", i record del lato "uno" devono già esistere in Twenty.
+
+* Importa o crea prima i record del lato "uno" (ad es., Aziende)
+* Verifica il loro identificatore univoco. Può essere:
+  * L'`id` (UUID di Twenty)
+  * Un campo impostato come univoco (ad es., `domain` per le Aziende o un ID esterno dal tuo sistema precedente)
+
+<Warning>L'importazione non riuscirà se viene fatto riferimento a un record inesistente.</Warning>
+
+### Passaggio 3: Prepara il tuo file CSV
+
+Aggiungi una colonna nel file CSV del lato "molti" che faccia riferimento al record del lato "uno".
+
+**Esempio**: Per un file CSV di Persone collegato ad Aziende:
+
+```
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+**Importante**:
+
+* Il valore deve corrispondere **esattamente** al campo univoco del record Azienda
+* Per i domini, usa l'**URL del dominio** (ad es., `https://acme.com`), non l'etichetta del dominio
+* Mappa un solo identificatore univoco per relazione: questo rende l'importazione più fluida
+
+### Passaggio 4: Assicurati che il campo di relazione esista
+
+Prima di caricare il file, assicurati che esista il campo di relazione tra i tuoi oggetti.
+
+Se non esiste:
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona il tuo oggetto (ad es., Persone)
+3. Crea un campo di relazione che punti all'oggetto di destinazione (ad es., Azienda)
+
+### Passaggio 5: Carica e mappa la relazione
+
+1. Carica il file CSV tramite l'interfaccia di importazione
+2. Nel passaggio di mappatura dei campi, trova la colonna di relazione (ad es., `companyDomain`)
+3. Mappala al campo di relazione (ad es., Azienda)
+4. Twenty collegherà automaticamente ogni record al genitore corrispondente
+
+### Campi univoci disponibili per le relazioni
+
+| Oggetto                                     | Campi univoci disponibili                              |
+| ------------------------------------------- | ------------------------------------------------------ |
+| **Aziende**                                 | `id`, `domain`, qualsiasi campo univoco personalizzato |
+| **Persone**                                 | `id`, `email`, qualsiasi campo univoco personalizzato  |
+| **Membri del Workspace**                    | `id`, `email` (non il nome)                            |
+| **Altri oggetti standard e personalizzati** | `id`, qualsiasi campo contrassegnato come univoco      |
+
+<Note>**Collegamento ai membri dello Spazio di lavoro**: quando la relazione punta ai Membri dello Spazio di lavoro (il tuo team che accede a Twenty), fai riferimento al loro **indirizzo email**, non al nome.</Note>
+
+<Note>Consigliamo di usare `domain` per le Aziende ed `email` per le Persone, poiché sono leggibili e facili da mantenere nei fogli di calcolo.</Note>
+
+<Note>**Promemoria**: I record eliminati temporaneamente (visibili in Menu Comandi → Vedi record eliminati) contano ai fini dei criteri di unicità. Se importi un record con lo stesso valore univoco di un record eliminato, il record eliminato verrà ripristinato. Vedi [Vincoli di unicità](/l/it/user-guide/data-migration/capabilities/uniqueness-constraints) per maggiori dettagli.</Note>
+
+## Regola dell'ordine di importazione
+
+<Warning>
+**Importa sempre prima il lato "uno"!**
+
+1. **Aziende** per prime (nessuna dipendenza)
+2. **Persone** al secondo posto (collegate alle Aziende)
+3. **Opportunità** al terzo posto (collegate ad Aziende/Persone)
+4. **Oggetti personalizzati** seguendo le relative dipendenze
+
+Il record padre deve esistere prima di potervi fare riferimento.
+</Warning>

packages/twenty-docs/l/it/user-guide/data-migration/capabilities/uniqueness-constraints.mdx

@@ -0,0 +1,72 @@
+---
+title: Vincoli di unicità
+description: Come Twenty applica l'unicità dei dati durante l'importazione.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Panoramica
+
+Twenty applica l'unicità su determinati campi per prevenire record duplicati e garantire l'integrità dei dati. Comprendere questi vincoli è essenziale per importazioni riuscite.
+
+## Campi univoci predefiniti
+
+| Oggetto                    | Campi univoci                            |
+| -------------------------- | ---------------------------------------- |
+| **Persone**                | `id`, `email`                            |
+| **Aziende**                | `id`, `domain`                           |
+| **Oggetti personalizzati** | Solo `id` (per impostazione predefinita) |
+
+<Note>Il campo `id` è l'identificatore interno di Twenty, generato automaticamente per ciascun record. Utilizza il formato UUID (ad es., `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+## Campi univoci personalizzati
+
+Puoi definire campi univoci aggiuntivi in **Impostazioni → Modello dati**:
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona l'oggetto
+3. Fai clic su un campo
+4. Abilita **Univoco** nelle impostazioni del campo
+
+### Casi d'uso per campi univoci personalizzati
+
+* **ID esterni**: Memorizza ID provenienti da altri sistemi (Salesforce ID, HubSpot ID)
+* **Identificativi aziendali**: numeri dei dipendenti, codici cliente
+* **Informazioni di contatto alternative**: profilo LinkedIn, numero di telefono
+
+<Note>Il nome del campo `id` è riservato all'ID interno di Twenty. Usa un nome diverso come `externalId` o `legacyId` per gli identificatori esterni.</Note>
+
+## Comportamento dell'importazione
+
+### Creazione di nuovi record
+
+Se il valore di un campo univoco non esiste, viene creato un nuovo record.
+
+### Aggiornamento dei record esistenti
+
+Se il valore di un campo univoco corrisponde a un record esistente, quel record viene **aggiornato** con i nuovi dati.
+<Warning>Per **aggiornare i record esistenti**, si consiglia di **associare un solo campo univoco**.</Warning>
+
+### Record eliminati in modo non definitivo
+
+<Warning>
+**I record eliminati contano ai fini dell'unicità.**
+
+I record eliminati in modo non definitivo (visibili in Menu Comandi → Vedi record eliminati) sono inclusi nei controlli di unicità. Se importi un record con lo stesso valore univoco di un record eliminato, il record eliminato verrà **ripristinato** con i nuovi dati.
+</Warning>
+
+## Rilevamento dei duplicati durante l'importazione
+
+Durante la fase di convalida:
+
+* I duplicati presenti nel tuo file sono evidenziati in giallo
+* Puoi modificare o rimuovere le righe duplicate dall'interfaccia utente prima di avviare l'importazione
+
+<VimeoEmbed videoId="1145246326" title="Dimostrazione video" />
+
+## Migliori Pratiche
+
+1. **Rimuovi i duplicati** dal tuo file prima di importare
+2. **Verifica la presenza di record esistenti** in Twenty prima di importare
+3. **Usa ID esterni** quando esegui una migrazione da altri sistemi
+4. **Includi campi univoci** se vuoi aggiornare i record esistenti

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/export-faq.mdx

@@ -0,0 +1,32 @@
+---
+title: Esporta FAQ
+description: Domande frequenti sull'esportazione dei dati.
+---
+
+<AccordionGroup>
+<Accordion title="Possiamo esportare tutti i dati dello spazio di lavoro prima della cancellazione, inclusi oggetti personalizzati, campi personalizzati, relazioni, note, attività, opportunità, allegati, flussi di lavoro, autorizzazioni e cronologia controlli?">
+I dati dello spazio di lavoro possono essere esportati prima della cancellazione con alcune eccezioni: dashboard, flussi di lavoro e permessi devono essere trasferiti manualmente; log di audit non possono essere trasferiti.
+</Accordion>
+<Accordion title="Quali elementi non possono attualmente essere esportati o migrati?">
+La maggior parte degli elementi può essere esportata o migrata con alcune eccezioni:
+* flussi di lavoro, dashboard e tutte le impostazioni (chiavi API, webhooks, registri di controllo, impostazioni utente, ecc.) deve essere migrato manualmente
+* gli oggetti e i campi creati da app possono essere migrati installando detta app in un diverso workspace. Non dovrebbero essere migrati manualmente
+* alcuni record, come le versioni del flusso di lavoro e le esecuzioni del flusso di lavoro, non sono trasferibili e dovrebbero essere persi
+* alcuni oggetti come messaggi e oggetti relativi al calendario non dovrebbero essere esportati come vengono creati quando un account è connesso e sincronizzato periodicamente. Verranno sincronizzati di nuovo una volta connesso il tuo account (purché tu abbia accesso a detto account, se è un account di un membro del team che ha lasciato la tua azienda, questi messaggi devono essere esportati, altrimenti andranno persi)
+</Accordion>
+<Accordion title="Esiste un cloud ufficiale per la procedura di migrazione autosufficiente o un servizio di migrazione assistita?">
+A tutt'oggi non esiste una procedura ufficiale di migrazione tra nuvole e autostituita. L'idea generale è la seguente:
+* in primo luogo, installare applicazioni per introdurre oggetti e campi di proprietà app
+* replica oggetti personalizzati e campi aggiunti dagli utenti
+* utilizzare uno script con chiavi API o strumenti AI per migrare tutti i dati da uno spazio di lavoro ad un altro
+* tutti gli oggetti non trasferibili devono essere migrati manualmente
+
+Si prega di essere a conoscenza di alcune cose:
+* è possibile inviare fino a 50 richieste al minuto sul piano Pro o 100 richieste al minuto sul piano Organizzazione prima di colpire un limite richiesta/min
+* ogni richiesta API può avere fino a 200 record
+* alcuni dati in campi come Creato da, Attività Timeline e Aggiornato da saranno persi durante l'importazione e sovrascritti dal sistema
+</Accordion>
+<Accordion title="I file esportati sono forniti in formati aperti e documentati?">
+I file esportati nell'interfaccia utente sono in formato Excel e tutte le richieste API possono essere salvate in formato JSON.
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/export-your-data.mdx

@@ -0,0 +1,209 @@
+---
+title: Esporta i tuoi dati
+description: Guida completa passo per passo all'esportazione dei dati da Twenty.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Panoramica
+
+Esporta i dati del tuo spazio di lavoro in CSV per backup, reportistica o migrazione.
+
+**Casi di utilizzo:**
+
+* **Backup regolari** — conserva copie dei tuoi dati
+* **Reportistica esterna** — analizza i dati in Excel, Google Sheets o strumenti BI
+* **Migrazione** — sposta i dati in un altro sistema
+* **Aggiornamenti massivi** — esporta, modifica e reimporta per aggiornare i record
+
+## Cosa devi sapere
+
+### Limiti di esportazione
+
+* **Massimo 20.000 record** per esportazione
+* Vengono esportate solo le **colonne visibili**
+* Vengono esportati solo i **record filtrati** (in base alla vista corrente)
+
+<Note>Per esportazioni più grandi (oltre 20.000 record), usa i filtri per esportare a lotti oppure usa le [API](/l/it/developers/extend/api).</Note>
+
+### Permessi
+
+Hai bisogno dell'autorizzazione **"Esporta CSV"** per esportare i dati. Contatta l'amministratore del tuo spazio di lavoro se non hai questa opzione.
+
+## Passaggio 1: Vai all'oggetto
+
+Vai all'oggetto che vuoi esportare:
+
+* **Persone** — per i contatti
+* **Aziende** — per le organizzazioni
+* **Opportunità** — per le trattative
+* **Oggetti personalizzati** — qualsiasi oggetto che hai creato
+
+## Passaggio 2: Configura la tua vista
+
+**Importante:** L'esportazione include solo ciò che è visibile nella vista corrente.
+
+### Aggiungi/Rimuovi colonne
+
+1. Fai clic su **Opzioni → Campi** (oppure sul **+** alla fine delle colonne)
+2. Seleziona i campi che vuoi esportare
+3. Deseleziona i campi di cui non hai bisogno
+
+### Filtra i record (opzionale)
+
+Se ti serve solo un sottoinsieme di dati:
+
+1. Fai clic su **Filtro**
+2. Aggiungi condizioni di filtro (es., "Data di creazione > 1 gennaio 2024")
+3. Verranno esportati solo i record corrispondenti
+
+### Ordina i record (opzionale)
+
+1. Fai clic sull'intestazione di una colonna per ordinare
+2. L'esportazione seguirà il tuo ordinamento
+
+<Note>**Crea una vista dedicata all'esportazione.** Salva una vista configurata specificamente per le esportazioni così da non dover riconfigurare ogni volta.</Note>
+
+## Passaggio 3: Esporta i dati
+
+1. Fai clic sull'icona **⋮** in alto a destra della tabella
+2. Seleziona **Esporta vista**
+3. Scegli dove salvare il file CSV
+4. Attendi il completamento del download
+
+## Cosa viene esportato
+
+| Incluso                                     | Non incluso                    |
+| ------------------------------------------- | ------------------------------ |
+| Tutte le colonne visibili                   | Colonne nascoste               |
+| Record che corrispondono ai filtri correnti | Record esclusi dai filtri      |
+| Valori dei campi personalizzati             | Campi non presenti nella vista |
+| ID dei record                               | File allegati                  |
+| ID delle relazioni                          | Immagini                       |
+
+### Campi di Relazione
+
+Gli ID delle relazioni vengono esportati solo sul **lato "many"** di una relazione:
+
+* **L'esportazione Persone** include una colonna `companyId` (relazione Persone → Azienda)
+* **L'esportazione Aziende** NON include `peopleIds` (Aziende è il lato "one")
+
+Ciò significa che puoi usare l'esportazione Persone per reimportare e mantenere il collegamento con l'Azienda, ma dovrai reimportare Persone dopo Aziende per ricreare le relazioni.
+
+## Esportazione per scopi specifici
+
+### Per i backup
+
+1. Crea una vista con **tutti i campi** visibili
+2. Rimuovi tutti i filtri per includere tutti i record
+3. Esporta ogni tipo di oggetto separatamente
+4. Conserva le esportazioni in una posizione sicura
+5. Imposta un promemoria ricorrente (settimanale/mensile)
+
+### Per la reportistica esterna
+
+1. Includi solo i campi necessari all'analisi
+2. Applica filtri per concentrarti sui dati rilevanti
+3. Valuta di ordinare in base al campo che analizzerai
+
+### Per aggiornamenti massivi
+
+1. Esporta i record che vuoi aggiornare
+2. Includi l'identificatore univoco (`email`, `domain` o `id`)
+3. Modifica il file esportato
+4. Reimporta per aggiornare i record
+   Vedi: [Come aggiornare i record esistenti](/l/it/user-guide/data-migration/how-tos/update-existing-records-via-import)
+
+### Per la migrazione
+
+Se stai esportando per migrare a un altro sistema:
+
+1. **Esporta ogni oggetto separatamente** — Persone, Aziende, Opportunità, ecc.
+2. **Includi i campi ID** — aiutano a mantenere le relazioni
+3. **Documenta le mappature dei campi** — annota come i campi di Twenty corrispondono al tuo sistema di destinazione
+
+## Gestione di set di dati di grandi dimensioni (oltre 20.000 record)
+
+Il limite di esportazione è di 20.000 record. Per set di dati più grandi:
+
+### Opzione 1: Esporta a lotti
+
+1. Aggiungi un filtro (ad es., intervalli di "Data di creazione")
+2. Esporta il primo lotto
+3. Modifica il filtro
+4. Esporta il lotto successivo
+5. Unisci i file nel tuo foglio di calcolo
+
+**Esempi di filtri per i lotti:**
+
+* Per intervallo di date (gennaio, febbraio, marzo...)
+* Per proprietario (membro del team A, membro del team B...)
+* Per stato (attivo, inattivo...)
+
+### Opzione 2: Usa le API
+
+Le API non hanno un limite di record:
+
+1. Ottieni la tua chiave API da **Impostazioni → Sviluppatori**
+2. Usa le API GraphQL per interrogare i record
+3. Elabora i risultati nella tua applicazione
+
+Vedi: [Documentazione API](/l/it/developers/extend/api)
+
+## Suggerimenti e buone pratiche
+
+### Crea viste di esportazione
+
+Salva viste configurate specificamente per le esportazioni:
+
+1. Configura colonne e filtri
+2. Fai clic su **Opzioni vista** → **Salva come nuova vista**
+3. Assegnale il nome "Export - [Scopo]"
+
+### Proteggi le tue esportazioni
+
+I file esportati possono contenere dati sensibili:
+
+* Conservali in posizioni sicure
+* Elimina le esportazioni vecchie quando non sono più necessarie
+* Fai attenzione quando condividi i file di esportazione
+
+### Verifica prima di esportare
+
+<Check>Le colonne corrette sono visibili</Check>
+<Check>I filtri sono impostati correttamente (o rimossi per l'esportazione completa)</Check>
+<Check>Hai l'autorizzazione di esportazione</Check>
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Perché mancano alcune colonne nella mia esportazione?">
+    Vengono esportate solo le colonne visibili. Aggiungi le colonne necessarie tramite **Opzioni → Campi** prima di esportare.
+  </Accordion>
+
+  <Accordion title="Perché la mia esportazione non include tutti i record?">
+    Controlla i tuoi filtri. L'esportazione include solo i record che corrispondono ai filtri della vista corrente. Rimuovi i filtri per esportare tutti i record.
+  </Accordion>
+
+  <Accordion title="Posso esportare più di 20.000 record?">
+    Non in un'unica esportazione. Usa i filtri per esportare a lotti oppure usa le API per set di dati più grandi.
+  </Accordion>
+
+  <Accordion title="Qual è il formato del file di esportazione?">
+    CSV (valori separati da virgola). Si apre in Excel, Google Sheets o in qualsiasi applicazione per fogli di calcolo.
+  </Accordion>
+
+  <Accordion title="Gli ID delle relazioni sono inclusi?">
+    Sì, ma solo sul lato "many" delle relazioni. Ad esempio, un'esportazione Persone include `companyId`, ma un'esportazione Aziende non include gli ID delle persone.
+  </Accordion>
+
+  <Accordion title="Posso automatizzare le esportazioni?">
+    Non direttamente tramite l'interfaccia utente. Usa le API per creare flussi di lavoro di esportazione automatizzati.
+  </Accordion>
+</AccordionGroup>
+
+## Prossimi Passi
+
+* [Come aggiornare i record esistenti](/l/it/user-guide/data-migration/how-tos/update-existing-records-via-import) — modifica e reimporta la tua esportazione
+* [Come importare i dati tramite API](/l/it/user-guide/data-migration/how-tos/import-data-via-api) — per set di dati di grandi dimensioni
+* [Documentazione API](/l/it/developers/extend/api) — crea flussi di lavoro di esportazione personalizzati

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/fix-import-errors.mdx

@@ -0,0 +1,430 @@
+---
+title: Correggere gli errori di importazione
+description: Guida completa alla risoluzione degli errori di importazione CSV.
+---
+
+## Panoramica
+
+L'importazione non funziona? Questa guida ti aiuta a identificare e correggere, passo dopo passo, gli errori di importazione più comuni.
+
+## Come funziona la convalida dell'importazione
+
+Dopo aver caricato il file e mappato le colonne, Twenty convalida i tuoi dati:
+
+1. **Esecuzione della convalida** — Twenty controlla ogni riga per individuare errori
+2. **Gli errori sono evidenziati** — le righe problematiche appaiono in **giallo**
+3. **Puoi correggere direttamente** — modifica le celle direttamente nell'interfaccia di importazione
+4. **Oppure rimuovi le righe** — salta completamente i record problematici
+
+<Note>**Correggi gli errori nell'interfaccia.** Non è necessario tornare al tuo foglio di calcolo. Modifica le celle direttamente durante l'importazione per risparmiare tempo.</Note>
+
+## Risoluzione dei problemi passo passo
+
+### Passaggio 1: Identifica il tipo di errore
+
+Fai clic su una riga evidenziata per vedere il messaggio di errore specifico. Tipi di errore comuni:
+
+| Messaggio di errore                                                                | Cosa significa                                                  |
+| ---------------------------------------------------------------------------------- | --------------------------------------------------------------- |
+| Valori duplicati evidenziati in giallo                                             | Il valore esiste già in Twenty o compare due volte nel tuo file |
+| `{field} is not a valid {type}` (passa il mouse sulla cella gialla)                | I dati non corrispondono al formato previsto                    |
+| Campo obbligatorio evidenziato                                                     | Un campo obbligatorio è vuoto                                   |
+| `Can't connect to {object}. No unique record found...` (importazione non riuscita) | Il record di riferimento non esiste                             |
+| `Too many records. Up to 10000 allowed` (caricamento bloccato)                     | Il file contiene più di 10.000 record                           |
+
+### Passaggio 2: Correggi l'errore
+
+Segui le istruzioni specifiche qui sotto per ciascun tipo di errore.
+
+---
+
+## Errore: valore duplicato
+
+### Cosa vedrai
+
+Le righe con valori duplicati vengono **evidenziate in giallo** nell'interfaccia di importazione prima che l'importazione inizi.
+
+### Cosa significa
+
+Un campo univoco (email, dominio) può:
+
+* Esistere già in Twenty
+* Comparire due volte nel tuo file
+
+### Come risolvere
+
+**Opzione 1: Modifica il valore duplicato**
+
+1. Fai clic sulla cella con l'errore
+2. Modifica con un valore univoco
+3. Continua con l'importazione
+
+**Opzione 2: Rimuovi la riga duplicata**
+
+1. Fai clic sulla X accanto alla riga
+2. La riga verrà saltata durante l'importazione
+
+**Opzione 3: Consenti a Twenty di aggiornare il record esistente**
+
+1. Assicurati che il tuo file includa un identificatore univoco (`email`, `domain` o `id`)
+2. Mappa il campo identificatore univoco
+3. Twenty aggiornerà il record esistente invece di creare un duplicato
+
+<Note>
+**Puoi aggiornare anche i campi univoci.**
+
+* Se mantieni l'`id` ma cambi l'`email` → l'email verrà aggiornata
+* Se mantieni l'`email` ma cambi l'`id` → l'id verrà aggiornato
+
+Finché almeno un identificatore univoco corrisponde, Twenty aggiorna il record.
+</Note>
+
+### Come prevenire questo errore
+
+Prima di importare:
+
+1. Ordina il foglio di calcolo per il campo univoco
+2. Rimuovi le righe duplicate
+3. Verifica se i record esistono già in Twenty
+
+<Warning>
+**I record eliminati in modo non definitivo contano ai fini dell'unicità.**
+
+Controlla il menu Comandi → Visualizza i record eliminati. I record presenti lì impongono comunque l'unicità. Eliminali definitivamente oppure ripristinali e aggiornali.
+</Warning>
+
+Per maggiori dettagli: [Vincoli di unicità](/l/it/user-guide/data-migration/capabilities/uniqueness-constraints)
+
+---
+
+## Errore: formato non valido
+
+### Cosa vedrai
+
+Il valore della cella è evidenziato in giallo. Passa il mouse sopra per vedere il messaggio di errore:
+
+```
+{field name} is not a valid {field type}
+```
+
+### Cosa significa
+
+I dati non corrispondono al formato previsto per quel tipo di campo.
+
+### Come risolvere — in base al tipo di campo
+
+#### Email
+
+**Problema:** formato email non valido
+**Soluzione:** usa il formato `name@domain.com`
+
+```
+❌ john.smith@
+❌ john smith@acme.com
+✓ john.smith@acme.com
+```
+
+#### Dominio
+
+**Problema:** un formato incoerente può causare duplicati
+**Soluzione:** usa il formato `https://domain.com` (consigliato)
+
+```
+⚠️ acme.com         (valid, but not recommended)
+⚠️ www.acme.com     (valid, but not recommended)
+✅ https://acme.com  (recommended)
+```
+
+<Note>Tutti i formati sono validi, ma `https://domain.com` è consigliato perché corrisponde al formato utilizzato dalla sincronizzazione email/calendario. Usare altri formati può creare aziende duplicate.</Note>
+
+#### Data
+
+**Problema:** formato data non riconosciuto
+**Soluzione:** Usa il formato `YYYY-MM-DD` in modo coerente in tutto il file
+
+```
+✓ 2024-03-15        (YYYY-MM-DD)
+❌ 03/15/2024        (MM/DD/YYYY)
+❌ 15/03/2024        (DD/MM/YYYY)
+```
+
+#### Telefono
+
+**Problema:** colonne obbligatorie mancanti
+**Soluzione:** includi tutte le colonne del telefono
+
+| Colonna                                                    | Esempio      |
+| ---------------------------------------------------------- | ------------ |
+| **Telefoni / Numero di telefono principale**               | `4159095555` |
+| **Telefoni / Codice paese del telefono principale**        | `US`         |
+| **Telefoni / Prefisso telefonico del telefono principale** | `+1`         |
+
+#### Booleano
+
+**Problema:** valore booleano errato
+**Soluzione:** usa `TRUE` o `FALSE` in maiuscolo
+
+```
+❌ true
+❌ yes
+❌ 1
+✓ TRUE
+✓ FALSE
+```
+
+#### Selezione / Selezione multipla
+
+**Problema:** il valore non corrisponde alle opzioni esistenti
+**Soluzione:** usa i **nomi API**, non le etichette visualizzate
+
+Come trovare i nomi API:
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona l'oggetto e il campo
+3. Abilita la **Modalità avanzata** (interruttore in basso a destra)
+4. Usa il nome API (ad es., `OPTION_1`, non "Option 1")
+
+```
+❌ High Priority
+✓ HIGH_PRIORITY
+```
+
+#### Valuta
+
+**Problema:** importo o codice valuta mancanti
+**Soluzione:** compila entrambe le colonne
+
+| Colonna               | Esempio   |
+| --------------------- | --------- |
+| **Importo / Importo** | `1234.56` |
+| **Importo / Valuta**  | `USD`     |
+
+#### Numero
+
+**Problema:** caratteri non numerici
+**Soluzione:** solo numeri, punto per i decimali
+
+```
+❌ $1,234.56
+❌ 1,234.56
+✓ 1234.56
+```
+
+Per il riferimento completo ai formati: [Riferimento alla mappatura dei campi](/l/it/user-guide/data-migration/capabilities/field-mapping)
+
+---
+
+## Errore: campo obbligatorio mancante
+
+### Cosa vedrai
+
+La riga è evidenziata in giallo con la cella del campo obbligatorio contrassegnata.
+
+### Cosa significa
+
+Un campo obbligatorio è vuoto per questa riga.
+
+### Come risolvere
+
+**Opzione 1: Inserisci un valore**
+
+1. Fai clic sulla cella vuota
+2. Inserisci un valore
+3. Continua con l'importazione
+
+**Opzione 2: Rimuovi la riga**
+
+1. Se non disponi dei dati, fai clic su X per saltare la riga
+
+### Come prevenire questo errore
+
+Prima di importare, identifica i campi obbligatori:
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona il tuo oggetto
+3. Verifica quali campi sono contrassegnati come obbligatori
+
+---
+
+## Errore: relazione non trovata
+
+### Cosa vedrai
+
+Questo errore compare **dopo l'avvio dell'importazione** — l'importazione non riesce con un messaggio come:
+
+```
+Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f
+```
+
+Ciò significa che non esiste alcuna Azienda in Twenty con quello specifico identificatore.
+
+<Note>A differenza di altri errori, questo non viene intercettato durante la fase di revisione dei dati. L'importazione inizierà e poi non riuscirà quando incontrerà la relazione mancante.</Note>
+
+### Cosa significa
+
+Stai tentando di collegarti a un record che non esiste in Twenty.
+
+### Come risolvere
+
+**Opzione 1: importa prima i record genitore**
+
+1. Annulla l'importazione corrente
+2. Importa i record genitore (ad es., Aziende)
+3. Quindi importa i record figlio (ad es., Persone)
+
+**Opzione 2: correggi il valore di riferimento**
+
+1. Controlla il valore di riferimento nel tuo file
+2. Assicurati che corrisponda esattamente a un record esistente
+3. Verifica il formato: i domini devono essere `https://domain.com`
+
+**Opzione 3: rimuovi la relazione**
+
+1. Svuota la cella per importare senza la relazione
+2. Aggiungi la relazione manualmente in seguito
+
+### Come prevenire questo errore
+
+1. **Importa nell'ordine corretto:**
+   * Prima le Aziende
+   * Poi le Persone (con riferimenti all'Azienda)
+   * Le Opportunità al terzo posto
+
+2. **Verifica i valori di riferimento:**
+   * Esporta i record genitore per ottenere identificatori esatti
+   * Usa il formato dominio `https://domain.com`
+   * Verifica errori di battitura e differenze tra maiuscole/minuscole
+
+<Warning>
+**L'importazione non riuscirà se viene fatto riferimento a un record inesistente.**
+
+Importa sempre gli oggetti genitore prima degli oggetti figlio.
+</Warning>
+
+Per maggiori dettagli: [Importazione delle relazioni](/l/it/user-guide/data-migration/capabilities/import-relations)
+
+---
+
+## Errore: file troppo grande
+
+### Cosa vedrai
+
+Questo errore compare **quando carichi il file** — il caricamento viene completamente bloccato:
+
+```
+Too many records. Up to 10000 allowed
+```
+
+Non potrai procedere alla fase di revisione dei dati finché non riduci la dimensione del file.
+
+### Cosa significa
+
+Il tuo file contiene più di 10.000 record.
+
+### Come risolvere
+
+**Opzione 1: Dividi in più file**
+
+1. Dividi i tuoi dati in file da 10.000 record o meno
+2. Importa ogni file separatamente
+3. Mantieni l'ordine di importazione (Aziende prima delle Persone)
+
+**Opzione 2: Usa l'importazione tramite API**
+Per set di dati molto grandi, usa le API che non hanno un limite di record.
+Vedi: [Come importare i dati tramite API](/l/it/user-guide/data-migration/how-tos/import-data-via-api)
+
+---
+
+## Errore: campo non riconosciuto
+
+### Cosa significa
+
+Una colonna del tuo file non può essere mappata perché il campo non esiste in Twenty.
+
+### Come risolvere
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona l'oggetto che stai importando
+3. Fai clic su **+ Aggiungi campo**
+4. Crea il campo personalizzato con il tipo appropriato
+5. Carica di nuovo il tuo file
+
+<Note>L'importazione CSV crea record, non campi. Tutti i campi devono esistere prima dell'importazione.</Note>
+
+---
+
+## Errore: relazione utente vuota
+
+### Cosa significa
+
+Stai tentando di assegnare un record a un utente (Proprietario, Assegnatario) ma la relazione non viene mappata.
+
+### Cause comuni
+
+1. **L'utente non ha accettato l'invito** — l'utente non esiste ancora in Twenty
+2. **Uso dell'ID utente dal vecchio sistema** — Twenty non può abbinare gli ID di un altro sistema
+3. **Formato email errato** — l'email non corrisponde all'account Twenty dell'utente
+
+### Come risolvere
+
+1. Assicurati che tutti gli utenti abbiano **accettato il loro invito** al tuo spazio di lavoro Twenty
+2. Usa l'**indirizzo email** dell'utente (non il nome o l'ID del vecchio sistema)
+3. Usa la stessa email che hanno utilizzato per aderire a Twenty
+
+<Warning>
+**Gli utenti devono accettare gli inviti prima di importare.**
+
+Se un utente non ha accettato l'invito, i record che fanno riferimento a quell'utente avranno relazioni utente vuote.
+</Warning>
+
+---
+
+## Lista di controllo pre-importazione
+
+Evita errori verificando questi elementi prima di importare:
+
+### Requisiti del file
+
+<Check>Il file è in formato CSV, XLSX o XLS</Check>
+<Check>Il file contiene meno di 10.000 record</Check>
+<Check>Il file utilizza la codifica UTF-8</Check>
+
+### Qualità dei dati
+
+<Check>Nessuna email duplicata (per Persone)</Check>
+<Check>Nessun dominio duplicato (per Aziende)</Check>
+<Check>Tutte le date utilizzano un formato coerente</Check>
+<Check>Tutti i domini utilizzano il formato `https://domain.com`</Check>
+
+### Formati dei campi
+
+<Check>I campi booleani utilizzano `TRUE` o `FALSE` (maiuscolo)</Check>
+<Check>I campi Selezione utilizzano i nomi API, non le etichette visualizzate</Check>
+<Check>I campi Telefono hanno tutte le colonne richieste</Check>
+<Check>I campi Valuta hanno sia Importo che Codice valuta</Check>
+
+### Relazioni
+
+<Check>I record genitore sono importati prima dei record figlio</Check>
+<Check>Le colonne di relazione fanno riferimento a record esistenti</Check>
+<Check>Il formato del dominio corrisponde esattamente al formato di Twenty</Check>
+
+### Modello dati
+
+<Check>Tutti i campi personalizzati esistono in Impostazioni → Modello dati</Check>
+<Check>Le opzioni Selezione esistono prima dell'importazione</Check>
+
+---
+
+## Hai ancora problemi?
+
+Se hai provato le soluzioni sopra:
+
+1. **Scarica il file di esempio** — vedi il formato esatto che Twenty si aspetta
+2. **Esporta i record esistenti** — confronta il tuo file con i dati funzionanti
+3. **Esegui un test con un piccolo lotto** — prova prima con 5-10 righe
+4. **Consulta gli articoli di riferimento:**
+   * [Mappatura dei campi](/l/it/user-guide/data-migration/capabilities/field-mapping)
+   * [Vincoli di unicità](/l/it/user-guide/data-migration/capabilities/uniqueness-constraints)
+   * [Importazione delle relazioni](/l/it/user-guide/data-migration/capabilities/import-relations)
+   * [Gestione degli errori](/l/it/user-guide/data-migration/capabilities/error-handling)

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/import-companies-via-csv.mdx

@@ -0,0 +1,201 @@
+---
+title: Importa aziende tramite CSV
+description: Guida completa passo per passo all'importazione di aziende in Twenty.
+---
+
+## Panoramica
+
+Questa guida ti accompagna nell'importazione delle tue aziende in Twenty. **Le aziende dovrebbero essere importate per prime** perché Persone e Opportunità si collegano alle Aziende.
+
+## Prima di Iniziare
+
+### Lista di controllo dei prerequisiti
+
+<Check>
+Il file è in formato CSV, XLSX o XLS
+</Check>
+
+<Check>
+Il file contiene meno di 10.000 record
+</Check>
+
+<Check>
+Nessun dominio duplicato nel file
+</Check>
+
+<Check>
+Tutti i campi personalizzati esistono in **Impostazioni → Modello dati**
+</Check>
+
+<Note>
+Hai bisogno di importare più di 10.000 aziende? Suddividi in più file oppure usa l'[importazione tramite API](/l/it/user-guide/data-migration/how-tos/import-data-via-api).
+</Note>
+
+## Passo 1: Prepara i dati delle tue Aziende
+
+### Campi obbligatori e consigliati
+
+| Campo                    | Obbligatorio? | Formato              | Note                           |
+| ------------------------ | ------------- | -------------------- | ------------------------------ |
+| **Name**                 | Consigliato   | Testo                | Nome visualizzato dell'azienda |
+| **Dominio**              | Consigliato   | `https://domain.com` | Identificatore univoco         |
+| **Indirizzo**            | Facoltativo   | Più colonne          | Vedi sotto                     |
+| **Dipendenti**           | Facoltativo   | Numero               | Numero di dipendenti           |
+| **Campi personalizzati** | Facoltativo   | Varia                | Deve esistere nel Modello dati |
+
+### Formato del dominio
+
+<Warning>
+**Usa il formato `https://domain.com` per i domini.**
+
+Questo corrisponde al formato usato quando le Aziende vengono create automaticamente dalla sincronizzazione di email/calendario, evitando duplicati in seguito.
+</Warning>
+
+**Colonne del dominio:**
+
+* **Domain / Domain Label**: `acme.com`
+* **Domain / Domain URL**: `https://acme.com`
+
+### Formato dell'indirizzo
+
+L'indirizzo è un campo annidato con più colonne:
+
+```
+Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
+123 Main Street,San Francisco,CA,USA,94105
+```
+
+### Esempio di struttura CSV
+
+```csv
+name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
+Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
+Widget Co,https://widgets.co,widgets.co,New York,USA,50
+```
+
+<Note>
+**Suggerimento avanzato:** Fai clic su **Scarica file di esempio** durante l'importazione per vedere i nomi di colonna esatti che Twenty si aspetta.
+</Note>
+
+## Passo 2: Accedi alla funzione di importazione
+
+**Opzione 1: dalla vista Aziende**
+
+1. Vai su **Aziende** nella barra laterale sinistra
+2. Fai clic sull'icona **⋮** in alto a destra
+3. Seleziona **Importa record**
+
+**Opzione 2: tramite Menu Comandi**
+
+1. Premi `Cmd + K` (Mac) o `Ctrl + K` (Windows)
+2. Digita "import"
+3. Seleziona **Importa record**
+4. Scegli **Aziende**
+
+## Passo 3: Carica il tuo file
+
+1. Fai clic su **Seleziona file**
+2. Scegli il tuo file CSV, XLSX o XLS
+3. Attendi che Twenty analizzi il tuo file
+
+## Passo 4: Mappa le tue colonne
+
+Twenty tenta automaticamente di associare le tue colonne ai campi. Verifica e regola:
+
+1. **Controlla le mappature automatiche** — verifica che siano corrette
+2. **Correggi le mappature errate** — fai clic sul menu a discesa per selezionare il campo corretto
+3. **Salta colonne** — seleziona **Non mappare** per le colonne che non vuoi importare
+
+### Regole importanti di mappatura
+
+* **Dominio**: mappa a **Domain / Domain URL** (non Domain Label)
+* **Indirizzo**: mappa ogni parte alla sua colonna specifica (Città, Stato, ecc.)
+* **Campi Selezione**: i valori devono corrispondere alle opzioni esistenti (oppure li mapperai nel passaggio successivo)
+
+<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
+
+## Passo 5: Mappa i valori dei campi Selezione
+
+Se hai campi Selezione o Multiselezione:
+
+1. Twenty mostra i tuoi valori insieme alle opzioni esistenti
+2. Abbina ogni valore nel tuo file a un'opzione di Twenty
+3. Oppure crea nuove opzioni se necessario
+
+<Note>
+Le opzioni dei campi Selezione usano i **nomi API**, non le etichette visualizzate. Controlla **Impostazioni → Modello dati** → Abilita la **Modalità avanzata** per vedere i nomi API.
+</Note>
+
+## Passo 6: Rivedi e correggi gli errori
+
+Prima di completare l'importazione, Twenty convalida i tuoi dati:
+
+1. Fai clic su **Passaggi successivi**
+2. Le righe con errori sono evidenziate in **giallo**
+3. **Correggi gli errori direttamente** — fai clic su una cella e modifica il valore
+4. **Rimuovi le righe problematiche** — fai clic sulla X per saltare quella riga
+
+### Errori comuni di importazione delle aziende
+
+| Errore                             | Causa                           | Soluzione                                            |
+| ---------------------------------- | ------------------------------- | ---------------------------------------------------- |
+| **Dominio duplicato**              | Il dominio esiste già in Twenty | Rimuovi dal file oppure aggiorna il record esistente |
+| **Formato del dominio non valido** | Formato errato                  | Usa `https://domain.com`                             |
+| **Campo obbligatorio mancante**    | Il campo obbligatorio è vuoto   | Compila il valore oppure rimuovi la riga             |
+
+## Passo 7: Completa l'importazione
+
+1. Rivedi il riepilogo dell'importazione
+2. Fai clic su **Conferma** per importare
+3. Attendi il completamento dell'importazione
+4. Verifica controllando alcuni record
+
+## Dopo l'importazione delle Aziende
+
+Ora puoi importare record collegati alle Aziende:
+
+1. **[Importa Persone](/l/it/user-guide/data-migration/how-tos/import-contacts-via-csv)** — collegale alle Aziende usando il dominio
+2. **Importa le Opportunità** — collegale alle Aziende
+3. **Verifica l'importazione** — controlla a campione alcuni record per assicurarti che i dati siano corretti
+
+## Aggiornare le Aziende esistenti
+
+Per aggiornare le aziende invece di crearne di nuove:
+
+1. Includi nel file la colonna `domain` o `id`
+2. Twenty abbina i record tramite questo identificatore univoco
+3. Le aziende esistenti vengono aggiornate; quelle nuove vengono create
+
+Per i dettagli, vedi [Come aggiornare i record esistenti](/l/it/user-guide/data-migration/how-tos/update-existing-records-via-import).
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Perché due Aziende non possono avere lo stesso dominio?">
+    Il dominio è un identificatore univoco in Twenty. Questo evita aziende duplicate e garantisce che la sincronizzazione delle email colleghi correttamente i messaggi all'azienda giusta.
+  </Accordion>
+
+  <Accordion title="Cosa succede se ho aziende senza dominio?">
+    Puoi lasciare vuoto il dominio. Tuttavia, consigliamo di aggiungere i domini quando possibile per una migliore qualità dei dati e per il collegamento automatico delle email.
+  </Accordion>
+
+  <Accordion title="Posso importare aziende senza Persone collegate?">
+    Sì! Puoi importare prima le aziende, poi importare le Persone in un secondo momento e collegarle utilizzando il dominio dell'azienda.
+  </Accordion>
+
+  <Accordion title="Cosa succede se importo un dominio già esistente?">
+    Se includi un identificatore univoco (dominio o id) che corrisponde a un'azienda esistente, Twenty aggiorna quell'azienda invece di crearne un duplicato.
+  </Accordion>
+
+  <Accordion title="Come risolvo gli errori &#x22;dominio duplicato&#x22;?">
+    Rimuovi il duplicato dal tuo file oppure includi l'`id` dell'azienda per aggiornare il record esistente.
+  </Accordion>
+</AccordionGroup>
+
+## Risoluzione dei problemi
+
+Hai problemi? Controlla:
+
+* [Come correggere gli errori di importazione](/l/it/user-guide/data-migration/how-tos/fix-import-errors)
+* [Riferimento alla mappatura dei campi](/l/it/user-guide/data-migration/capabilities/field-mapping)
+* [Vincoli di unicità](/l/it/user-guide/data-migration/capabilities/uniqueness-constraints)

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx

@@ -0,0 +1,242 @@
+---
+title: Importa contatti tramite CSV
+description: Guida completa passo per passo all'importazione di persone/contatti in Twenty.
+---
+
+## Panoramica
+
+Questa guida ti accompagna nell'importazione dei tuoi contatti (Persone) in Twenty.
+
+## Prima di Iniziare
+
+### Lista di controllo dei prerequisiti
+
+<Check>
+Il file è in formato CSV, XLSX o XLS
+</Check>
+
+<Check>
+Il file contiene meno di 10.000 record
+</Check>
+
+<Check>
+Nessun indirizzo email duplicato nel file
+</Check>
+
+<Check>
+**Aziende importate per prime** (se colleghi Persone ad Aziende)
+</Check>
+
+<Check>
+Tutti i campi personalizzati esistono in **Impostazioni → Modello dati**
+</Check>
+
+<Warning>
+**Importa le Aziende prima delle Persone**
+
+Se vuoi collegare le Persone alle Aziende, importa prima le Aziende. L'Azienda deve esistere prima di potervi fare riferimento.
+</Warning>
+
+## Passo 1: Prepara i tuoi dati di contatto
+
+### Campi obbligatori e consigliati
+
+| Campo                    | Obbligatorio? | Formato           | Note                           |
+| ------------------------ | ------------- | ----------------- | ------------------------------ |
+| **Email**                | Consigliato   | `name@domain.com` | Deve essere univoco            |
+| **Nome**                 | Consigliato   | Testo             |                                |
+| **Cognome**              | Consigliato   | Testo             |                                |
+| **Azienda**              | Facoltativo   | Dominio o ID      | Collega a un'Azienda esistente |
+| **Telefono**             | Facoltativo   | Più colonne       | Vedi sotto                     |
+| **Titolo di lavoro**     | Facoltativo   | Testo             |                                |
+| **Campi personalizzati** | Facoltativo   | Varia             | Deve esistere nel Modello dati |
+
+### Formato email
+
+* Deve avere un formato email valido: `name@domain.com`
+* **Deve essere univoca** — nessun duplicato nel tuo file o in Twenty
+* Per email aggiuntive, usa la colonna **Email / Email aggiuntive**:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### Formato telefono
+
+Telefono è un **campo annidato** che richiede più colonne:
+
+| Colonna                                                    | Esempio      |
+| ---------------------------------------------------------- | ------------ |
+| **Telefoni / Numero di telefono principale**               | `4159095555` |
+| **Telefoni / Codice paese del telefono principale**        | `US`         |
+| **Telefoni / Prefisso telefonico del telefono principale** | `+1`         |
+
+### Collegamento alle Aziende
+
+Aggiungi una colonna con l'identificatore univoco dell'Azienda:
+
+| Nome colonna    | Formato     | Esempio                                |
+| --------------- | ----------- | -------------------------------------- |
+| `companyDomain` | Formato URL | `https://acme.com`                     |
+| `companyId`     | UUID        | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
+
+<Note>
+**Usa il formato URL del dominio** (`https://acme.com`), non l'etichetta. Questo corrisponde al modo in cui le Aziende sono memorizzate in Twenty.
+</Note>
+
+### Esempio di struttura CSV
+
+```csv
+firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
+John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
+Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
+```
+
+<Note>
+**Suggerimento avanzato:** Fai clic su **Scarica file di esempio** durante l'importazione oppure esporta alcune Persone esistenti per vedere i nomi di colonna esatti che Twenty si aspetta.
+</Note>
+
+## Passo 2: Accedi alla funzione di importazione
+
+**Opzione 1: dalla vista Persone**
+
+1. Vai a **Persone** nella barra laterale sinistra
+2. Fai clic sull'icona **⋮** in alto a destra
+3. Seleziona **Importa record**
+
+**Opzione 2: tramite Menu Comandi**
+
+1. Premi `Cmd + K` (Mac) o `Ctrl + K` (Windows)
+2. Digita "import"
+3. Seleziona **Importa record**
+4. Scegli **Persone**
+
+## Passo 3: Carica il tuo file
+
+1. Fai clic su **Seleziona file**
+2. Scegli il tuo file CSV, XLSX o XLS
+3. Attendi che Twenty analizzi il tuo file
+
+## Passo 4: Mappa le tue colonne
+
+Twenty tenta automaticamente di associare le tue colonne ai campi. Verifica e regola:
+
+1. **Controlla le mappature automatiche** — verifica che siano corrette
+2. **Correggi le mappature errate** — fai clic sul menu a discesa per selezionare il campo corretto
+3. **Salta colonne** — seleziona **Non mappare** per le colonne che non vuoi importare
+
+### Regole importanti di mappatura
+
+| Tipo di colonna         | Mappa su                       | Note                                          |
+| ----------------------- | ------------------------------ | --------------------------------------------- |
+| Riferimento all'Azienda | Campo di relazione **Azienda** | Usa il dominio O l'ID, non entrambi           |
+| Email                   | **Email**                      | Indirizzo email principale                    |
+| Email aggiuntive        | **Email / Email aggiuntive**   | Formato array                                 |
+| Telefono                | Colonne separate               | Numero, Codice paese, Prefisso internazionale |
+
+<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
+
+### Mappare la relazione con l'Azienda
+
+Quando mappi la colonna dell'azienda:
+
+1. Trova la tua colonna di riferimento dell'azienda (ad es., `companyDomain`)
+2. Mappala al campo di relazione **Azienda**
+3. Twenty collegherà ogni Persona all'Azienda corrispondente
+
+<Warning>
+**Mappa un solo identificatore univoco per le relazioni.**
+
+Non mappare sia `companyId` che `companyDomain`. Scegline uno — preferibilmente il dominio, perché è facilmente leggibile.
+</Warning>
+
+## Passaggio 5: Mappa i valori dei campi Selezione
+
+Se hai campi Selezione o Multiselezione (come Origine del lead):
+
+1. Twenty mostra i tuoi valori insieme alle opzioni esistenti
+2. Abbina ogni valore nel tuo file a un'opzione di Twenty
+3. Oppure crea nuove opzioni se necessario
+
+<Note>
+Le opzioni dei campi Selezione usano i **nomi API**, non le etichette visualizzate. Controlla **Impostazioni → Modello dati** → Abilita la **Modalità avanzata** per vedere i nomi API.
+</Note>
+
+## Passaggio 6: Rivedi e correggi gli errori
+
+Prima di completare l'importazione, Twenty convalida i tuoi dati:
+
+1. Fai clic su **Passaggi successivi**
+2. Le righe con errori sono evidenziate in **giallo**
+3. **Correggi gli errori direttamente** — fai clic su una cella e modifica il valore
+4. **Rimuovi le righe problematiche** — fai clic sulla X per saltare quella riga
+
+### Errori comuni di importazione dei contatti
+
+| Errore                          | Causa                                   | Soluzione                                               |
+| ------------------------------- | --------------------------------------- | ------------------------------------------------------- |
+| **Email duplicata**             | L'email esiste già in Twenty o nel file | Rimuovi il duplicato o aggiorna il record esistente     |
+| **Formato email non valido**    | Formato email errato                    | Correggi in `name@domain.com`                           |
+| **Relazione non trovata**       | L'Azienda non esiste                    | Importa prima le Aziende oppure correggi il riferimento |
+| **Campo obbligatorio mancante** | Il campo obbligatorio è vuoto           | Compila il valore oppure rimuovi la riga                |
+
+## Passaggio 7: Completa l'importazione
+
+1. Rivedi il riepilogo dell'importazione
+2. Fai clic su **Conferma** per importare
+3. Attendi il completamento dell'importazione
+4. Verifica controllando alcuni record e i relativi collegamenti all'Azienda
+
+## Dopo l'importazione dei contatti
+
+I tuoi contatti sono ora in Twenty! Prossimi passaggi:
+
+1. **Verifica i collegamenti all'Azienda** — apri alcuni record Persone per confermare che siano collegati all'Azienda corretta
+2. **Importa le Opportunità** — se necessario, collegale a Persone e Aziende
+3. **Configura la sincronizzazione email** — collega la tua casella di posta per vedere lo storico delle email sui record dei contatti
+
+## Aggiornare i contatti esistenti
+
+Per aggiornare i contatti invece di crearne di nuovi:
+
+1. Includi la colonna `email` o `id` nel tuo file
+2. Twenty abbina i record tramite questo identificatore univoco
+3. I contatti esistenti vengono aggiornati; quelli nuovi vengono creati
+
+Per i dettagli, vedi [Come aggiornare i record esistenti](/l/it/user-guide/data-migration/how-tos/update-existing-records-via-import).
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Perché due Persone non possono avere la stessa email?">
+    L'email è un identificatore univoco in Twenty. Questo evita contatti duplicati e garantisce che la sincronizzazione delle email colleghi correttamente i messaggi alla persona giusta.
+  </Accordion>
+
+  <Accordion title="Cosa succede se ho persone senza email?">
+    Puoi lasciare vuota l'email. Tuttavia, consigliamo di aggiungere le email quando possibile per una migliore qualità dei dati e per la funzionalità di sincronizzazione delle email.
+  </Accordion>
+
+  <Accordion title="Come collego Persone ad Aziende durante l'importazione?">
+    Aggiungi una colonna con il dominio dell'Azienda (ad es., `https://acme.com`) o l'ID. Durante la mappatura, collega questa colonna al campo di relazione Azienda.
+  </Accordion>
+
+  <Accordion title="E se l'Azienda non esiste ancora?">
+    Importa prima le Aziende, poi importa le Persone. L'Azienda deve esistere prima di potervi fare riferimento.
+  </Accordion>
+
+  <Accordion title="Posso importare l'ID dal mio precedente CRM?">
+    Sì! Crea un campo personalizzato contrassegnato come "univoco" nel tuo modello dati per archiviare l'ID esterno. Nota: il nome del campo `id` è riservato all'ID interno di Twenty.
+  </Accordion>
+
+  <Accordion title="Come risolvo gli errori &#x22;relazione non trovata&#x22;?">
+    L'Azienda a cui fai riferimento non esiste. Importa prima l'Azienda oppure verifica che il dominio/ID corrisponda esattamente a un'Azienda esistente.
+  </Accordion>
+</AccordionGroup>
+
+## Risoluzione dei problemi
+
+Problemi? Controlla:
+
+* [Come correggere gli errori di importazione](/l/it/user-guide/data-migration/how-tos/fix-import-errors)
+* [Come importare le relazioni](/l/it/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+* [Riferimento alla mappatura dei campi](/l/it/user-guide/data-migration/capabilities/field-mapping)

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/import-data-via-api.mdx

@@ -0,0 +1,176 @@
+---
+title: Importa dati via API
+description: Quando e come usare le API di Twenty per importazioni di dati su larga scala.
+---
+
+## Panoramica
+
+Twenty offre sia **GraphQL** che **API REST** per l'importazione programmatica dei dati. Usa l'API quando l'importazione CSV non è pratica per il tuo volume di dati o quando hai bisogno di importazioni automatizzate e ricorrenti.
+
+## Quando usare l'importazione via API
+
+| Scenario                            | Metodo consigliato                       |
+| ----------------------------------- | ---------------------------------------- |
+| Meno di 10.000 record               | Importazione CSV                         |
+| 10.000 - 50.000 record              | Importazione CSV (suddivisa in più file) |
+| **Oltre 50.000 record**             | **Importazione via API**                 |
+| Migrazione una tantum               | Entrambi (in base al volume)             |
+| **Importazioni ricorrenti**         | **Importazione via API**                 |
+| **Sincronizzazione in tempo reale** | **Importazione via API**                 |
+| **Integrazione con altri sistemi**  | **Importazione via API**                 |
+
+<Note>Per set di dati dell'ordine delle centinaia di migliaia, l'API è significativamente più veloce e più affidabile rispetto a importazioni CSV multiple.</Note>
+
+## Limiti di frequenza delle API
+
+Twenty applica limiti di frequenza per garantire la stabilità del sistema:
+
+| Limite                        | Valore               |
+| ----------------------------- | -------------------- |
+| **Richieste al minuto**       | 100                  |
+| **Record per chiamata batch** | 60                   |
+| **Throughput massimo**        | ~6.000 record/minuto |
+
+<Warning>
+**Pianifica la tua importazione tenendo conto di questi limiti.**
+
+Per 100.000 record al throughput massimo, prevedi circa 17 minuti di tempo di importazione. Aggiungi un margine di tempo per la gestione degli errori e i nuovi tentativi.
+</Warning>
+
+## Per iniziare
+
+### Passaggio 1: Ottieni la tua chiave API
+
+1. Vai a **Impostazioni → Sviluppatori**
+2. Fai clic su **+ Crea chiave API**
+3. Assegna alla tua chiave un nome descrittivo
+4. Copia immediatamente la chiave API (non verrà più mostrata)
+5. Conservala in modo sicuro
+
+<Warning>
+**Mantieni segreta la tua chiave API.**
+
+Chiunque abbia la tua chiave API può accedere ai dati del tuo spazio di lavoro e modificarli. Non inserirla mai nei repository di codice né condividerla pubblicamente.
+</Warning>
+
+### Passaggio 2: Scegli la tua API
+
+Twenty supporta due tipi di API:
+
+| API         | Ideale per                                                         | Documentazione                               |
+| ----------- | ------------------------------------------------------------------ | -------------------------------------------- |
+| **GraphQL** | Query flessibili, recupero di dati correlati, operazioni complesse | [Documentazione API](/l/it/developers/extend/api) |
+| **REST**    | Operazioni CRUD semplici, pattern REST familiari                   | [Documentazione API](/l/it/developers/extend/api) |
+
+Entrambe le API supportano:
+
+* Creazione, lettura, aggiornamento ed eliminazione dei record
+* **Operazioni batch** — crea o aggiorna fino a 60 record per chiamata
+
+**Per le importazioni, usa le operazioni batch** per massimizzare il throughput entro i limiti di frequenza.
+
+### Passaggio 3: Pianifica l'ordine di importazione
+
+Proprio come per le importazioni CSV, **l'ordine è importante** per le relazioni:
+
+1. **Aziende** per prime (nessuna dipendenza)
+2. **Persone** al secondo posto (possono collegarsi alle Aziende)
+3. **Opportunità** al terzo posto (possono collegarsi ad Aziende e Persone)
+4. **Attività/Note** (possono collegarsi a uno qualsiasi dei precedenti)
+5. **Oggetti personalizzati** (seguendo le loro dipendenze)
+
+## Migliori Pratiche
+
+### Raggruppa le richieste in batch
+
+* Non inviare i record uno alla volta
+* Raggruppa fino a **60 record per chiamata API**
+* Questo massimizza il throughput entro i limiti di frequenza
+
+### Gestisci i limiti di frequenza
+
+* Implementa dei ritardi tra le richieste (minimo 600 ms per importazioni prolungate)
+* Usa un backoff esponenziale quando raggiungi i limiti
+* Monitora le risposte 429 (Too Many Requests)
+
+### Convalida i dati prima
+
+* Pulisci e convalida i tuoi dati prima di importare
+* Verifica che i campi obbligatori siano compilati
+* Verifica che i formati soddisfino i requisiti di Twenty (vedi [Mappatura dei campi](/l/it/user-guide/data-migration/capabilities/field-mapping))
+
+### Registra tutto
+
+* Registra ogni record importato (inclusi gli ID)
+* Registra gli errori con tutto il contesto
+* Questo aiuta a eseguire il debug dei problemi e a verificare il completamento
+
+### Testa prima
+
+* Esegui un test con un piccolo batch (10-20 record)
+* Verifica che i dati compaiano correttamente in Twenty
+* Poi esegui l'importazione completa
+
+### Usa l'upsert per evitare duplicati
+
+L'API GraphQL supporta **l'upsert in batch** — aggiorna se il record esiste, crea se non esiste. Questo evita duplicati quando riesegui le importazioni.
+
+## Trovare i nomi di oggetti e campi
+
+Per vedere oggetti e campi disponibili:
+
+1. Vai a **Impostazioni → API e Webhooks**
+2. Esplora la **Metadata API**
+3. Visualizza tutti gli oggetti standard e personalizzati con i relativi campi
+
+La documentazione mostra tutti gli oggetti standard e personalizzati, i loro campi e i tipi di dati previsti.
+
+## Servizi Professionali
+
+Per migrazioni API complesse, i nostri partner possono aiutarti:
+
+| Servizio                           | Cosa è incluso                                  |
+| ---------------------------------- | ----------------------------------------------- |
+| **Progettazione del modello dati** | progettare la tua struttura dati ottimale       |
+| **Script di migrazione**           | scrivere ed eseguire gli script di importazione |
+| **Trasformazione dei dati**        | gestire mappature complesse e pulizia           |
+| **Validazione & QA**               | verificare che la migrazione sia completa       |
+
+**Ideale per:**
+
+* Migrazioni di oltre 100.000 record
+* Trasformazioni dei dati complesse
+* Tempistiche ristrette
+* Team senza risorse di sviluppo
+
+Contattaci a [contact@twenty.com](mailto:contact@twenty.com) oppure scopri i nostri [Servizi di implementazione](/l/it/user-guide/getting-started/capabilities/implementation-services).
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Qual è la differenza tra GraphQL e REST?">
+    GraphQL ti consente di richiedere esattamente i dati di cui hai bisogno con una singola query ed è migliore per operazioni complesse. REST utilizza i metodi HTTP standard (GET, POST, PUT, DELETE) e può risultare più familiare se hai già lavorato con API tradizionali.
+  </Accordion>
+
+  <Accordion title="Posso aggiornare i record esistenti tramite API?">
+    Sì! Usa mutation di aggiornamento (GraphQL) o richieste PUT/PATCH (REST) con l'`id` del record.
+  </Accordion>
+
+  <Accordion title="Come gestisco i duplicati?">
+    Esegui prima una query per i record esistenti usando identificatori univoci (email, dominio). Aggiorna se esiste, crea se non esiste.
+  </Accordion>
+
+  <Accordion title="Posso eliminare i record tramite API?">
+    Sì, usa mutation di delete (GraphQL) o richieste DELETE (REST).
+  </Accordion>
+
+  <Accordion title="Esiste un SDK per Python o Node.js?">
+    Al momento no, ma entrambe le API funzionano con qualsiasi client HTTP in qualsiasi linguaggio.
+  </Accordion>
+</AccordionGroup>
+
+## Documentazione API
+
+Per i dettagli completi di implementazione, esempi di codice e riferimento allo schema:
+
+* [Documentazione API](/l/it/developers/extend/api)

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx

@@ -0,0 +1,225 @@
+---
+title: Importare le relazioni tra oggetti tramite CSV
+description: Guida completa passo dopo passo per collegare i record durante l'importazione CSV.
+---
+
+## Panoramica
+
+Questa guida ti accompagna nell'importazione delle relazioni tra oggetti — ad esempio, collegare Persone ad Aziende o Opportunità a Persone.
+
+<Note>**Cosa può essere importato:** Solo relazioni uno-a-molti che puntano a un singolo tipo di oggetto. Le relazioni che puntano a più tipi di oggetto (come Note collegate a Persone E Aziende) non sono ancora supportate per l'importazione.</Note>
+
+## Comprendere le relazioni
+
+### Che cos'è una relazione "uno-a-molti"?
+
+In una relazione uno-a-molti:
+
+* **Una** Azienda ha **molte** Persone (dipendenti)
+* **Una** Azienda ha **molte** Opportunità
+* **Una** Persona ha **molte** Attività
+
+Il lato "uno" è il **genitore**. Il lato "molti" è il **figlio**.
+
+### Relazioni comuni in Twenty
+
+| Relazione             | Lato "uno" (genitore) | Lato "molti" (figlio) |
+| --------------------- | --------------------- | --------------------- |
+| Aziende → Persone     | Azienda               | Persone               |
+| Aziende → Opportunità | Azienda               | Opportunità           |
+| Persone → Attività    | Persona               | Attività              |
+| Persone → Note        | Persona               | Note                  |
+
+## Passaggio 1: Identifica i lati "Uno" e "Molti"
+
+Prima di importare, determina quale oggetto è il genitore e quale è il figlio.
+
+**Chiediti:** "Un [Oggetto A] ha molti [Oggetto B]?"
+
+* Un'Azienda → Molte Persone ✓ (l'Azienda è il genitore)
+* Una Persona → Molte Aziende ✗ (Questo è sbagliato: una persona appartiene a un'azienda)
+
+## Passaggio 2: Importa prima i record genitore
+
+Il genitore (lato "uno") deve esistere in Twenty prima di potervi fare riferimento.
+
+**Ordine di importazione:**
+
+1. **Aziende** per prime (nessuna dipendenza)
+2. **Persone** dopo (collegate alle Aziende)
+3. **Opportunità** al terzo posto (collegate ad Aziende e/o Persone)
+4. **Attività/Note** (collegate a uno qualsiasi dei precedenti)
+
+<Warning>
+**Se il record genitore non esiste, l'importazione fallirà.**
+
+Verifica sempre che le Aziende siano importate prima di importare le Persone con riferimenti all'Azienda.
+</Warning>
+
+## Passaggio 3: Annota l'identificatore univoco del genitore
+
+Devi fare riferimento al record genitore usando un **identificatore univoco**. Opzioni disponibili:
+
+| Oggetto genitore                  | Identificatori univoci disponibili                                           |
+| --------------------------------- | ---------------------------------------------------------------------------- |
+| **Aziende**                       | `id` (UUID), `domain` (consigliato) o qualsiasi campo univoco personalizzato |
+| **Persone**                       | `id` (UUID), `email` o qualsiasi campo univoco personalizzato                |
+| **Membri dello spazio di lavoro** | `id` (UUID), `email` (non il nome)                                           |
+| **Oggetti personalizzati**        | `id` (UUID) o qualsiasi campo contrassegnato come univoco                    |
+
+<Note>**Consigliato:** Usa `domain` per le Aziende ed `email` per le Persone. Sono leggibili e facili da verificare nel tuo foglio di calcolo.</Note>
+
+### Trovare l'identificatore
+
+Se ti serve l'`id`:
+
+1. Esporta i record genitore da Twenty
+2. L'esportazione include la colonna `id`
+3. Usa questi ID nel file dei record figlio
+
+## Passaggio 4: Verifica che il campo di relazione esista
+
+Prima di importare, assicurati che esista il campo di relazione tra i tuoi oggetti.
+
+**Per verificare o creare:**
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona il tuo oggetto figlio (ad es., Persone)
+3. Cerca un campo di relazione che punti al genitore (ad es., Azienda)
+4. Se non esiste, crealo:
+   * Fai clic su **+ Aggiungi campo**
+   * Seleziona il tipo **Relazione**
+   * Scegli l'oggetto genitore
+
+## Passaggio 5: Prepara il tuo file CSV
+
+Aggiungi al CSV dei record figlio una colonna che faccia riferimento al genitore usando il suo identificatore univoco.
+
+### Esempio: Persone collegate ad Aziende
+
+**Il tuo CSV delle Persone:**
+
+```csv
+firstName,lastName,email,jobTitle,companyDomain
+John,Smith,john@acme.com,CEO,https://acme.com
+Jane,Doe,jane@widgets.co,CTO,https://widgets.co
+Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
+```
+
+La colonna `companyDomain` fa riferimento al dominio dell'Azienda.
+
+### Requisiti di formato
+
+| Identificatore | Formato        | Esempio                                |
+| -------------- | -------------- | -------------------------------------- |
+| Dominio        | Formato URL    | `https://acme.com`                     |
+| Email          | Email standard | `john@acme.com`                        |
+| ID             | UUID           | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
+
+<Warning>
+**Il formato del dominio è importante!**
+
+Usa `https://domain.com` (non solo `domain.com`). Questo corrisponde a come Twenty archivia i domini delle Aziende e previene errori di corrispondenza.
+</Warning>
+
+### Regole importanti
+
+1. **Corrispondenza esatta richiesta** — il valore deve corrispondere esattamente al record genitore
+2. **Mappa un solo identificatore univoco** — non includere sia `companyId` che `companyDomain`
+3. **Sensibile alle maiuscole/minuscole** — `Acme.com` ≠ `acme.com`
+
+## Passaggio 6: Carica e mappa la relazione
+
+1. Vai all'oggetto figlio (ad es., Persone)
+2. Fai clic su **⋮** → **Importa record**
+3. Carica il tuo file CSV
+4. Nella fase di mappatura dei campi:
+   * Trova la tua colonna di relazione (ad es., `companyDomain`)
+   * Mappala al campo di relazione **Azienda**
+5. Completa le restanti mappature
+6. Controlla gli errori e conferma
+
+Twenty collegherà automaticamente ogni record figlio al genitore corrispondente.
+
+## Passaggio 7: Verifica l'importazione
+
+Dopo l'importazione:
+
+1. Apri alcuni record figlio (ad es., Persone)
+2. Verifica che il campo di relazione mostri il genitore corretto (ad es., Azienda)
+3. Apri un record genitore e controlla la sezione dei record correlati
+
+## Errori comuni da evitare
+
+| Errore                                    | Problema                                          | Soluzione                                                                          |
+| ----------------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| **Ordine di importazione errato**         | Importare le Persone prima delle Aziende          | Importa sempre prima i genitori, poi i figli                                       |
+| **Formato del dominio errato**            | Uso di `acme.com` invece di `https://acme.com`    | Usa il formato URL completo con `https://`                                         |
+| **Più campi univoci**                     | Mappare sia `companyId` che `companyDomain`       | Mappa un solo identificatore univoco                                               |
+| **Campo di relazione mancante**           | Il campo di relazione non esiste nel modello dati | Crealo in **Impostazioni → Modello dati** prima dell'importazione                  |
+| **Record inesistenti**                    | Il record genitore non esiste in Twenty           | Importa prima i record genitore oppure verifica la presenza di errori di battitura |
+| **Discrepanza tra maiuscole e minuscole** | `Acme.com` nel file ma `acme.com` in Twenty       | Assicurati che le maiuscole/minuscole corrispondano esattamente                    |
+
+## Collegamento ai membri del Workspace
+
+Quando colleghi i membri del Workspace (il tuo team):
+
+* Usa il loro **indirizzo email**, non il nome
+* Esempio: `owner@yourcompany.com`, non "John Smith"
+
+```csv
+taskName,assignedTo
+Follow up with client,john@yourcompany.com
+Review proposal,jane@yourcompany.com
+```
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Cosa succede se il mio record genitore non ha un dominio o un'email?">
+    Hai due opzioni:
+    1. Usa l'`id` di Twenty (esporta i record genitore per ottenere i loro ID)
+    2. Crea un campo univoco personalizzato nel tuo modello dati per archiviare un ID esterno dal sistema precedente
+  </Accordion>
+
+  <Accordion title="Posso aggiornare le relazioni sui record esistenti?">
+    Sì! Includi l'identificatore univoco del record figlio (ad es., `email` per Persone) e il nuovo valore della relazione. L'importazione aggiornerà la relazione.
+  </Accordion>
+
+  <Accordion title="Posso importare relazioni molti-a-molti?">
+    Le relazioni molti-a-molti non sono ancora supportate per l'importazione. È previsto per H1 2026.
+  </Accordion>
+
+  <Accordion title="Posso collegare a più tipi di oggetto (come Note a Persone E Aziende)?">
+    Le relazioni che puntano a più tipi di oggetto non sono ancora supportate per importazione/esportazione. È nella nostra roadmap.
+  </Accordion>
+
+  <Accordion title="Cosa succede se un record genitore non esiste?">
+    L'importazione mostrerà un errore per quella riga. Puoi:
+    * Importa prima il record genitore, poi ripeti l'importazione
+    * Correggi il valore di riferimento
+    * Rimuovi la riga dall'importazione
+  </Accordion>
+
+  <Accordion title="Perché la mia relazione non si collega correttamente?">
+    Cause comuni:
+    * Formato errato (usa `https://domain.com` per i domini)
+    * Discrepanza tra maiuscole e minuscole (controlla l'ortografia esatta)
+    * Il genitore non esiste (importa prima i genitori)
+    * Mappatura di più identificatori (usane uno solo)
+  </Accordion>
+</AccordionGroup>
+
+<Warning>
+**Ricorda: i record eliminati in modo non definitivo contano ai fini dell'unicità.**
+
+Se ricevi errori "not found" ma il record sembra esistere, controlla Menu comandi → Visualizza record eliminati. Il genitore potrebbe essere stato eliminato in modo non definitivo.
+</Warning>
+
+## Risoluzione dei problemi
+
+Hai problemi? Controlla:
+
+* [Come correggere gli errori di importazione](/l/it/user-guide/data-migration/how-tos/fix-import-errors)
+* [Capacità di importazione delle relazioni](/l/it/user-guide/data-migration/capabilities/import-relations)
+* [Vincoli di unicità](/l/it/user-guide/data-migration/capabilities/uniqueness-constraints)

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx

@@ -0,0 +1,289 @@
+---
+title: Migrazione da altri CRM
+description: Guida passo-passo per migrare i tuoi dati da qualsiasi CRM a Twenty.
+---
+
+## Panoramica
+
+Questa guida ti accompagna nella migrazione dei tuoi dati da qualsiasi CRM a Twenty. Il processo prevede la revisione dei tuoi dati, la preparazione del tuo spazio di lavoro Twenty, l'esportazione dal sistema attuale e l'importazione in Twenty.
+
+<Note>Le viste, i flussi di lavoro e le autorizzazioni devono essere ricreati manualmente dopo la migrazione. Pianifica il tempo per questo lavoro di configurazione.</Note>
+
+## Passaggio 1: Verifica dei tuoi dati correnti
+
+La migrazione è un'opportunità per un nuovo inizio. Non trasferire il superfluo.
+
+**Cosa mantenere:**
+
+* Contatti e aziende attivi
+* Opportunità e trattative aperte
+* Note e attività importanti
+* Campi personalizzati che utilizzi effettivamente
+
+**Cosa lasciare indietro:**
+
+* Contatti obsoleti (nessuna attività da 2 o più anni)
+* Record duplicati
+* Dati di test
+* Campi personalizzati inutilizzati
+
+## Passaggio 2: Mappa il tuo modello di dati
+
+Crea un documento di mappatura tra il tuo CRM attuale e Twenty:
+
+| Il tuo CRM               | Twenty                     |
+| ------------------------ | -------------------------- |
+| Account / Organizzazione | **Azienda**                |
+| Contatto / Persona       | **Persone**                |
+| Trattativa / Opportunità | **Opportunità**            |
+| Attività                 | **Attività** o **Nota**    |
+| Oggetto personalizzato   | **Oggetto personalizzato** |
+
+**Per ogni campo, documenta:**
+
+* Il nome del campo di origine
+* Il campo di destinazione di Twenty
+* Eventuali trasformazioni di formato necessarie (date, numeri di telefono, ecc.)
+
+<Note>Tieni a portata di mano questo documento di mappatura durante l'importazione—lo userai come riferimento quando mapperai le colonne.</Note>
+
+## Passaggio 3: Configura il tuo spazio di lavoro Twenty
+
+Prima di importare i dati, prepara il tuo spazio di lavoro Twenty:
+
+### Crea oggetti e campi personalizzati
+
+1. Vai a **Impostazioni → Modello dati**
+2. Crea tutti gli oggetti personalizzati di cui hai bisogno
+3. Aggiungi campi personalizzati agli oggetti standard e personalizzati
+4. Configura le impostazioni dei campi (univoche, obbligatorie, opzioni dei campi di selezione, ecc.)
+
+<Warning>
+**I campi devono esistere prima dell'importazione.**
+
+L'importazione CSV crea record, non campi. Crea tutti i campi personalizzati in Impostazioni → Modello dati prima dell'importazione.
+</Warning>
+
+### Invita il tuo team
+
+<Warning>
+**Invita gli utenti PRIMA di importare i dati.**
+
+Se i tuoi dati includono riferimenti a utenti (Proprietario dell'account, Assegnatario, ecc.), tali utenti devono esistere in Twenty prima dell'importazione. In caso contrario, tali relazioni non possono essere mappate.
+</Warning>
+
+1. Vai a **Impostazioni → Membri**
+2. Invita tutti i membri del team
+3. **Attendi che tutti accettino** il loro invito
+4. Verifica che tutti gli utenti compaiano nell'elenco Membri
+
+## Passaggio 4: Esporta dal tuo CRM attuale
+
+Esporta i tuoi dati dal tuo CRM attuale:
+
+1. Cerca una funzione di **Esportazione** (di solito in Impostazioni, Gestione dei dati o Amministrazione)
+2. Esporta in **formato CSV** quando possibile
+3. Esporta separatamente ogni tipo di oggetto (Aziende, Contatti, Trattative, ecc.)
+4. Includi tutti i campi che desideri migrare
+
+**Esporta questi oggetti (in questo ordine come riferimento):**
+
+1. Aziende / Account / Organizzazioni
+2. Contatti / Persone
+3. Trattative / Opportunità
+4. Note e Attività
+5. Oggetti personalizzati
+
+## Passaggio 5: Pulisci e formatta i tuoi dati
+
+Apri ogni file CSV esportato in un'applicazione di fogli di calcolo e preparalo per Twenty.
+
+### Rimuovi i duplicati
+
+1. Ordina per il campo univoco (email per Persone, dominio per Aziende)
+2. Rimuovi o unisci le righe duplicate
+3. Verifica che non esistano già duplicati in Twenty
+
+### Formatta correttamente i campi
+
+| Tipo di campo          | Formato richiesto                                          |
+| ---------------------- | ---------------------------------------------------------- |
+| **Dominio**            | `https://domain.com`                                       |
+| **Email**              | `name@domain.com` (deve essere univoco)                    |
+| **Data**               | `YYYY-MM-DD`                                               |
+| **Telefono**           | Tre colonne: Numero, Codice paese, Prefisso internazionale |
+| **Booleano**           | `TRUE` o `FALSE` (maiuscolo)                               |
+| **Campi di selezione** | Usa i nomi API, non le etichette visualizzate              |
+
+<Warning>
+**Il formato del dominio è fondamentale.**
+
+Usa `https://domain.com` (non `domain.com` o `www.domain.com`). Questo corrisponde al formato di Twenty ed evita duplicati quando colleghi la sincronizzazione di email e calendario.
+</Warning>
+
+Consulta [Come preparare i tuoi file CSV](/l/it/user-guide/data-migration/how-tos/prepare-your-csv-files) per i requisiti di formattazione completi per tutti i tipi di campo.
+
+### Aggiungi colonne di relazione
+
+Per collegare i record (ad es., Persone ad Aziende), aggiungi una colonna con l'identificatore univoco del record padre.
+
+**Esempio: CSV Persone con collegamento all'Azienda**
+
+```csv
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+Consulta [Come importare le relazioni](/l/it/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) per istruzioni dettagliate sul collegamento dei record.
+
+### Aggiorna i riferimenti agli utenti
+
+Se i tuoi dati includono assegnazioni utente (Proprietario, Assegnatario):
+
+1. Aggiungi una colonna con l'**email dell'utente** (non solo il suo ID dal vecchio sistema)
+2. Usa gli stessi indirizzi email che gli utenti hanno utilizzato per unirsi al tuo spazio di lavoro Twenty
+
+Consulta [Come preparare i tuoi file CSV](/l/it/user-guide/data-migration/how-tos/prepare-your-csv-files) per la guida completa alla formattazione.
+
+## Passaggio 6: Importa in Twenty
+
+<Warning>
+**L'ordine di importazione è importante!**
+
+Importa sempre in questo ordine:
+1. **Aziende** per prime (nessuna dipendenza)
+2. **Persone** al secondo posto (collegate alle Aziende)
+3. **Opportunità** al terzo posto (collegate ad Aziende/Persone)
+4. **Note e Attività** (collegate ai record)
+5. **Oggetti personalizzati** seguendo le relative dipendenze
+
+Il record padre deve esistere prima di potervi fare riferimento.
+</Warning>
+
+### Importa ogni oggetto
+
+Per ogni file CSV, in ordine:
+
+1. Vai all'oggetto in Twenty
+2. Fai clic su **⋮ → Importa record**
+3. Carica il file CSV
+4. Mappa le colonne ai campi:
+   * Mappa le colonne delle email degli utenti ai campi relazione appropriati
+   * Mappa le colonne di relazione (come `companyDomain`) ai campi di relazione
+5. Controlla e correggi eventuali errori nell'interfaccia
+6. Conferma l'importazione
+7. Verifica alcuni record prima di passare al file successivo
+
+**Guide dettagliate:**
+
+* [Come importare le aziende](/l/it/user-guide/data-migration/how-tos/import-companies-via-csv)
+* [Come importare i contatti](/l/it/user-guide/data-migration/how-tos/import-contacts-via-csv)
+* [Come importare le relazioni](/l/it/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+
+## Passaggio 7: Migrazioni di grandi dimensioni (oltre 50.000 record)
+
+Per migrazioni di grandi dimensioni:
+
+| Volume                 | Approccio consigliato    |
+| ---------------------- | ------------------------ |
+| Meno di 10.000 record  | Importazione CSV singola |
+| 10.000 - 50.000 record | Dividi in più file CSV   |
+| Oltre 50.000 record    | Usa le API               |
+
+**Per le importazioni tramite API:**
+
+* Più veloce e più affidabile per set di dati di grandi dimensioni
+* Supporta operazioni in batch (fino a 60 record per chiamata)
+* Consulta [Come importare i dati tramite API](/l/it/user-guide/data-migration/how-tos/import-data-via-api)
+
+## Passaggio 8: Configurazione post-migrazione
+
+Dopo aver importato i dati, completa la configurazione del tuo spazio di lavoro:
+
+### Ricrea le viste
+
+* Configura viste salvate con filtri, ordinamenti e configurazioni delle colonne
+* Crea eventuali viste kanban o calendario di cui hai bisogno
+
+### Ricrea i Flussi di Lavoro
+
+* Ricrea le automazioni in **Impostazioni → Flussi di lavoro**
+* Inizia dai flussi di lavoro più critici
+* Testa ciascuno prima di farci affidamento
+
+### Configura ruoli e permessi
+
+* Configura i ruoli in **Impostazioni → Membri → Ruoli**
+* Assegna gli utenti ai ruoli appropriati
+
+### Collega email e calendario
+
+* Ogni utente collega il proprio account in **Impostazioni → Account**
+* Twenty inizierà a sincronizzare le email con i record dei contatti
+* Consulta [Email e Calendario](/l/it/user-guide/calendar-emails/overview)
+
+### Forma il tuo team
+
+* Esamina insieme al team la nuova interfaccia
+* Documenta eventuali processi specifici del team
+
+## Problemi comuni e soluzioni
+
+| Problema                          | Causa                              | Soluzione                                                                                               |
+| --------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| **Errori di duplicazione**        | Email/dominio già esistente        | Rimuovi i duplicati dal file oppure includi un identificatore univoco per aggiornare i record esistenti |
+| **Relazione non trovata**         | Il record padre non esiste         | Importa prima gli oggetti padre (Aziende prima delle Persone)                                           |
+| **Campi mancanti**                | Il campo personalizzato non esiste | Crea il campo in Impostazioni → Modello dati prima dell'importazione                                    |
+| **Errori nei campi di selezione** | Uso delle etichette visualizzate   | Usa i nomi API (attiva la modalità Avanzata in Impostazioni per trovarli)                               |
+| **Relazione utente vuota**        | L'utente non ha accettato l'invito | Assicurati che tutti gli utenti accettino gli inviti prima di importare                                 |
+
+Consulta [Come correggere gli errori di importazione](/l/it/user-guide/data-migration/how-tos/fix-import-errors) per passaggi dettagliati di risoluzione dei problemi.
+
+## Lista di Verifica Post-Migrazione
+
+### Integrità dei dati
+
+<Check>Tutti i record importati (confronta i conteggi con il sistema di origine)</Check>
+<Check>Relazioni funzionanti correttamente (Persone collegate ad Aziende)</Check>
+<Check>Assegnazioni utente mappate correttamente (Proprietario, Assegnatario)</Check>
+<Check>Campi personalizzati compilati</Check>
+<Check>Nessun duplicato imprevisto</Check>
+
+### Configurazione
+
+<Check>Viste ricreate</Check>
+<Check>Flussi di lavoro ricreati e testati</Check>
+<Check>Ruoli e permessi configurati</Check>
+<Check>Sincronizzazione email/calendario connessa</Check>
+
+### Preparazione del team
+
+<Check>Team formato sul nuovo sistema</Check>
+<Check>Piano di accesso al vecchio CRM deciso (mantenerlo come riferimento? Quando disattivarlo?)</Check>
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Posso migrare i flussi di lavoro automaticamente?">
+    Al momento no. I flussi di lavoro devono essere ricreati manualmente in Twenty.
+  </Accordion>
+
+  <Accordion title="Che cosa succede agli allegati?">
+    Gli allegati non sono inclusi nelle esportazioni CSV. Dovrai ricaricarli manualmente, migrarli tramite API oppure contattare il nostro team per assistenza.
+  </Accordion>
+
+  <Accordion title="Posso mantenere entrambi i sistemi attivi durante la migrazione?">
+    Sì, consigliamo di mantenere attivo il tuo vecchio CRM finché non avrai verificato che la migrazione sia completa. Fai solo attenzione a non creare nuovi dati in entrambi gli ambienti.
+  </Accordion>
+
+  <Accordion title="Quanto tempo richiede di solito la migrazione?">
+    Dipende dal volume e dalla complessità dei dati. Le migrazioni di piccole dimensioni (meno di 10.000 record) possono essere completate in poche ore. Le migrazioni di grandi dimensioni possono richiedere diversi giorni, compresi la pulizia dei dati e i test.
+  </Accordion>
+</AccordionGroup>
+
+## Hai Bisogno di Aiuto?
+
+<Tip>
+  Vuoi aiuto con la tua migrazione? [Trova un partner Twenty certificato](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-migrate-crm) per spostare i dati, le pipeline e gli utenti end-to-end.
+</Tip>

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx

@@ -0,0 +1,173 @@
+---
+title: Migrazione da Soluzioni Self-Hosted a Cloud
+description: Guida passo-passo per migrare la tua istanza Twenty self-hosted verso Twenty Cloud.
+---
+
+## Panoramica
+
+Questa guida ti accompagna nella migrazione dei tuoi dati da un'istanza Twenty self-hosted a Twenty Cloud. Il processo prevede la configurazione dello spazio di lavoro cloud, l'esportazione dei dati e la loro reimportazione.
+
+<Note>Le viste, i flussi di lavoro e i ruoli devono essere ricreati manualmente dopo la migrazione. Pianifica il tempo per questo lavoro di configurazione.</Note>
+
+## Passaggio 1: Crea il tuo spazio di lavoro cloud
+
+1. Vai su [app.twenty.com](https://app.twenty.com) e crea un nuovo spazio di lavoro
+2. Completa la procedura guidata iniziale
+3. Annota l'URL del tuo nuovo spazio di lavoro
+
+## Passaggio 2: Ricrea il tuo modello dati
+
+Prima di importare i dati, ricrea i tuoi oggetti e campi personalizzati:
+
+1. Vai a **Impostazioni → Modello dati** nella tua istanza cloud
+2. Crea oggetti personalizzati che corrispondano alla tua configurazione self-hosted
+3. Aggiungi campi personalizzati agli oggetti standard e personalizzati
+4. Configura le impostazioni dei campi (univoche, obbligatorie, ecc.)
+
+<Note>Fai degli screenshot del tuo modello dati self-hosted come riferimento oppure tieni entrambe le istanze aperte affiancate.</Note>
+
+## Passaggio 3: Invita tutti gli utenti
+
+<Warning>
+**Critico: invita gli utenti PRIMA di importare i dati.**
+
+Gli utenti devono accettare i loro inviti prima di importare qualsiasi record che faccia riferimento a loro (come i campi Account Owner). Se gli utenti non esistono ancora, tali relazioni non possono essere mappate.
+</Warning>
+
+1. Vai a **Impostazioni → Membri** nella tua istanza cloud
+2. Invita tutti i membri del team che avevano account sull'istanza self-hosted
+3. **Attendi che tutti accettino** il loro invito
+4. Verifica che tutti gli utenti compaiano nell'elenco Membri
+
+## Passaggio 4: Esporta i dati dall'istanza self-hosted
+
+Esporta ogni oggetto dalla tua istanza self-hosted:
+
+1. Vai a ciascun oggetto (Aziende, Persone, Opportunità, ecc.)
+2. Configura la vista per mostrare **tutte le colonne** che vuoi migrare
+3. Fai clic su **⋮ → Esporta vista**
+4. Salva ogni file CSV con un nome chiaro (ad es., `companies-export.csv`)
+
+**Esporta in questo ordine** (come riferimento durante l'importazione):
+
+1. Aziende
+2. Persone
+3. Opportunità
+4. Oggetti personalizzati (seguendo le loro dipendenze)
+5. Attività, Note
+
+## Passaggio 5: Aggiorna i riferimenti ai membri dello spazio di lavoro
+
+I CSV esportati contengono gli ID utente della tua istanza self-hosted. Questi ID non corrisponderanno alla tua istanza cloud, quindi devi sostituirli con le email.
+
+**Per ogni file CSV con riferimenti utente (Owner, Assignee, ecc.):**
+
+1. Apri il CSV in un'applicazione per fogli di calcolo
+2. Aggiungi una nuova colonna accanto a ciascuna colonna di ID utente (ad es., `accountOwnerEmail` accanto a `accountOwnerId`)
+3. Compila l'**indirizzo email** di ciascun utente
+4. Puoi eliminare la vecchia colonna ID oppure lasciarla (verrà ignorata durante l'importazione)
+
+**Esempio:**
+
+Prima:
+
+```csv
+name,domain,accountOwnerId
+Acme Corp,https://acme.com,old-uuid-123
+```
+
+Dopo:
+
+```csv
+name,domain,accountOwnerEmail
+Acme Corp,https://acme.com,john@yourcompany.com
+```
+
+<Note>Usa gli stessi indirizzi email che gli utenti hanno usato per accettare l'invito allo spazio di lavoro cloud.</Note>
+
+## Passaggio 6: Pianifica l'ordine di importazione
+
+Importa i file nel giusto ordine per mantenere le relazioni:
+
+1. **Aziende** per prime (nessuna dipendenza)
+2. **Persone** dopo (collegate alle Aziende)
+3. **Opportunità** al terzo posto (collegate ad Aziende e Persone)
+4. **Oggetti personalizzati** (seguendo le loro dipendenze)
+5. **Attività e Note** per ultime (collegate ad altri record)
+
+Consulta [Come importare le relazioni](/l/it/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) per i dettagli su come mantenere le relazioni.
+
+## Passaggio 7: Importa nel cloud
+
+Per ogni file CSV, in ordine:
+
+1. Vai all'oggetto nella tua istanza cloud
+2. Fai clic su **⋮ → Importa record**
+3. Carica il file CSV
+4. Mappa le colonne ai campi:
+   * Mappa le colonne delle email degli utenti ai campi relazione appropriati
+   * Mappa le altre colonne come al solito
+5. Controlla e correggi eventuali errori
+6. Conferma l'importazione
+7. Verifica alcuni record prima di passare al file successivo
+
+## Passaggio 8: Ricrea la configurazione
+
+Dopo aver importato i dati, ricrea manualmente:
+
+### Viste
+
+* Ricrea le viste salvate con filtri, ordinamenti e configurazioni delle colonne
+* Configura eventuali viste kanban o calendario
+
+### Flussi di Lavoro
+
+* Ricrea le automazioni in **Impostazioni → Flussi di lavoro**
+* Testa ogni flusso di lavoro prima di farci affidamento
+
+### Ruoli e permessi
+
+* Configura i ruoli in **Impostazioni → Membri → Ruoli**
+* Assegna gli utenti ai ruoli appropriati
+
+### Integrazioni
+
+* Riconnetti la sincronizzazione di email e calendario per ogni utente
+* Riconfigura eventuali integrazioni API con nuove chiavi API
+
+## Lista di Verifica Post-Migrazione
+
+<Check>Tutti i dati importati correttamente</Check>
+<Check>Relazioni tra oggetti funzionanti correttamente</Check>
+<Check>Assegnazioni utente (Owner, Assignee) mappate correttamente</Check>
+<Check>Viste ricreate</Check>
+<Check>Flussi di lavoro ricreati e testati</Check>
+<Check>Ruoli e permessi configurati</Check>
+<Check>Sincronizzazione email/calendario riconnessa</Check>
+<Check>Integrazioni API aggiornate con nuove chiavi</Check>
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Posso migrare i flussi di lavoro automaticamente?">
+    Al momento no. I flussi di lavoro devono essere ricreati manualmente nella tua istanza cloud.
+  </Accordion>
+
+  <Accordion title="Che cosa succede agli allegati e alle immagini?">
+    Gli allegati non sono inclusi nelle esportazioni CSV. Dovrai ricaricare manualmente gli allegati, migrarli tramite API oppure contattare il nostro team per assistenza con migrazioni di grandi dimensioni.
+  </Accordion>
+
+  <Accordion title="Posso mantenere entrambe le istanze operative durante la migrazione?">
+    Sì, consigliamo di mantenere attiva la tua istanza self-hosted finché non avrai verificato che la migrazione al cloud sia completa. Fai solo attenzione a non creare nuovi dati in entrambi gli ambienti.
+  </Accordion>
+
+  <Accordion title="Cosa succede se un utente non ha ancora accettato l'invito?">
+    I record che fanno riferimento a quell'utente non verranno importati oppure la relazione risulterà vuota. Assicurati che tutti gli utenti accettino gli inviti prima di importare i dati.
+  </Accordion>
+</AccordionGroup>
+
+## Hai Bisogno di Aiuto?
+
+<Tip>
+  Stai eseguendo la migrazione di uno spazio di lavoro grande o complesso? [Trova un partner Twenty certificato](https://twenty.com/partners/list?categories=HOSTING\&ref=docs-migrate-cloud) per gestire l’intera migrazione end-to-end. *(Oppure coinvolgi il nostro team: [contact@twenty.com](mailto:contact@twenty.com).)*
+</Tip>

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx

@@ -0,0 +1,267 @@
+---
+title: Prepara i tuoi file CSV
+description: Guida completa passo passo per formattare i tuoi dati per l'importazione in Twenty.
+---
+
+## Panoramica
+
+Questa guida ti accompagna nella preparazione del tuo file CSV per un'importazione riuscita. Segui questi passaggi per evitare errori.
+
+## Passaggio 1: Controlla i requisiti del file
+
+Prima di iniziare, assicurati che il tuo file soddisfi questi requisiti:
+
+| Requisito                | Dettagli                    |
+| ------------------------ | --------------------------- |
+| **Formato**              | CSV, XLSX o XLS             |
+| **Limite di dimensione** | 10.000 record per file      |
+| **Codifica**             | Si consiglia UTF-8          |
+| **Struttura**            | Un tipo di oggetto per file |
+
+<Note>Per set di dati superiori a 10.000 record, suddividi in più file oppure usa l'[importazione tramite API](/l/it/user-guide/data-migration/how-tos/import-data-via-api).</Note>
+
+## Passaggio 2: Scarica il file di esempio
+
+**Questo è il passaggio più importante.** Il file di esempio ti mostra i nomi delle colonne e il formato esatti che Twenty si aspetta.
+
+1. Vai alla vista dell'oggetto (Persone, Aziende, ecc.)
+2. Fai clic su **⋮** → **Importa record**
+3. Fai clic su **Scarica file di esempio**
+4. Usa questo file come modello
+
+<Note>**Suggerimento avanzato:** Esporta invece alcuni record esistenti. Questo ti fornisce esempi reali di come i dati devono essere formattati e i nomi delle colonne verranno mappati automaticamente durante l'importazione.</Note>
+
+## Passaggio 3: Rimuovi i valori duplicati
+
+Twenty impone l'unicità su alcuni campi. I duplicati causeranno errori di importazione.
+
+| Oggetto                    | Campi unici                                                   |
+| -------------------------- | ------------------------------------------------------------- |
+| **Persone**                | `id`, `email`                                                 |
+| **Aziende**                | `id`, `domain`                                                |
+| **Oggetti personalizzati** | `id`, più qualsiasi campo che hai contrassegnato come univoco |
+
+**Prima dell'importazione:**
+
+1. Ordina il tuo foglio di calcolo in base al campo univoco (email o dominio)
+2. Rimuovi o unisci le righe duplicate
+3. Verifica la presenza di duplicati già esistenti in Twenty
+
+<Warning>**I record eliminati in modo non definitivo contano ai fini dell'unicità.** I record in Menu Comandi → Vedi record eliminati causeranno errori di duplicato. Eliminali definitivamente oppure ripristinali e aggiornali.</Warning>
+
+## Passaggio 4: Formattta correttamente ogni tipo di campo
+
+Tipi di campo diversi richiedono formati specifici. Ecco il riferimento completo:
+
+### Campi di testo
+
+* Non è richiesta una formattazione speciale
+* Gli spazi iniziali/finali vengono rimossi automaticamente
+
+### Campi email
+
+* Deve avere un formato email valido: `name@domain.com`
+* Deve essere univoco (nessun duplicato nel file o in Twenty)
+* Per email aggiuntive, usa questo formato nella colonna **Email / Email aggiuntive**:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### Campi del dominio
+
+* **Formato consigliato**: `https://domain.com`
+* Questo corrisponde al formato usato dalla sincronizzazione della casella di posta/calendario (evita duplicati)
+* Compila entrambe le colonne:
+  * **Dominio / Etichetta dominio**: `domain.com`
+  * **Dominio / URL dominio**: `https://domain.com`
+* Deve essere univoco all'interno del tuo file e in Twenty
+
+### Campi telefono
+
+Il telefono è un **campo annidato** che richiede più colonne:
+
+| Colonna                                                        | Esempio      |
+| -------------------------------------------------------------- | ------------ |
+| **Telefoni / Numero di telefono principale**                   | `4159095555` |
+| **Telefoni / Codice paese del telefono principale**            | `US`         |
+| **Telefoni / Prefisso internazionale del telefono principale** | `+1`         |
+
+### Campi indirizzo
+
+Indirizzo è un **campo annidato** con più colonne (alcune possono essere lasciate vuote):
+
+* **Indirizzo / Indirizzo 1**: Riga indirizzo 1
+* **Indirizzo / Indirizzo 2**: Riga indirizzo 2 (facoltativa)
+* **Indirizzo / Città**: Nome città
+* **Indirizzo / Stato**: Stato o provincia
+* **Indirizzo / Paese**: Nome paese
+* **Indirizzo / Codice postale**: Codice postale/CAP
+
+### Campi data
+
+Usa un formato coerente in tutto il file:
+
+* `YYYY-MM-DD` (consigliato): `2024-03-15`
+* ISO 8601: `2024-03-15T10:30:00Z`
+
+### Campi numerici
+
+* Solo numeri (nessun testo)
+* Usa il punto per i decimali: `1234.56`
+* Nessun separatore delle migliaia (non `1,234.56`)
+
+### Campi valuta
+
+Valuta è un **campo annidato** che richiede due colonne che **devono essere entrambe compilate**:
+
+| Colonna               | Esempio   |
+| --------------------- | --------- |
+| **Importo / Importo** | `1234.56` |
+| **Importo / Valuta**  | `USD`     |
+
+### Campi booleani
+
+Usa il maiuscolo: `TRUE` o `FALSE`
+
+<Warning>Le minuscole `true` o `false` non funzioneranno.</Warning>
+
+### Campi Selezione
+
+Usa il **nome API** dell'opzione, non l'etichetta di visualizzazione.
+
+**Come trovare i nomi API:**
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona l'oggetto e il campo
+3. Abilita la **Modalità avanzata** (interruttore in basso a destra)
+4. Copia il nome API (ad es., `OPTION_1`, non "Option 1")
+
+<Note>Le nuove opzioni di selezione non vengono create automaticamente. Aggiungile in **Impostazioni → Modello dati** prima di importare.</Note>
+
+### Campi a selezione multipla
+
+Usa i nomi API in formato array:
+
+```
+["VALUE1","VALUE2"]
+```
+
+### Campi array
+
+Usa il formato array JSON:
+
+```
+["value1","value2"]
+```
+
+### Campi di valutazione
+
+Usa il formato: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4` o `RATING_5`
+
+### Campi Link/URL
+
+Compila entrambe le colonne:
+
+* **Link / Etichetta del link**: `Twenty`
+* **Link / URL del link**: `https://twenty.com`
+
+Per i link secondari, usa la colonna **Link / Link secondari**:
+
+```
+[{"url":"https://twenty.com","label":"Twenty"}]
+```
+
+### Campi JSON
+
+Usa un formato JSON valido:
+
+```
+{"key":"value","key2":"value2"}
+```
+
+### Campi ID
+
+* **Opzionale**: Twenty genera automaticamente gli ID se non forniti
+* **Formato**: UUID (ad es., `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`)
+* **Caso d'uso**: Includi l'ID per aggiornare i record esistenti invece di crearne di nuovi
+
+## Passaggio 5: Aggiungi colonne di relazione (se colleghi record)
+
+Per collegare i record ad altri oggetti (ad es., Persone ad Aziende), aggiungi una colonna con l'identificatore univoco del record correlato.
+
+**Esempio**: collegare Persone ad Aziende
+
+Aggiungi una colonna al CSV Persone:
+
+```
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+**Regole importanti per le relazioni:**
+
+* Il record padre deve già esistere in Twenty
+* Usa il formato **URL del dominio** (`https://domain.com`), non l'etichetta
+* Mappa un solo identificatore univoco (non includere sia `companyId` che `companyDomain`)
+* Per i membri dello spazio di lavoro, usa la loro **email** (non il nome)
+
+<Warning>
+**L'ordine di importazione è importante!**
+
+Importa il lato "uno" prima del lato "molti":
+1. **Aziende** prima
+2. **Persone** poi (con riferimento all'azienda)
+3. **Opportunità** al terzo posto
+
+Il record padre deve esistere prima di potervi fare riferimento.
+</Warning>
+
+Consulta [Come importare le relazioni](/l/it/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) per istruzioni dettagliate.
+
+## Passaggio 6: Verifica che i campi esistano in Twenty
+
+L'importazione crea record, non campi. Tutti i campi che vuoi importare devono già esistere nel tuo modello dati.
+
+**Prima di importare:**
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona il tuo oggetto
+3. Crea gli eventuali campi personalizzati necessari
+4. Annota i nomi esatti dei campi (devono corrispondere alle intestazioni delle colonne)
+
+## Passaggio 7: Lista di controllo finale
+
+Prima di caricare il file, verifica:
+
+<Check>Il file è in formato CSV, XLSX o XLS</Check>
+<Check>Il file contiene meno di 10.000 record</Check>
+<Check>La codifica è UTF-8</Check>
+<Check>Nessuna email duplicata (per Persone) o domini (per Aziende)</Check>
+<Check>Le date usano un formato coerente ovunque</Check>
+<Check>I domini usano il formato `https://domain.com`</Check>
+<Check>I campi booleani usano `TRUE` o `FALSE` (maiuscolo)</Check>
+<Check>I campi di selezione usano i nomi API, non le etichette di visualizzazione</Check>
+<Check>Tutti i campi personalizzati esistono in Impostazioni → Modello dati</Check>
+<Check>I record padre sono importati prima dei record figlio</Check>
+<Check>Le colonne di relazione fanno riferimento a record esistenti</Check>
+
+## Errori comuni da evitare
+
+| Errore                                                          | Soluzione                                            |
+| --------------------------------------------------------------- | ---------------------------------------------------- |
+| Uso di `true` invece di `TRUE`                                  | I valori booleani devono essere in maiuscolo         |
+| Uso delle etichette di visualizzazione per i campi di selezione | Trova e usa i nomi API in Impostazioni               |
+| Importare Persone prima delle Aziende                           | Importa sempre prima gli oggetti padre               |
+| Codice valuta mancante per i campi di valuta                    | Compila sia la colonna Importo sia la colonna Valuta |
+| Formato di dominio errato                                       | Usa `https://domain.com` in modo coerente            |
+| Mappatura di più campi univoci per le relazioni                 | Mappa solo UNO (dominio O id, non entrambi)          |
+
+## Prossimi Passi
+
+Il tuo file è pronto! Ora:
+
+* [Importa Aziende](/l/it/user-guide/data-migration/how-tos/import-companies-via-csv) (importale per prime)
+* [Importa Contatti](/l/it/user-guide/data-migration/how-tos/import-contacts-via-csv)
+* [Correggi eventuali errori di importazione](/l/it/user-guide/data-migration/how-tos/fix-import-errors)

packages/twenty-docs/l/it/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx

@@ -0,0 +1,198 @@
+---
+title: Aggiorna i record esistenti tramite importazione
+description: Guida completa passo dopo passo per aggiornare in blocco i record usando l'importazione CSV.
+---
+
+## Panoramica
+
+Devi aggiornare molti record in una sola volta? Invece di modificarli uno per uno, usa l'importazione CSV per aggiornare in blocco i record esistenti.
+
+**Casi di utilizzo:**
+
+* Aggiorna i titoli professionali per più persone
+* Modifica in blocco le informazioni sulle aziende
+* Aggiungi dati ai nuovi campi personalizzati
+* Correggi gli errori dei dati su molti record
+
+## Come Funziona
+
+Quando importi un file che contiene un **identificatore univoco** corrispondente a un record esistente, Twenty aggiorna quel record invece di crearne un duplicato.
+
+| Se l'identificatore univoco...    | Twenty farà...                                             |
+| --------------------------------- | ---------------------------------------------------------- |
+| Corrisponde a un record esistente | **Aggiorna** il record esistente                           |
+| Non corrisponde ad alcun record   | **Crea** un nuovo record                                   |
+| Manca nel tuo file                | **Crea** un nuovo record (con ID generato automaticamente) |
+
+<Warning>
+**I campi Multi-Select vengono sovrascritti, non uniti.**
+
+Se un record ha `Option A` e `Option B` selezionate e importi `["Option C"]`, il record avrà solo `Option C` dopo l'importazione. L'importazione sostituisce tutte le selezioni precedenti: non le aggiunge.
+
+Per mantenere i valori esistenti, includili tutti nella tua importazione: `["Option A","Option B","Option C"]`
+</Warning>
+
+## Passaggio 1: Esporta i tuoi dati correnti
+
+Per prima cosa, esporta i record che vuoi aggiornare:
+
+1. Vai all'oggetto (Persone, Aziende, ecc.)
+2. **Aggiungi le colonne necessarie** — fai clic su **Options → Fields** per mostrare i campi che vuoi aggiornare
+3. **Filtra se necessario** — limita ai soli record che vuoi aggiornare
+4. Fai clic su **⋮** → **Esporta vista**
+5. Salva il file CSV
+
+<Note>**Perché esportare prima?** Il file esportato ha il formato corretto, include gli identificatori univoci e viene mappato automaticamente durante l'importazione.</Note>
+
+### Cosa viene esportato
+
+* Tutte le colonne visibili nella vista corrente
+* Gli identificatori univoci del record (`id`, `email`, `domain`)
+* Valori attuali dei campi che puoi modificare
+
+## Passaggio 2: Modifica il file CSV
+
+Apri il file esportato nella tua applicazione di fogli di calcolo (Excel, Google Sheets, ecc.):
+
+1. **Mantieni la colonna dell'identificatore univoco** — non eliminare `id`, `email` o `domain`
+2. **Aggiorna i valori** nelle colonne che vuoi modificare
+3. **Rimuovi le colonne che non devi aggiornare** (opzionale, ma più pulito)
+4. **Non modificare i valori dell'identificatore univoco** — altrimenti Twenty creerà nuovi record
+
+### Esempio: aggiornare i titoli professionali
+
+**File esportato:**
+
+```csv
+id,email,firstName,lastName,jobTitle
+550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
+550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
+550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
+```
+
+**Dopo le tue modifiche:**
+
+```csv
+id,email,firstName,lastName,jobTitle
+550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
+550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
+550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
+```
+
+<Warning>
+**Non modificare i valori dell'identificatore univoco.**
+
+Se modifichi `john@acme.com` in `john.smith@acme.com`, Twenty creerà un nuovo record invece di aggiornare quello esistente.
+</Warning>
+
+## Passaggio 3: Importa il file aggiornato
+
+1. Vai all'oggetto
+2. Fai clic su **⋮** → **Importa record**
+3. Carica il file CSV modificato
+4. **Assicurati che l'identificatore univoco sia mappato** — verifica che `email`, `domain` o `id` siano mappati correttamente
+5. Rivedi le mappature dei campi
+6. Verifica la presenza di errori
+7. Fai clic su **Conferma**
+
+Twenty abbina i record in base all'identificatore univoco e li aggiorna con i nuovi valori.
+
+## Scegliere l'identificatore univoco giusto
+
+| Oggetto                    | Consigliato             | Alternativa | Note                                    |
+| -------------------------- | ----------------------- | ----------- | --------------------------------------- |
+| **Persone**                | `email`                 | `id`        | L'email è leggibile                     |
+| **Aziende**                | `dominio`               | `id`        | Il dominio è leggibile                  |
+| **Oggetti personalizzati** | Qualsiasi campo univoco | `id`        | Usa il tuo campo univoco personalizzato |
+
+<Note>**Usa un solo identificatore univoco.** Non mappare sia `email` che `id`. Questo può causare confusione ed errori.</Note>
+
+### Utilizzo di campi univoci personalizzati
+
+Se hai un campo personalizzato contrassegnato come univoco (come un ID esterno da un altro sistema):
+
+1. Includi quel campo nell'esportazione e nell'importazione
+2. Mappalo durante l'importazione
+3. Twenty abbinerà in base a quel campo
+
+## Passaggio 4: Verifica gli aggiornamenti
+
+Dopo l'importazione:
+
+1. Apri alcuni record aggiornati
+2. Verifica che le modifiche siano state applicate
+3. Controlla che non siano stati creati record duplicati
+
+## Che cosa succede ai campi non presenti nel tuo file?
+
+**I campi non inclusi nel file di importazione rimangono invariati.**
+
+| Il tuo file include...       | Risultato                                                           |
+| ---------------------------- | ------------------------------------------------------------------- |
+| `email`, `jobTitle`          | Viene aggiornato solo `jobTitle`; gli altri campi restano invariati |
+| `email`, `jobTitle`, `phone` | Vengono aggiornati `jobTitle` e `phone`                             |
+
+Ciò significa che devi includere solo i campi che vuoi modificare (più l'identificatore univoco).
+
+## Combinare aggiornamenti e nuovi record
+
+Puoi aggiornare i record esistenti E creare nuovi record nella stessa importazione:
+
+```csv
+email,firstName,lastName,jobTitle
+john@acme.com,John,Smith,Senior Manager    ← Updates existing (email matches)
+newperson@acme.com,New,Person,Analyst      ← Creates new (email doesn't match)
+```
+
+## Errori comuni da evitare
+
+| Errore                                    | Problema                                                  | Risultato                                 | Soluzione                                      |
+| ----------------------------------------- | --------------------------------------------------------- | ----------------------------------------- | ---------------------------------------------- |
+| **Modifica dell'identificatore univoco**  | Modificato `john@acme.com` in `john.smith@acme.com`       | Crea un nuovo record invece di aggiornare | Mantieni invariati gli identificatori univoci  |
+| **Più campi univoci**                     | Mappare sia `email` che `id`                              | Possibili conflitti di corrispondenza     | Mappa un solo identificatore univoco           |
+| **Nessun identificatore univoco**         | Il file contiene solo `firstName`, `lastName`, `jobTitle` | Tutte le righe creano nuovi record        | Includi sempre `email`, `domain` o `id`        |
+| **Discrepanza tra maiuscole e minuscole** | Il file ha `John@acme.com` ma Twenty ha `john@acme.com`   | Crea un nuovo record                      | Esporta da Twenty per ottenere i valori esatti |
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Cosa succede se alcuni record non esistono ancora?">
+    I record con identificatori univoci che non corrispondono a record esistenti verranno creati come nuovi record. Questo ti consente di aggiornare e creare nella stessa importazione.
+  </Accordion>
+
+  <Accordion title="Posso svuotare il valore di un campo?">
+    Sì, lascia la cella vuota nel tuo CSV. L'importazione cancellerà il valore di quel campo nel record esistente.
+  </Accordion>
+
+  <Accordion title="Cosa succede ai campi che non includo nell'importazione?">
+    I campi non presenti nel file di importazione rimangono invariati nei record esistenti. Vengono aggiornati solo i campi che includi.
+  </Accordion>
+
+  <Accordion title="Posso aggiornare i campi di relazione (come Azienda)?">
+    Sì! Includi l'identificatore univoco della relazione (ad es., `companyDomain`) e mappalo sul campo di relazione. La relazione verrà aggiornata.
+  </Accordion>
+
+  <Accordion title="Come faccio a sapere quali record saranno aggiornati e quali creati?">
+    Durante la fase di revisione dell'importazione, Twenty ti mostra quanti record verranno aggiornati e quanti creati in base alle corrispondenze dell'identificatore univoco.
+  </Accordion>
+
+  <Accordion title="Posso annullare un aggiornamento in blocco?">
+    Non è disponibile un annullamento automatico. Ti consigliamo di esportare i tuoi dati come backup prima di effettuare aggiornamenti in blocco.
+  </Accordion>
+</AccordionGroup>
+
+## Migliori Pratiche
+
+1. **Esporta per prima cosa** — inizia sempre da un'esportazione per assicurarti del formato corretto
+2. **Fai un backup prima di aggiornare** — esporta i tuoi dati prima di effettuare modifiche in blocco
+3. **Esegui una prova con pochi record** — prova ad aggiornare prima 5-10 record, prima di eseguire un lotto di grandi dimensioni
+4. **Usa identificatori leggibili** — `email` e `domain` sono più facili da verificare rispetto a `id`
+5. **Includi solo le colonne necessarie** — meno colonne significa meno possibilità di errori
+
+## Risoluzione dei problemi
+
+Hai problemi? Controlla:
+
+* [Come correggere gli errori di importazione](/l/it/user-guide/data-migration/how-tos/fix-import-errors)
+* [Vincoli di unicità](/l/it/user-guide/data-migration/capabilities/uniqueness-constraints)
+* [Riferimento alla mappatura dei campi](/l/it/user-guide/data-migration/capabilities/field-mapping)

packages/twenty-docs/l/it/user-guide/data-migration/overview.mdx

@@ -0,0 +1,83 @@
+---
+title: Migrazione dei dati
+description: Importa ed esporta i dati del tuo CRM tramite file CSV o API.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Metodi di importazione
+
+Twenty supporta due metodi principali per importare dati:
+
+| Metodo               | Ideale per                                  | Limite di volume       |
+| -------------------- | ------------------------------------------- | ---------------------- |
+| **Importazione CSV** | Migrazioni standard, aggiornamenti regolari | 10.000 record per file |
+| **Importazione API** | Migrazioni su larga scala, automazione      | Illimitato             |
+
+<Note>Per set di dati molto grandi (centinaia di migliaia di record), usa le API. I nostri [partner di implementazione](/l/it/user-guide/getting-started/capabilities/implementation-services) possono aiutarti a eseguire questi script se necessario.</Note>
+
+## Nozioni di base sull'importazione CSV
+
+Puoi importare dati per qualsiasi oggetto utilizzando file CSV, XLSX o XLS. Ogni file dovrebbe contenere **solo un tipo di oggetto** (ad esempio, solo record di Persone).
+
+<Note>**I campi devono esistere prima dell'importazione.** Il caricamento di un file CSV crea record ma non crea campi. Se ti servono campi personalizzati, creali prima in **Impostazioni → Modello dati**.</Note>
+
+### Passaggi
+
+1. Vai all'oggetto in cui vuoi importare i dati
+2. Fai clic sull'icona **⋮** in alto a destra (questo è il Menu comandi) e fai clic su **Importa record**
+3. Scarica il file modello per assicurarti che i dati siano nel formato previsto
+4. Carica il tuo file CSV formattato
+5. Abbina le tue colonne ai campi di Twenty
+6. Esamina gli errori (evidenziati in giallo) e correggili, modificando direttamente nell'interfaccia utente (UI)
+7. Conferma l'importazione
+
+### Importare le relazioni tra oggetti
+
+Puoi importare le relazioni tra oggetti utilizzando la funzione di importazione CSV. Devi fare riferimento all'oggetto correlato utilizzando un campo univoco di tale oggetto: l'`id`, l'`email` per Persone e Membri dello spazio di lavoro, il `domain` per le aziende, qualsiasi altro campo impostato come univoco nel modello dati per qualsiasi altro oggetto.
+
+<Note>**I record eliminati influiscono sull'unicità.** I record eliminati in modo non definitivo (visibili nel Menu comandi → Vedi record eliminati) sono inclusi nei controlli di unicità. Se importi un record con lo stesso valore univoco di un record eliminato, il record eliminato verrà ripristinato.</Note>
+
+<Warning>
+**L'ordine di importazione è importante!**
+
+Quando importi oggetti correlati, carica i file in questo ordine:
+1. **Aziende** per prime (il lato "uno" delle relazioni)
+2. **Persone** al secondo posto (collegate alle Aziende tramite companyId)
+3. **Opportunità** al terzo posto (collegate ad Aziende/Persone)
+4. **Oggetti personalizzati** con relazioni per ultimi
+
+Perché? Il lato "uno" di una relazione uno-a-molti deve esistere prima di potervi fare riferimento. Ad esempio, il record Azienda deve esistere prima di importare una Persona con l'ID di quella azienda.
+</Warning>
+
+Consulta [questo articolo](/l/it/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) per una guida passo passo su come procedere.
+
+## Esporta Dati
+
+Esporta i dati del tuo spazio di lavoro per backup, reportistica o migrazione.
+
+### Passaggi
+
+1. Vai all'oggetto che vuoi esportare
+2. Configura la vista con le colonne di cui hai bisogno
+3. Fai clic su **⋮** → **Esporta vista**
+4. Salva il file CSV
+
+<Note>**Vengono esportate solo le colonne visibili.** Il file CSV conterrà solo le colonne visualizzate nella vista corrente. Aggiungi o nascondi colonne prima dell'esportazione per controllare quali dati includere.</Note>
+
+<Note>**Limiti di esportazione**: fino a 20.000 record per esportazione.</Note>
+
+## Permessi
+
+L'importazione e l'esportazione dei dati richiedono autorizzazioni specifiche:
+
+* **Importazione**: Richiede l'autorizzazione "Import CSV"
+* **Esportazione**: Richiede l'autorizzazione "Export CSV"
+
+Contatta l'amministratore dello spazio di lavoro se non disponi di queste autorizzazioni.
+
+## Prossimi Passi
+
+* [Prepara i file CSV](/l/it/user-guide/data-migration/how-tos/prepare-your-csv-files)
+* [Importa le relazioni tra oggetti](/l/it/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+* [Importa tramite API per set di dati di grandi dimensioni](/l/it/user-guide/data-migration/how-tos/import-data-via-api)

packages/twenty-docs/l/it/user-guide/data-model/capabilities/fields.mdx

@@ -0,0 +1,122 @@
+---
+title: Campi
+description: Comprendere il ruolo dei campi e come gestirli.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Informazioni sui Campi
+
+I campi sono come colonne in un foglio di calcolo. Memorizzano diversi tipi di dati come testo, numeri o date. I campi possono essere standard (di sistema) o personalizzati (quelli che crei tu).
+
+### Campi Standard
+
+I campi standard sono integrati in Twenty per gestire esigenze aziendali comuni.
+
+Ad esempio, `Nome` e `Cognome` sono campi standard nell'oggetto `People`. Memorizzano dati di testo per nomi individuali.
+
+Non puoi eliminare i campi standard, ma puoi disattivarli se non ne hai bisogno.
+
+Puoi anche personalizzare le opzioni dei campi standard di tipo `SELECT`, ad esempio le opzioni della `Fase` nelle Opportunità.
+
+<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />
+
+### Campi Personalizzati
+
+I campi personalizzati possono essere aggiunti a qualsiasi oggetto. Puoi memorizzare testo, numeri, date, selezioni a discesa e altro. Usa campi personalizzati per tracciare informazioni specifiche per la tua attività.
+
+Ad esempio, un campo personalizzato per SpaceX potrebbe essere `Stato operativo razzo`, che indica se un razzo è operativo.
+
+<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />
+
+## Tipi di campo
+
+Twenty supporta vari tipi di campo:
+
+| Tipo            | Descrizione                                                        | Esempio                        |
+| --------------- | ------------------------------------------------------------------ | ------------------------------ |
+| Indirizzo       | Indirizzo strutturato con via, città, stato, paese, codice postale | Indirizzo dell'ufficio         |
+| Array           | Elenco di valori di testo                                          | Etichette                      |
+| Booleano        | Casella di controllo vero/falso                                    | Attivo                         |
+| Valuta          | Valore monetario con codice valuta                                 | Importo della trattativa (USD) |
+| Data            | Valori di data                                                     | Data di chiusura               |
+| Data e ora      | Data con orario                                                    | Ora della riunione             |
+| Dominio         | Dominio del sito web (utilizzato per le Aziende)                   | acme.com                       |
+| Email           | Indirizzi email (con principale + aggiuntivi)                      | Email del contatto             |
+| JSON            | Dati JSON strutturati                                              | Metadati personalizzati        |
+| Collegamenti    | URL con etichette (principale + secondaria)                        | Sito web, LinkedIn             |
+| Testo lungo     | Testo multilinea                                                   | Descrizione, Note              |
+| Multi-selezione | Scelte multiple da un elenco predefinito                           | Etichette, Categorie           |
+| Numero          | Valori numerici (interi o decimali)                                | Quantità, Punteggio            |
+| Telefono        | Numeri di telefono con prefisso internazionale                     | Telefono di lavoro             |
+| Valutazione     | Valutazione a stelle (1-5)                                         | Priorità, Punteggio            |
+| Relazione       | Collegamenti a record in altri oggetti                             | Azienda → Persone              |
+| Seleziona       | Scelta singola da un elenco predefinito                            | Fase, Stato                    |
+| Testo           | Testo su una riga                                                  | Nome, Titolo                   |
+
+## Crea un campo personalizzato
+
+Per aggiungere un campo personalizzato a qualsiasi oggetto, segui questi passaggi:
+
+1. Vai su `Impostazioni` nella barra laterale sinistra.
+2. Vai su `Modello di dati`, quindi seleziona l'oggetto che desideri personalizzare.
+3. Procedi cliccando su `+ Nuovo Campo`.
+4. Scegli un nome e un tipo di campo che si adattano alle tue esigenze. Considera l'aggiunta di una descrizione del campo per una migliore comprensione.
+
+Il tuo nuovo campo è ora disponibile nei campi dell'applicazione. Per visualizzarlo in una vista specifica, fai clic sul menu delle opzioni, quindi seleziona `Campi`.
+
+<VimeoEmbed videoId="927628219" title="Dimostrazione video" />
+
+**Modo rapido:** Fai clic sul pulsante **+** in alto a destra di ogni tabella oggetto, quindi seleziona `Personalizza campi`. Ciò ti porterà direttamente alle impostazioni del Modello di Dati.
+
+<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />
+
+## Disattiva un campo
+
+Puoi disattivare un campo per nasconderlo dall'app senza perdere i tuoi dati. Pensalo come un nascondimento del campo invece di un'eliminazione.
+
+Ecco come puoi farlo:
+
+1. Trova il campo che desideri disattivare nelle impostazioni del tuo oggetto.
+2. Clicca sui tre punti `⋮` accanto al campo per aprire il menu.
+3. Seleziona `Disattiva` dall'elenco a discesa.
+
+<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />
+
+Cosa succede quando disattivi un campo?
+
+1. **Nell'app:** Il campo scompare e non puoi aggiungervi nuovi valori.
+2. **Relazioni esistenti:** Se è un campo di relazione, le connessioni esistenti rimangono, ma non puoi crearne di nuove.
+3. **Accesso API:** Puoi ancora accedere al campo e ai suoi dati tramite l'API.
+
+Puoi riattivare i campi Standard e Personalizzati o avere l'opzione di eliminarli permanentemente.
+
+## Rendi Unici i Campi
+
+Rendi un campo unico per garantire che i record distinti non possano avere lo stesso valore. Ad esempio, gli indirizzi email sono unici per ogni persona.
+
+Se ottieni un errore impostando l'unicità, controlla i valori duplicati nei tuoi dati (inclusi i record eliminati).
+
+## Indici (Avanzato)
+
+Gli indici del database sono gestiti automaticamente — aggiungerne di propri è raramente necessario ed è facile commettere errori. Con la modalità Avanzata attiva, ogni oggetto ha una sezione **Indici** in `Impostazioni → Modello dati → <object>` per i casi in cui sai di averne bisogno.
+
+## Procedure Migliori per la Configurazione dei Campi
+
+### Convenzioni e Limitazioni sui Nomi
+
+* **I nomi singolari e plurali devono essere distinti**: La nostra API GraphQL necessita di nomi distinti per le mutazioni
+* **Nomi di campo protetti**: alcuni nomi sono riservati all'uso di sistema (ad es., `Type`, `Application`)
+
+### Campi Valuta e Telefono
+
+* **Valuta predefinita**: può essere configurata tramite il modello di dati
+* **Codici paesi predefiniti**: possono essere configurati per i campi telefono tramite il modello di dati
+
+### Campi Selezione
+
+* **Può essere selezionata un'opzione predefinita** per ogni campo Selezione
+
+### Campi di Testo dei Record
+
+* **Ogni oggetto ha un campo di visualizzazione principale**: Questo campo appare nella colonna più a sinistra e rappresenta il record quando collegato a altri oggetti. Deve essere un campo di testo. Ad esempio, Persone usa `Nome` come campo principale, quindi quando colleghi una persona a un'azienda, vedrai il loro nome nella vista dell'azienda.

packages/twenty-docs/l/it/user-guide/data-model/capabilities/objects.mdx

@@ -0,0 +1,92 @@
+---
+title: Oggetti
+description: Scopri gli oggetti standard e personalizzati in Twenty.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Oggetti standard
+
+Gli oggetti standard sono entità predefinite nel tuo spazio di lavoro per aiutarti a iniziare. Fanno parte di un modello di dati condiviso accessibile a tutti gli utenti di Twenty. Puoi usarli così come sono, personalizzarli o disattivarli.
+
+<img src="/images/user-guide/objects/standard-objects.png" style={{width:'100%'}} />
+
+### Persone
+
+L'oggetto `Persone` memorizza i tuoi contatti. Include dettagli di contatto e cronologia delle interazioni, così puoi vedere tutte le tue interazioni con i clienti in un unico posto.
+
+### Aziende
+
+L'oggetto `Aziende` memorizza i tuoi account aziendali. Include dettagli come settore, dimensioni e posizione. Le aziende si collegano sia agli oggetti `Persone` che `Opportunità`.
+
+### Opportunità
+
+L'oggetto `Opportunità` memorizza i dati relativi alle trattative. Traccia la progressione delle potenziali vendite, dalla prospezione alla chiusura, registrando fasi, dimensioni dell'accordo, account associato e data di chiusura prevista. Puoi visualizzare il tuo pipeline di vendita in un layout kanban.
+
+### Note
+
+L'oggetto `Notes` memorizza note in formato libero che possono essere allegate a Persone, Aziende, Opportunità e ad altri record. Usa le note per raccogliere riepiloghi delle riunioni, dettagli importanti o qualsiasi informazione contestuale.
+
+### Attività
+
+L'oggetto `Tasks` memorizza attività da fare e azioni. Le attività possono essere collegate a Persone, Aziende, Opportunità e ad altri record. Tieni traccia delle scadenze, degli assegnatari e dello stato di completamento per restare al passo con i follow-up.
+
+## Oggetti personalizzati
+
+Gli oggetti personalizzati ti permettono di memorizzare informazioni uniche della tua organizzazione che gli oggetti standard non possono gestire. Ad esempio, se sei SpaceX, potresti voler creare un oggetto personalizzato per Razzi e Lanci.
+
+<img src="/images/user-guide/objects/custom-objects.png" style={{width:'100%'}} />
+
+### Creare un nuovo oggetto personalizzato
+
+Per creare un nuovo oggetto personalizzato:
+
+1. Vai a Impostazioni nella barra laterale a sinistra.
+2. Sotto Workspace, vai al Data Model. Qui potrai vedere una panoramica di tutti gli oggetti standard e personalizzati esistenti (sia attivi che disattivati).
+
+<VimeoEmbed videoId="926288174" title="Dimostrazione video" />
+
+3. Clicca su `+ Nuovo oggetto` in alto. Inserisci il nome (sia singolare che plurale), scegli un'icona, aggiungi una descrizione per il tuo oggetto personalizzato e clicca Salva (in alto a destra). Utilizzando Annuncio come esempio di oggetto personalizzato, il singolare sarebbe "annuncio" e il plurale sarebbe "annunci" insieme a una descrizione come "Annunci che gli host hanno creato per mostrare la loro proprietà."
+4. Il tuo oggetto personalizzato è stato creato e apparirà nella barra laterale. Puoi iniziare subito ad aggiungere record.
+
+## Gestione degli oggetti
+
+### Disattivazione degli oggetti
+
+Se non hai bisogno di un oggetto standard o personalizzato:
+
+1. Vai a Impostazioni → Modello dati
+2. Trova l'oggetto che vuoi disattivare e fai clic su di esso
+3. Vai alla scheda **Impostazioni** dell'oggetto
+4. Clicca sul pulsante `Deactivate`
+5. L'oggetto sarà nascosto dal tuo spazio di lavoro, ma i dati verranno conservati
+
+### Riattivazione degli oggetti
+
+Per riattivare un oggetto disattivato:
+
+1. Vai a Impostazioni → Modello dati
+2. Abilita il filtro `Disattivato`
+3. Cerca oggetti disattivati (hanno `Deactivated` accanto al loro nome)
+4. Fai clic su `⋮` e quindi su `Attiva` per riattivarlo
+5. L'oggetto e tutti i suoi dati verranno ripristinati
+
+## Migliori Pratiche
+
+### Quando creare oggetti personalizzati
+
+* **Entità aziendali uniche**: elementi specifici del tuo settore o processo
+* **Relazioni complesse**: quando devi tenere traccia dei collegamenti tra più entità
+* **Dati scalabili**: quando potresti avere molte istanze di qualcosa
+
+### Quando usare invece i campi
+
+* **Attributi semplici**: proprietà che descrivono oggetti esistenti
+* **Categorie o etichette**: modi per classificare i record esistenti
+* **Valori singoli**: informazioni che non necessitano di un proprio ciclo di vita
+
+### Denominazione degli oggetti
+
+* **Usa nomi chiari e descrittivi**: rendi evidente che cosa rappresenta l'oggetto
+* **Segui le convenzioni**: usa il singolare per il nome dell'oggetto, il plurale per la raccolta
+* **Considera il tuo team**: scegli nomi che tutti possano comprendere

packages/twenty-docs/l/it/user-guide/data-model/capabilities/relation-fields.mdx

@@ -0,0 +1,94 @@
+---
+title: Campi di Relazione
+description: Collega i record tra oggetti diversi utilizzando campi di relazione.
+---
+
+## Tipi di relazioni
+
+### Uno-a-molti
+
+Un record nell'Oggetto A può essere collegato a molti record nell'Oggetto B.
+
+**Esempio:** Un'Azienda può avere molte Persone (dipendenti).
+
+### Molti-a-uno
+
+Molti record nell'Oggetto A possono essere collegati a un record nell'Oggetto B.
+
+**Esempio:** Molte Persone possono appartenere a un'Azienda.
+
+### Relazioni che puntano a più tipi di oggetto
+
+Alcuni oggetti possono collegarsi a più tipi di oggetto su un lato della relazione.
+
+**Esempio:** Una Nota può essere collegata a una Persona E a un'Azienda E a un'Opportunità contemporaneamente. La Nota si trova sul lato "molti", collegandosi a più lati "uno".
+
+<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
+
+Analogamente, un Progetto (sul lato "uno") potrebbe ricevere collegamenti da più Persone, più Aziende e più Note.
+
+<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
+
+<Warning>
+**Limitazione di importazione/esportazione**: Le relazioni che puntano a più tipi di oggetto non sono ancora supportate per l'importazione/esportazione CSV. È nella nostra roadmap.
+</Warning>
+
+### Molti-a-molti
+
+Molti record nell'Oggetto A possono essere collegati a molti record nell'Oggetto B.
+
+**Esempio:** Molte Persone possono essere collegate a molti Progetti, e viceversa.
+
+Le relazioni molti-a-molti utilizzano lo schema dell'**oggetto di giunzione**: un oggetto intermedio che collega entrambe le parti. Con la funzionalità delle relazioni di giunzione, Twenty visualizza direttamente i record collegati finali, nascondendo l'oggetto intermedio dall'interfaccia utente.
+
+<Warning>
+**Funzionalità beta**: le relazioni di giunzione devono essere abilitate in **Impostazioni → Community → Funzionalità** prima dell'uso.
+</Warning>
+
+Vedi [Come creare molte relazioni](/l/it/user-guide/data-model/how-tos/create-many-to-many-relations) per una guida completa passo-passo.
+
+## Creazione di un campo di relazione
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona l'oggetto in cui vuoi aggiungere la relazione
+3. Clicca su **+ Nuovo campo**
+4. Seleziona **Relazione** come tipo di campo
+5. Scegli l'oggetto o gli oggetti di destinazione a cui collegare
+6. Configura le impostazioni della relazione:
+   * **Nome del campo sull'oggetto di origine**: il nome del campo di relazione sull'oggetto che stai modificando
+   * **Nome del campo sull'oggetto di destinazione**: il nome del campo di relazione che apparirà sull'oggetto di destinazione
+   * Tipo di relazione (uno-a-molti, molti-a-uno)
+7. Clicca su **Salva**
+
+## Relazioni standard
+
+Twenty offre relazioni predefinite tra oggetti standard:
+
+| Oggetto di origine | Oggetto di destinazione | Tipo di relazione |
+| ------------------ | ----------------------- | ----------------- |
+| Persone            | Aziende                 | Molti-a-uno       |
+| Opportunità        | Aziende                 | Molti-a-uno       |
+| Opportunità        | Persone                 | Molti-a-uno       |
+
+## Migliori Pratiche
+
+### Pianificazione delle relazioni
+
+* **Mappa il tuo modello di dati**: pianifica le relazioni prima di crearle
+* **Considera la direzione**: pensa a quale oggetto "possiede" la relazione
+* **Evita le dipendenze circolari**: mantieni pulito il tuo modello di dati
+
+### Denominare le relazioni
+
+* **Usa nomi chiari**: rendi evidente ciò che la relazione rappresenta
+* **Sii coerente**: usa schemi di denominazione simili tra le relazioni
+* **Considera entrambi i lati**: assegna un nome appropriato a entrambi i lati della relazione
+
+### Prestazioni
+
+* **Non esagerare con le relazioni**: troppe relazioni possono rallentare il tuo spazio di lavoro
+
+## Limitazioni
+
+* **L'eliminazione delle relazioni** rimuove il collegamento ma non i record correlati
+* **Le relazioni circolari** dovrebbero essere evitate per l'integrità dei dati

packages/twenty-docs/l/it/user-guide/data-model/how-tos/create-custom-fields.mdx

@@ -0,0 +1,72 @@
+---
+title: Crea campi personalizzati
+description: Guida passo per passo per aggiungere campi personalizzati a qualsiasi oggetto.
+---
+
+I campi personalizzati ti consentono di acquisire informazioni specifiche per la tua attività. Aggiungili a qualsiasi oggetto — standard o personalizzato.
+
+## Passaggi
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona l'oggetto a cui vuoi aggiungere un campo
+3. Clicca Su **+ Nuovo Campo**
+4. Scegli un **tipo di campo** (vedi [Campi](/l/it/user-guide/data-model/capabilities/fields) per tutti i tipi)
+5. Inserisci il **nome del campo** e una descrizione facoltativa
+6. Configura le impostazioni specifiche del campo (vedi sotto)
+7. Clicca su **Salva**
+
+**Metodo rapido:** Fai clic su **+** alla fine delle intestazioni di colonna in qualsiasi vista tabella → **Personalizza campi**.
+
+## Mostra il campo nelle viste
+
+I nuovi campi non sono visibili automaticamente. Per visualizzarli:
+
+1. Apri la vista tabella dell'oggetto
+2. Fai clic su **Opzioni → Campi**
+3. Fai clic sull'**icona a forma di occhio** accanto al tuo campo per mostrarlo
+4. Trascina per riordinare
+
+## Opzioni di configurazione
+
+### Per Selezione / Selezione multipla
+
+1. Fai clic su **+ Aggiungi opzione** per creare opzioni
+2. Imposta un'**opzione predefinita** se lo desideri
+3. Trascina per riordinare le opzioni
+
+<Note>
+**Usa i nomi API per le importazioni.** Abilita la **Modalità avanzata** in Impostazioni per visualizzare i nomi API. Vedi [Mappatura dei campi](/l/it/user-guide/data-migration/capabilities/field-mapping).
+</Note>
+
+### Per i campi Valuta
+
+Imposta la **valuta predefinita** (USD, EUR, ecc.) per i nuovi record.
+
+### Per i campi Telefono
+
+Imposta il **prefisso internazionale predefinito** da precompilare per i nuovi numeri di telefono.
+
+### Impostare un campo come univoco
+
+Attiva **Univoco** per impedire valori duplicati tra i record.
+
+<Note>
+Se esistono duplicati (anche nei record eliminati), verrà visualizzato un errore. Elimina prima i duplicati.
+</Note>
+
+### Impostazione dei valori predefiniti
+
+Per i campi Selezione, puoi scegliere quale opzione è preselezionata per i nuovi record. Per i campi Casella di controllo, imposta se è selezionata o deselezionata per impostazione predefinita.
+
+## Disattivare un campo
+
+1. Vai a **Impostazioni → Modello dati**
+2. Trova il campo
+3. Fai clic su **⋮ → Disattiva**
+
+I dati vengono conservati. Puoi riattivarlo o eliminarlo definitivamente in un secondo momento.
+
+## Correlati
+
+* [Campi](/l/it/user-guide/data-model/capabilities/fields) — tutti i tipi di campo spiegati
+* [Domande frequenti sul Modello dati](/l/it/user-guide/data-model/how-tos/data-model-faq) — domande comuni

packages/twenty-docs/l/it/user-guide/data-model/how-tos/create-custom-objects.mdx

@@ -0,0 +1,51 @@
+---
+title: Crea oggetti personalizzati
+description: Guida passo per passo per creare oggetti personalizzati in Twenty.
+---
+
+Gli oggetti personalizzati ti permettono di memorizzare informazioni uniche per la tua azienda che gli oggetti standard non coprono. Ad esempio: Progetti, Prodotti, Ticket o Inserzioni.
+
+<Note>
+**Non sai se ti serve un oggetto o un campo?** Consulta [Comprendere il tuo modello dati](/l/it/user-guide/data-model/overview) per indicazioni.
+</Note>
+
+## Passaggi
+
+1. Vai a **Impostazioni → Modello dati**
+2. Clicca su **+ Aggiungi oggetto**
+3. Compila:
+   * **Nome singolare** (ad es., "Inserzione")
+   * **Nome plurale** (ad es., "Inserzioni")
+   * **Icona**
+   * **Descrizione** (opzionale)
+4. Clicca su **Salva**
+
+Il tuo oggetto appare immediatamente nella barra laterale.
+
+## Successivo: Aggiungi campi
+
+I nuovi oggetti iniziano con campi di base. Aggiungi campi personalizzati per acquisire i dati di cui hai bisogno:
+
+1. In **Impostazioni → Modello dati**, seleziona il tuo oggetto
+2. Clicca Su **+ Nuovo Campo**
+3. Scegli un tipo di campo, configura e salva
+
+Consulta [Come creare campi personalizzati](/l/it/user-guide/data-model/how-tos/create-custom-fields) per i dettagli sui tipi di campo e sulla configurazione.
+
+## Collegamento ad altri oggetti
+
+Per collegare il tuo oggetto a Persone, Aziende o altri oggetti, crea un campo di relazione. Consulta [Come creare campi di relazione](/l/it/user-guide/data-model/how-tos/create-relation-fields).
+
+## Disattivazione di un oggetto
+
+Se non hai più bisogno di un oggetto:
+
+1. Vai a **Impostazioni → Modello dati → oggetto di tua scelta → Impostazioni**
+2. Clicca sul pulsante **Disattiva**
+
+L'oggetto è nascosto ma i dati vengono conservati. Puoi riattivarlo o eliminarlo definitivamente in un secondo momento.
+
+## Correlati
+
+* [Oggetti](/l/it/user-guide/data-model/capabilities/objects) — oggetti standard vs oggetti personalizzati
+* [Domande frequenti sul Modello dati](/l/it/user-guide/data-model/how-tos/data-model-faq) — domande comuni

packages/twenty-docs/l/it/user-guide/data-model/how-tos/create-many-to-many-relations.mdx

@@ -0,0 +1,175 @@
+---
+title: Crea relazioni molti-a-molti
+description: Collega record in cui molti elementi su entrambi i lati possono essere collegati tra loro utilizzando oggetti di giunzione.
+---
+
+Le relazioni molti-a-molti ti consentono di collegare più record su entrambi i lati. Ad esempio: molte Persone possono lavorare su molti Progetti, e ogni Progetto può avere molte Persone.
+
+<Warning>
+**Funzionalità beta**: Le relazioni di giunzione sono attualmente in beta. Abilita le in **Impostazioni → Community → Funzionalità** prima di seguire questa guida.
+</Warning>
+
+<Note>
+Questa funzionalità richiede anche che la **Modalità avanzata** sia abilitata (tramite l'interruttore in basso a sinistra nelle Impostazioni).
+</Note>
+
+## Quando usare le relazioni molti-a-molti
+
+Usa le relazioni molti-a-molti quando entrambi i lati di una relazione possono avere più collegamenti:
+
+| Relazione          | Esempio                                                                        |
+| ------------------ | ------------------------------------------------------------------------------ |
+| Persone ↔ Progetti | Una persona lavora su più progetti; un progetto ha più membri del team         |
+| Aziende ↔ Tag      | Un'azienda può avere più tag; un tag può essere applicato a più aziende        |
+| Prodotti ↔ Ordini  | Un prodotto può essere presente in più ordini; un ordine contiene più prodotti |
+
+## Come Funziona
+
+Twenty utilizza un modello di **oggetto di giunzione** per le relazioni molti-a-molti. Un oggetto di giunzione si trova tra due oggetti e contiene i collegamenti:
+
+```
+People ←→ Project Assignments ←→ Projects
+```
+
+L'oggetto **Assegnazioni ai progetti** (di giunzione) ha:
+
+* Una relazione con Persone (molti-a-uno)
+* Una relazione con Progetti (molti-a-uno)
+
+Quando abiliti l'interruttore della relazione di giunzione, Twenty mostra direttamente i record collegati invece di visualizzare i record intermedi di giunzione.
+
+## Prerequisiti
+
+1. **Abilita le relazioni di giunzione nelle funzionalità beta**: Vai a **Impostazioni → Community → Funzionalità** e abilita **Relazioni di giunzione**
+2. **Abilita la Modalità avanzata**: Attiva la **Modalità avanzata** in basso a sinistra nella barra laterale delle Impostazioni
+3. Pianifica il tuo modello di dati:
+   * Quali due oggetti stai collegando?
+   * Come dovrebbe chiamarsi l'oggetto di giunzione?
+
+## Passaggio 1: Crea l'oggetto di giunzione
+
+Per prima cosa, crea l'oggetto intermedio che conterrà i collegamenti.
+
+1. Vai a **Impostazioni → Modello dati**
+2. Clicca su **+ Aggiungi oggetto**
+3. Assegnagli un nome descrittivo (ad es., "Assegnazione al progetto", "Membro del team", "Ordine del prodotto")
+4. Attiva l'opzione "Salta la creazione di un campo Nome"
+
+<img src="/images/user-guide/fields/new-pivot-object.png" alt="Nuovo oggetto pivot" />
+
+5. Clicca su **Salva**
+
+<Tip>
+**Convenzione di denominazione**: Usa un nome che descriva la relazione, come "Assegnazione al progetto" o "Appartenenza al team". Questo rende il modello di dati più facile da comprendere.
+</Tip>
+
+## Passaggio 2: Crea relazioni tra gli oggetti e l'oggetto di giunzione
+
+Aggiungi campi di relazione da ciascuno dei due oggetti all'oggetto di giunzione.
+
+### Prima relazione (Oggetto A → Oggetto di giunzione)
+
+1. Seleziona il tuo primo oggetto in **Impostazioni → Modello dati**
+2. Fai clic su **+ Aggiungi relazione**
+3. Seleziona l'oggetto di giunzione (ad es., "Assegnazioni al progetto")
+4. Imposta il tipo di relazione su **Uno-a-molti** (una persona può collegarsi a molte assegnazioni)
+5. Assegna un nome ai campi:
+   * Campo su Persone: ad es., "Assegnazioni ai progetti"
+   * Campo sull'oggetto di giunzione: ad es., "Persona"
+6. Clicca su **Salva**
+
+### Seconda relazione (Oggetto B → Oggetto di giunzione)
+
+1. Seleziona il tuo secondo oggetto in **Impostazioni → Modello dati**
+2. Fai clic su **+ Aggiungi relazione**
+3. Seleziona l'oggetto di giunzione (ad es., "Assegnazioni al progetto")
+4. Imposta il tipo di relazione su **Uno-a-molti** (un progetto può collegarsi a molte assegnazioni)
+5. Abilita **"Questa è una relazione con un oggetto di giunzione"**
+
+<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}} />
+
+6. Assegna un nome ai campi:
+   * Campo sull'oggetto di giunzione: ad es., "Progetto"
+   * Campo su Progetti: ad es., "Membri del team"
+7. Clicca su **Salva**
+
+## Passaggio 3: Configura la visualizzazione della relazione di giunzione
+
+Ora configura gli oggetti sorgente per visualizzare direttamente i record collegati, saltando l'oggetto di giunzione intermedio.
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona il primo oggetto (ad es., "Persone")
+3. Trova il campo di relazione che punta all'oggetto di giunzione (ad es., "Assegnazioni ai progetti")
+4. Fai clic per modificare il campo
+5. Abilita **"Questa è una relazione con un oggetto di giunzione"**
+6. Seleziona la **Relazione di destinazione** (ad es., "Progetto" — il campo sull'oggetto di giunzione che punta all'altro lato)
+7. Clicca su **Salva**
+
+## Risultato
+
+Dopo la configurazione:
+
+* In un record **Persona**, il campo "Assegnazioni ai progetti" mostra direttamente i **Progetti** (non i record di assegnazione)
+* In un record **Progetto**, il campo "Membri del team" mostra direttamente le **Persone**
+
+L'oggetto di giunzione esiste ancora e memorizza i collegamenti, ma l'interfaccia utente presenta una vista molti-a-molti più pulita.
+
+## Esempio: Persone ↔ Progetti
+
+Ecco una procedura completa:
+
+### Crea l'oggetto di giunzione
+
+* Nome: **Assegnazione al progetto**
+* Descrizione: "Collega le persone ai progetti su cui lavorano"
+
+### Aggiungi relazioni
+
+1. **Persone → Assegnazione al progetto**
+   * Tipo: Uno-a-molti
+   * Campo su Persone: "Assegnazioni ai progetti"
+   * Campo su Assegnazione: "Persona"
+
+2. **Progetti → Assegnazione al progetto**
+   * Tipo: Uno-a-molti
+   * Campo su Progetti: "Membri del team"
+   * Campo su Assegnazione: "Progetto"
+
+### Configura la visualizzazione della giunzione
+
+1. Sull'oggetto **Persone**:
+   * Modifica il campo "Assegnazioni ai progetti"
+   * Abilita l'interruttore di giunzione
+   * Destinazione: "Progetto"
+
+2. Sull'oggetto **Progetti**:
+   * Modifica il campo "Membri del team"
+   * Abilita l'interruttore di giunzione
+   * Destinazione: "Persona"
+
+### Usalo
+
+* Apri un record Persona → vedi direttamente i relativi Progetti
+* Apri un record Progetto → vedi direttamente i membri del team
+* Crea nuove connessioni da entrambi i lati
+
+## Aggiungere dati alle connessioni
+
+Poiché l'oggetto di giunzione è un vero oggetto, puoi aggiungere campi personalizzati per memorizzare informazioni sulla relazione:
+
+* **Ruolo**: "Sviluppatore", "Designer", "Responsabile"
+* **Data di inizio**: Quando la persona è entrata nel progetto
+* **Ore assegnate**: ore settimanali su questo progetto
+
+Per accedere a questi dati, vai direttamente all'oggetto di giunzione oppure interrogalo tramite l'API.
+
+## Limitazioni
+
+* **Importazione/Esportazione CSV**: L'importazione diretta di relazioni molti-a-molti non è supportata. Importa invece i record nell'oggetto di giunzione.
+* **Filtri**: Il filtraggio in base a relazioni molti-a-molti potrebbe avere opzioni limitate.
+
+## Correlati
+
+* [Campi di relazione](/l/it/user-guide/data-model/capabilities/relation-fields) — tipi di relazione spiegati
+* [Crea oggetti personalizzati](/l/it/user-guide/data-model/how-tos/create-custom-objects) — come creare oggetti
+* [Crea campi di relazione](/l/it/user-guide/data-model/how-tos/create-relation-fields) — configurazione di base della relazione

packages/twenty-docs/l/it/user-guide/data-model/how-tos/create-relation-fields.mdx

@@ -0,0 +1,70 @@
+---
+title: Creazione di Campi di Relazione
+description: Guida passo passo per collegare gli oggetti con campi di relazione.
+---
+
+I campi di relazione collegano record di oggetti diversi — ad esempio, collegando Persone ad Aziende.
+
+<Note>
+**I nomi delle relazioni non possono essere modificati dopo la creazione** (influiscono sull'API). Pianifica con attenzione i nomi.
+</Note>
+
+## Prima di Iniziare
+
+Decidi:
+
+* Quali oggetti stai collegando? (ad es., Persone → Aziende)
+* Qual è il lato "uno"? (ad es., Azienda)
+* Qual è il lato "molti"? (ad es., Persone — molte persone lavorano per una sola azienda)
+* Quale nome dovrebbe avere il campo su ciascun lato?
+
+Consulta [Campi di Relazione](/l/it/user-guide/data-model/capabilities/relation-fields) per la spiegazione dei tipi di relazione.
+
+## Passaggi
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona l'oggetto in cui vuoi la relazione (in genere il lato "molti")
+3. Fai clic su **+ Nuovo campo**
+4. Seleziona **Relazione** come tipo di campo
+5. Scegli l'**oggetto di destinazione**
+6. Seleziona **Uno-a-molti** o **Molti-a-uno**
+7. Inserisci i nomi dei campi per **entrambi i lati** della relazione
+8. Clicca su **Salva**
+
+## Esempio: Persone → Aziende
+
+* Vai a **Impostazioni → Modello dati → Persone**
+* Aggiungi un campo di relazione
+* Destinazione: **Aziende**
+* Tipo: **Molti-a-uno**
+* Campo su Persone: **Azienda**
+* Campo su Aziende: **Dipendenti**
+
+Ora ogni Persona può essere collegata a un'Azienda e ogni Azienda mostra le proprie Persone.
+
+## Disattivare una relazione
+
+1. Vai a **Impostazioni → Data Model → oggetto a tua scelta**
+2. Trova il campo di relazione e fai clic su di esso
+3. Fai clic sul pulsante **Disattiva**
+
+I collegamenti vengono conservati ma nascosti. Riattiva per ripristinare.
+
+<Note>
+**La disattivazione di una relazione non elimina i record.** Viene rimosso solo il collegamento tra di essi.
+</Note>
+
+## Eliminare una relazione
+
+1. Vai a **Impostazioni → Data Model → oggetto a tua scelta**
+2. Trova il campo di relazione e fai clic su di esso
+3. Fai clic sul pulsante **Elimina**
+
+<Note>
+Si applica solo alle relazioni personalizzate. Le relazioni standard possono essere disattivate.
+</Note>
+
+## Correlati
+
+* [Campi di Relazione](/l/it/user-guide/data-model/capabilities/relation-fields) — tipi e limitazioni
+* [Come importare le relazioni](/l/it/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) — importazione massiva di record collegati

packages/twenty-docs/l/it/user-guide/data-model/how-tos/customize-your-data-model.mdx

@@ -0,0 +1,22 @@
+---
+title: Personalizza Il Modello Di Dati
+description: Panoramica delle opzioni di personalizzazione del modello di dati.
+---
+
+Il modello di dati di Twenty è completamente personalizzabile. Crea oggetti, campi e relazioni per rispecchiare la tua azienda.
+
+## Collegamenti rapidi
+
+| Voglio...                    | Guida                                                                                      |
+| ---------------------------- | ------------------------------------------------------------------------------------------ |
+| Crea un nuovo oggetto        | [Come creare oggetti personalizzati](/l/it/user-guide/data-model/how-tos/create-custom-objects) |
+| Aggiungi campi a un oggetto  | [Come creare campi personalizzati](/l/it/user-guide/data-model/how-tos/create-custom-fields)    |
+| Collega gli oggetti tra loro | [Come creare campi di relazione](/l/it/user-guide/data-model/how-tos/create-relation-fields)    |
+
+## Per saperne di più
+
+* [Comprendere il tuo modello di dati](/l/it/user-guide/data-model/overview) — concetti chiave e consigli di pianificazione
+* [Oggetti](/l/it/user-guide/data-model/capabilities/objects) — oggetti standard e personalizzati
+* [Campi](/l/it/user-guide/data-model/capabilities/fields) — tutti i tipi di campo
+* [Campi di relazione](/l/it/user-guide/data-model/capabilities/relation-fields) — collegare gli oggetti
+* [FAQ sul modello di dati](/l/it/user-guide/data-model/how-tos/data-model-faq) — domande frequenti

packages/twenty-docs/l/it/user-guide/data-model/how-tos/data-model-faq.mdx

@@ -0,0 +1,157 @@
+---
+title: FAQ del modello dati
+description: Domande frequenti sul modello dati di Twenty.
+---
+
+## Gestione degli Oggetti
+
+<AccordionGroup>
+<Accordion title="Posso eliminare un oggetto personalizzato?">
+Sì, gli oggetti personalizzati possono essere eliminati. Puoi anche disattivarli prima, il che nasconde l'oggetto e i relativi dati dall'interfaccia, preservando i dati.
+</Accordion>
+
+<Accordion title="Posso eliminare gli oggetti standard (Persone, Aziende, ecc.)?">
+No, gli oggetti standard non possono essere eliminati. Puoi solo disattivarli, il che li nasconde dall'interfaccia ma preserva i dati.
+</Accordion>
+
+<Accordion title="Quanti oggetti personalizzati posso creare?">
+Puoi creare quanti oggetti e campi personalizzati ti servono: il prezzo non cambia.
+</Accordion>
+
+<Accordion title="Posso rinominare un oggetto standard?">
+Puoi rinominare l'etichetta degli oggetti standard (Persone, Aziende, Opportunità), ma non i loro nomi API. I nomi API sono fissi per garantire coerenza in tutti gli spazi di lavoro di Twenty.
+</Accordion>
+
+<Accordion title="Posso cambiare l'icona di un oggetto?">
+Sì, puoi cambiare l'icona sia per gli oggetti standard sia per quelli personalizzati in **Settings → Data Model**.
+</Accordion>
+
+<Accordion title="Posso riordinare gli oggetti nella barra di navigazione a sinistra?">
+Non ancora. L'ordinamento degli oggetti nella navigazione è attualmente fisso, ma questa funzionalità è pianificata per una futura versione.
+</Accordion>
+
+<Accordion title="Posso nascondere gli oggetti dalla barra di navigazione a sinistra?">
+Tutti gli oggetti attivi appaiono nella navigazione. Puoi disattivare gli oggetti di cui non hai bisogno in **Impostazioni → Modello dati**.
+</Accordion>
+</AccordionGroup>
+
+## Funzionalità dei Campi
+
+<AccordionGroup>
+<Accordion title="Posso cambiare il tipo di un campo dopo la creazione?">
+No, i tipi di campo non possono essere cambiati dopo la creazione. Se ti serve un tipo diverso, crea un nuovo campo con il tipo corretto, migra i tuoi dati e poi disattiva il vecchio campo.
+</Accordion>
+
+<Accordion title="Perché ho bisogno di nomi singolari e plurali diversi?">
+La nostra API GraphQL utilizza entrambe le forme per operazioni diverse:
+* `createPerson` (singolare) per azioni su singoli record
+* `createPeople` (plurale) per operazioni di massa
+
+Questo crea limitazioni quando le forme singolari e plurali sono le stesse, ma migliora l'esperienza dello sviluppatore.
+</Accordion>
+
+<Accordion title="Perché alcuni nomi di campi sono protetti?">
+Certi nomi di campi come `Tipo` o `Applicazione` sono riservati per uso di sistema. Scegli nomi alternativi come `Categoria` o `Classificazione`.
+</Accordion>
+
+<Accordion title="Cosa succede quando disattivo un campo?">
+* Il campo viene nascosto dall'interfaccia
+* I dati esistenti vengono conservati
+* Puoi ancora accedere al campo tramite API
+* Le relazioni esistenti rimangono, ma non puoi crearne di nuove
+* Puoi riattivare il campo in un secondo momento
+</Accordion>
+
+<Accordion title="Posso rendere obbligatorio un campo?">
+Attualmente non puoi rendere obbligatori i campi personalizzati. Tutti i campi accettano valori vuoti. Puoi utilizzare i flussi di lavoro per imporre i campi obbligatori inviando avvisi o bloccando le azioni quando i campi sono vuoti.
+</Accordion>
+
+<Accordion title="Qual è la differenza tra univoco e obbligatorio?">
+* **Univoco**: non possono esserci due record con lo stesso valore in questo campo
+* **Obbligatorio**: il campo deve avere un valore (attualmente non supportato per i campi personalizzati)
+</Accordion>
+
+<Accordion title="Posso creare campi di formula?">
+I campi di formula sono in arrivo in **H2 2026**. Nel frattempo, puoi utilizzare i Workflows per calcolare e aggiornare automaticamente i valori dei campi.
+</Accordion>
+
+<Accordion title="Posso avere campi nidificati nei miei oggetti?">
+I campi annidati stanno arrivando in **H2 2026**. Attualmente, puoi utilizzare i Workflows per importare i valori dei campi da oggetti correlati. Ad esempio, per visualizzare il settore di un'azienda sul record di una Persona, crea un campo personalizzato su Persone e utilizza un Workflow per sincronizzare il valore.
+</Accordion>
+
+<Accordion title="Posso riordinare i campi negli oggetti?">
+Sì, vai a Impostazioni → Modello di dati → oggetto a tua scelta → Layout e clicca su **Personalizza la pagina di record**. Se questo pulsante è disabilitato, è necessario creare un record.
+</Accordion>
+</AccordionGroup>
+
+## Relazioni
+
+<AccordionGroup>
+<Accordion title="Posso avere una relazione che punta allo stesso oggetto?">
+Sì! Le relazioni auto-referenziali sono supportate e consigliate per casi d'uso come le gerarchie di account. Ad esempio, crea una relazione da Aziende ad Aziende per tracciare account padre/figlio.
+</Accordion>
+
+<Accordion title="Posso creare relazioni molti-a-molti?">
+Molte relazioni tra molti sono in arrivo nel **H2 2026**. Attualmente, crea un oggetto intermedio con due relazioni uno-a-molti come soluzione alternativa.
+
+Ad esempio, per collegare Persone e Progetti (molti-a-molti), crea un oggetto "Assegnazioni ai progetti" con:
+* Una relazione con Persone (molte assegnazioni → una persona)
+* Una relazione con Progetti (molte assegnazioni → un progetto)
+</Accordion>
+
+<Accordion title="Cosa sono le relazioni verso più tipi di oggetti (relazioni Morph)?">
+Queste consentono a un oggetto di relazionarsi a più tipi di oggetti diversi tramite un unico campo. Ad esempio, le Note possono essere associate contemporaneamente a Persone E Aziende E Opportunità.
+
+Ogni Nota è collegata contemporaneamente a una Persona, a un'Azienda e a un'Opportunità.
+
+Scopri di più in [Campi di relazione](/l/it/user-guide/data-model/capabilities/relation-fields).
+</Accordion>
+
+<Accordion title="Posso avere più relazioni tra gli stessi oggetti?">
+Sì, puoi creare più relazioni tra gli stessi due oggetti. Ad esempio, un'Azienda potrebbe avere sia una relazione "Contatto principale" sia una relazione "Contatto di fatturazione" con Persone.
+</Accordion>
+
+<Accordion title="Cosa succede alle relazioni quando elimino un record?">
+Quando elimini un record, il collegamento della relazione viene rimosso dai record correlati. I record correlati non vengono eliminati.
+</Accordion>
+
+<Accordion title="Posso creare relazioni circolari?">
+Sebbene tecnicamente possibili, le relazioni circolari (A → B → C → A) andrebbero evitate perché possono causare confusione e potenziali problemi di prestazioni.
+</Accordion>
+</AccordionGroup>
+
+## Accesso e Permessi
+
+<AccordionGroup>
+<Accordion title="Dove posso vedere e modificare il mio modello dati?">
+Vai a **Settings → Data Model** per visualizzare e modificare tutti i tuoi oggetti e campi.
+</Accordion>
+
+<Accordion title="Perché non riesco a vedere il Modello Dati in Impostazioni?">
+Contatta l'amministratore del tuo workspace. L'accesso al modello dati è solitamente riservato solo agli amministratori.
+</Accordion>
+</AccordionGroup>
+
+## Gestione dei dati
+
+<AccordionGroup>
+<Accordion title="C'è un limite al numero di record che posso avere?">
+Non esiste un limite rigido al numero di record. Tuttavia, set di dati molto grandi possono influire sulle prestazioni in alcune viste. Usa filtri e viste per gestire efficacemente set di dati di grandi dimensioni.
+</Accordion>
+
+<Accordion title="Posso importare dati negli oggetti personalizzati?">
+Sì, puoi importare dati CSV in qualsiasi oggetto, inclusi gli oggetti personalizzati. Il processo di importazione supporta la mappatura dei campi per i campi personalizzati. Vedi [Come preparare i tuoi file CSV](/l/it/user-guide/data-migration/how-tos/prepare-your-csv-files).
+</Accordion>
+
+<Accordion title="Posso esportare la configurazione del mio modello dati?">
+Attualmente non esiste un'esportazione integrata per la configurazione del modello dati. Contatta il supporto se devi migrare il tuo modello dati tra spazi di lavoro.
+</Accordion>
+
+<Accordion title="Quanti campi possono avere un singolo oggetto?">
+Il numero massimo di campi che un singolo oggetto può avere è di 1600 campi secondo i limiti di Postgres, inclusi i campi esistenti e cancellati. Siate consapevoli che Venti non risolveranno il vostro spazio di lavoro se il limite di 1600 campi è raggiunto in quanto rientra nella nostra politica di utilizzo equo.
+</Accordion>
+</AccordionGroup>
+
+## Hai bisogno di ulteriore aiuto?
+
+Consulta i nostri [Servizi di implementazione](/l/it/user-guide/getting-started/capabilities/implementation-services) per assistenza nella progettazione di modelli dati complessi.

packages/twenty-docs/l/it/user-guide/data-model/overview.mdx

@@ -0,0 +1,177 @@
+---
+title: Modello dati
+description: Scopri cos'è un modello di dati e come progettarne uno che si adatti alla tua azienda.
+---
+
+## Cos'è un modello di dati?
+
+Un modello di dati è la struttura che definisce come le informazioni sono organizzate nel tuo CRM. Consideralo come il **progetto** dei dati dei tuoi clienti — lo progetti una volta, poi lo popoli con i tuoi dati reali.
+
+## Concetti chiave
+
+### Oggetti
+
+Gli **oggetti** sono le principali categorie di dati nel tuo CRM. Ogni oggetto rappresenta un tipo di elemento che vuoi monitorare.
+
+Twenty include oggetti standard:
+
+* **Persone** — individui (contatti, lead, partner)
+* **Aziende** — organizzazioni
+* **Opportunità** — trattative o vendite
+* **Note** — note allegate ai record
+* **Attività** — attività da fare collegate ai record
+
+Puoi anche creare **oggetti personalizzati** per qualsiasi aspetto specifico della tua azienda (ad es., Progetti, Abbonamenti, Eventi).
+
+### Campi
+
+I **campi** sono le proprietà o gli attributi che descrivono ogni oggetto. Memorizzano le informazioni effettive.
+
+Ad esempio, l'oggetto **Persone** ha campi come:
+
+* Nome
+* Email
+* Telefono
+* Titolo di lavoro
+* Azienda (una relazione con l'oggetto Aziende)
+
+I campi hanno diversi **tipi**: testo, numero, data, selezione, multiselezione, relazione e altro. Puoi aggiungere campi personalizzati a qualsiasi oggetto.
+
+### Record
+
+I **record** sono le singole voci all'interno di un oggetto — i dati effettivi che crei e gestisci.
+
+Ad esempio:
+
+* "John Smith" è un **record** nell'oggetto Persone
+* "Acme Corp" è un **record** nell'oggetto Aziende
+
+**Un'analogia:**
+
+| Concetto di modello di dati | Analogia del mondo reale                          |
+| --------------------------- | ------------------------------------------------- |
+| **Oggetti**                 | Sezioni in un libro (le categorie)                |
+| **Campi**                   | Colonne in un foglio di calcolo (le proprietà)    |
+| **Record**                  | Righe in un foglio di calcolo (le voci effettive) |
+
+Progetti il modello di dati (oggetti + campi) una volta, poi crei molti record all'interno di quella struttura.
+
+## Perché personalizzare il tuo modello di dati?
+
+Ogni azienda lavora in modo diverso. Personalizzare il tuo modello di dati significa poter modellare Twenty attorno ai **tuoi** processi invece di forzarli dentro un sistema rigido.
+
+Twenty offre massima flessibilità:
+
+* Crea tutti gli oggetti personalizzati di cui hai bisogno
+* Aggiungi campi personalizzati illimitati
+* Il prezzo non cambia in base alla personalizzazione
+
+## Consigli per progettare il tuo modello di dati
+
+### 1. Inizia dai tuoi oggetti principali
+
+Identifica i concetti principali con cui lavori. Twenty offre già:
+
+* **Persone** — i tuoi contatti
+* **Aziende** — le tue aziende
+* **Opportunità** — le tue trattative
+
+Pensa a cos'altro potrebbe servirti:
+
+* Stripe avrebbe bisogno di un oggetto `Subscriptions`
+* Airbnb avrebbe bisogno di un oggetto `Trips`
+* Un acceleratore avrebbe bisogno di un oggetto `Batches`
+
+### 2. Usa i campi per le varianti, non nuovi oggetti
+
+Se qualcosa è solo una caratteristica di un oggetto esistente, rendila un **campo**.
+
+**Usa i campi per:**
+
+* Categorie ed etichette (ad es., `Industry` per Aziende)
+* Valori di stato (ad es., `Stage` per Opportunità)
+* Attributi e proprietà
+
+### 3. Crea un oggetto quando è autonomo
+
+Se il concetto ha un proprio ciclo di vita, proprietà o relazioni, merita un oggetto.
+
+**Crea un oggetto per:**
+
+* **Progetti** — hanno scadenze, responsabili e attività
+* **Abbonamenti** — collegano aziende, prodotti e fatture
+* **Eventi** — coinvolgono i partecipanti e azioni di follow-up
+
+Questi vanno oltre un singolo campo perché contengono i propri dati e relazioni.
+
+### 4. Crea un oggetto quando i record sono a numero indefinito
+
+Se qualcosa può essere collegato più volte e non sai quante volte, usa un oggetto.
+
+**Approccio sbagliato:**
+Creare campi come `Product 1`, `Product 2`, `Product 3`...
+
+**Approccio corretto:**
+Crea un oggetto `Products` e collegalo ai record. In questo modo, puoi supportare uno, due o un centinaio di prodotti senza cambiare il tuo modello.
+
+### 5. Mantienilo semplice all'inizio
+
+Inizia dai campi. Passa a nuovi oggetti solo quando raggiungi i limiti:
+
+* Troppi campi su un unico oggetto
+* Record ripetuti che dovrebbero essere separati
+* Relazioni che non si adattano perfettamente
+
+## Nota speciale su Persone, Aziende e Opportunità
+
+<Warning>
+**La sincronizzazione di email e calendario funziona solo con Persone, Aziende e Opportunità.**
+
+Questi sono gli unici oggetti in cui puoi accedere a email e riunioni sincronizzate dalla tua casella di posta/calendario. Consigliamo di usarli il più possibile.
+</Warning>
+
+**Migliori Pratiche:**
+
+* Se hai bisogno di categorie di Persone, usa i campi (non nuovi oggetti)
+* Esempio: usa un campo `Person Type` con i valori "Prospect" e "Partner" invece di creare oggetti separati
+* Crea diverse **visualizzazioni** per filtrare: una che mostri i partner, un'altra che mostri i prospect
+
+**Va bene avere campi che non si applicano a ogni record.** Ad esempio, un campo `Referral Link` su Persone che si applica solo quando `Person Type = Partner`. Nascondi questo campo dalle visualizzazioni in cui non è pertinente.
+
+## Domande per guidare la tua scelta
+
+Chiediti:
+
+<Check>È solo una proprietà di qualcosa che ho già o ha bisogno delle proprie proprietà?</Check>
+<Check>Avrò mai bisogno di tenere traccia di più elementi di questo tipo per ogni record, senza sapere quanti?</Check>
+<Check>Questo concetto si collega a diversi oggetti, non solo a uno?</Check>
+<Check>Avrà un proprio ciclo di vita (fasi, date di inizio/fine)?</Check>
+
+Se la risposta è "sì" a una o più di queste, probabilmente è il momento di creare un nuovo oggetto.
+
+## Accedere al tuo modello di dati
+
+1. Vai su **Impostazioni** nella barra laterale sinistra
+2. Fai clic su **Modello dati**
+3. Visualizza tutti i tuoi oggetti (standard e personalizzati)
+4. Fai clic su qualsiasi oggetto per vedere e modificare i suoi campi
+
+<Note>
+**Non vedi il Modello Dati in Impostazioni?**
+
+L'accesso al modello di dati è solitamente limitato agli amministratori. Contatta l'amministratore del tuo spazio di lavoro se ti serve l'accesso.
+</Note>
+
+## Prossimi Passi
+
+Una volta pianificato il tuo modello di dati:
+
+* [Come creare oggetti personalizzati](/l/it/user-guide/data-model/how-tos/create-custom-objects)
+* [Come creare campi personalizzati](/l/it/user-guide/data-model/how-tos/create-custom-fields)
+* [Come creare campi di relazione](/l/it/user-guide/data-model/how-tos/create-relation-fields)
+
+## Hai Bisogno di Aiuto?
+
+<Tip>
+  Vuoi aiuto a progettare il tuo modello di dati? [Trova un partner di 20 certificati](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-data-model) per progettare e costruire i tuoi oggetti, campi e relazioni.
+</Tip>

packages/twenty-docs/l/it/user-guide/getting-started/capabilities/glossary.mdx

@@ -0,0 +1,104 @@
+---
+title: Glossario
+description: Familiarizza con la terminologia essenziale utilizzata in Twenty.
+---
+
+## API
+
+Le API (Interfaccia di Programmazione delle Applicazioni) ti consentono di connettere Twenty con altri sistemi software e creare integrazioni personalizzate.
+
+## App
+
+Le app sono estensioni personalizzate sviluppate sotto forma di codice che possono definire modelli di dati e funzioni di logica. Consentono agli sviluppatori di creare personalizzazioni riutilizzabili che possono essere distribuite in più spazi di lavoro.
+
+## Azioni di codice
+
+Le Azioni di codice sono passaggi del flusso di lavoro che ti permettono di scrivere JavaScript personalizzato per trasformare i dati, eseguire calcoli o applicare logiche complesse non possibili con le azioni predefinite.
+
+## Menu Comandi
+
+Il Menu Comandi è un'interfaccia di accesso rapido (aperta con `Cmd + K` su Mac e `Ctrl + K` su Windows) che ti consente di eseguire azioni, creare record e navigare nel tuo workspace in modo efficiente.
+
+## Azienda & Persone
+
+Il CRM ha due tipi fondamentali di record:
+
+* Una `Company` rappresenta un'azienda o un'organizzazione.
+* Le `People` rappresentano i clienti attuali e potenziali della tua azienda.
+
+## Campi Personalizzati
+
+I Campi Personalizzati sono campi di dati che crei per catturare informazioni specifiche alle esigenze e ai processi della tua azienda.
+
+## Modello dati
+
+Un Modello di Dati è la struttura che definisce come le informazioni sono organizzate nel tuo CRM, inclusi quali oggetti esistono, le loro proprietà (campi) e come sono correlati tra loro.
+
+## Preferiti
+
+I Preferiti sono record che hai contrassegnato per un accesso rapido, apparendo nella tua barra laterale per una navigazione istantanea ai dati importanti.
+
+## Campo
+
+Un campo si riferisce a un'area specifica dove sono memorizzati dati particolari per un'entità.
+
+## Iteratore
+
+Un Iterator è un'azione del flusso di lavoro che itera su un array di elementi, eseguendo le azioni successive per ciascun elemento nell'elenco.
+
+## Kanban
+
+Un `Kanban` è un modo visivo per monitorare i tuoi processi aziendali utilizzando carte e colonne. Ogni colonna rappresenta una fase nel tuo processo (ad esempio: nuovo, in corso, vinto, perso), e sposti i record attraverso queste fasi man mano che progrediscono.
+
+## Oggetto
+
+Un Oggetto è una struttura dati che rappresenta un tipo specifico di entità nel tuo CRM (come Persone, Aziende o Opportunità). Gli Oggetti possono essere standard (di sistema) o personalizzati (creati da te).
+
+## Opportunità
+
+Le Opportunità in Twenty CRM sono potenziali accordi o vendite con aziende o contatti.
+
+## Record
+
+Un record è un'istanza di un oggetto, come un account o un contatto specifico.
+
+## Campi di Relazione
+
+I campi di relazione creano connessioni tra oggetti diversi, consentendo di collegare i record tra loro (ad esempio collegare una Persona a un'Azienda).
+
+## Campi Standard
+
+I Campi Standard sono campi dati predefiniti che vengono forniti con oggetti di default e forniscono funzionalità comuni in tutti i workspace.
+
+## Attività
+
+Le Attività in Twenty CRM sono attività assegnate relative a contatti, aziende o opportunità.
+
+## Trigger
+
+I trigger sono il punto di partenza di un flusso di lavoro — l'evento o la condizione che avvia l'automazione. Esempi includono la creazione di record, l'aggiornamento di record, i webhook o orari pianificati.
+
+## Viste
+
+Puoi personalizzare la visualizzazione dei tuoi record usando le viste, impostando diversi filtri, layout e opzioni di ordinamento per ciascuna vista.
+
+## Upsert
+
+Upsert è un'operazione che combina "update" e "insert" — aggiorna un record esistente se viene trovata una corrispondenza, oppure crea un nuovo record se non esiste alcuna corrispondenza.
+
+## Webhooks
+
+I webhook sono messaggi automatici inviati da Twenty ad altre applicazioni quando si verificano eventi specifici, consentendo la sincronizzazione dei dati in tempo reale.
+
+## Flussi di Lavoro
+
+I Flussi di Lavoro sono processi automatizzati che attivano azioni in base a condizioni specifiche, aiutandoti ad automatizzare attività ripetitive e processi aziendali.
+
+## Workspace
+
+Un `Workspace` rappresenta tipicamente un'azienda che utilizza Twenty. Contiene tutti i record e i dati che tu e i membri del tuo team aggiungete a Twenty.
+Ha un singolo nome di dominio, che di solito è il nome di dominio che la tua azienda usa per gli indirizzi email dei dipendenti.
+
+## Membri del Workspace
+
+I Membri del Workspace sono gli utenti di Twenty del tuo team che hanno accesso al tuo Workspace. Possono essere assegnati come proprietari o assegnatari per i record.

packages/twenty-docs/l/it/user-guide/getting-started/capabilities/implementation-services.mdx

@@ -0,0 +1,17 @@
+---
+title: Servizi di Implementazione
+description: Che tu abbia bisogno d'aiuto per iniziare o creare personalizzazioni avanzate, abbiamo una soluzione.
+---
+
+## Partner di Implementazione
+
+Collabora con partner certificati di Twenty per personalizzazioni avanzate, integrazioni e supporto dedicato all’implementazione.
+
+<CardGroup cols={2}>
+  <Card title="Esplora i partner certificati" icon="magnifying-glass" href="https://twenty.com/partners/list?ref=docs-implementation-services">
+    Trova un partner e contattalo direttamente — filtra per area geografica, lingua e competenze.
+  </Card>
+  <Card title="Fatti abbinare da Twenty" icon="envelope" href="mailto:contact@twenty.com">
+    Dicci di cosa hai bisogno e ti metteremo in contatto con il partner giusto.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/it/user-guide/getting-started/capabilities/what-is-twenty.mdx

@@ -0,0 +1,42 @@
+---
+title: Che cos'è Twenty
+description: Twenty è un CRM open source che ti fornisce i componenti di base per creare esattamente ciò di cui la tua azienda ha bisogno.
+---
+
+## Visione
+
+Creare un buon CRM è difficile perché è un atto di equilibrio.
+Per ogni azienda, i requisiti sembrano semplici, eppure le esigenze di ciascuno sono distinte.
+Il risultato è un CRM che è o troppo basilare, o che tenta di essere un tuttofare finendo per non essere esperto in nulla.
+
+All'inizio, Twenty appare come la maggior parte dei CRM che già conosci: puoi monitorare le trattative, organizzare i contatti, gestire compiti e note.
+**Ma ciò che lo distingue è il nostro approccio all'estensibilità. Stiamo costruendo una piattaforma aperta che fornisce i blocchi di costruzione per risolvere i tuoi problemi aziendali unici.**
+
+Prioritizziamo principi universali e pattern comuni rispetto agli elenchi di funzionalità.
+Non cerchiamo di avere tutte le risposte, ma piuttosto di consentire agli utenti di trovare ciò che funziona meglio per loro.
+L'open-source è la base del nostro approccio, garantendo che Twenty evolva con la sua comunità, per la sua comunità.
+
+## Vantaggi
+
+**Personalizzabile:** Progettato per adattarsi alle esigenze della tua azienda.
+
+**Guidato dalla comunità:** Costruito e mantenuto da una vasta comunità open-source.
+
+**Conveniente:** Non sarai mai vincolato al fornitore, poiché puoi sempre ospitare autonomamente.
+
+## Caratteristiche principali
+
+* **Calendario ed email:** Sincronizza la tua casella di posta e il calendario per vedere tutte le comunicazioni sui record del tuo CRM. [Scopri di più](/l/it/user-guide/calendar-emails/overview).
+* **Modello dati:** Crea oggetti e campi personalizzati per rispecchiare i tuoi processi aziendali specifici. [Esplora](/l/it/user-guide/data-model/overview).
+* **Migrazione dei dati:** Importa ed esporta i tuoi dati via CSV o API. [Inizia qui](/l/it/user-guide/data-migration/overview).
+* **Viste e pipeline:** Organizza i tuoi dati con viste tabellari, bacheche Kanban e pipeline di vendita. [Scopri](/l/it/user-guide/views-pipelines/overview).
+* **Flussi di lavoro:** Automatizza i tuoi processi aziendali e integra con strumenti esterni. [Crea automazioni](/l/it/user-guide/workflows/overview).
+* **AI:** Potenzia il tuo CRM con funzionalità e agenti basati sull'IA. [Esplora l'IA](/l/it/user-guide/ai/overview).
+* **Dashboard:** Monitora le prestazioni con report e visualizzazioni personalizzati. [Visualizza le dashboard](/l/it/user-guide/dashboards/overview).
+* **Autorizzazioni e accesso:** Controlla chi può visualizzare, modificare e gestire i tuoi dati con autorizzazioni basate sui ruoli. [Configura l'accesso](/l/it/user-guide/permissions-access/overview).
+* **Note e attività:** Crea note e attività collegate ai tuoi record per una collaborazione migliore.
+* **API e Webhooks:** Connettiti ad altre app e crea integrazioni personalizzate. [Inizia a integrare](/l/it/developers/extend/api).
+
+## Unisciti ora
+
+[Registrati qui](https://app.twenty.com) o [diventa un collaboratore su GitHub](https://github.com/twentyhq/twenty).

packages/twenty-docs/l/it/user-guide/getting-started/how-tos/configure-your-workspace.mdx

@@ -0,0 +1,77 @@
+---
+title: Configura il tuo Spazio di Lavoro
+description: Ogni azienda lavora in modo diverso. Inizia con questi 3 passaggi per adattare Twenty alle tue esigenze.
+---
+
+<Note>**Risultato rapido**: Inizia collegando la tua casella di posta. Ciò ti offre un valore immediato e aiuta il tuo team a vedere Twenty in azione con dati reali. Puoi farlo in Impostazioni → Account.</Note>
+
+## 1. Personalizza il tuo modello di dati
+
+Twenty offre la flessibilità necessaria per modellare il modello di dati che meglio supporterà la tua routine quotidiana.
+Crea oggetti e campi di qualsiasi tipo, incluse le relazioni tra i tuoi diversi oggetti. Puoi farlo sotto Impostazioni → Modello di Dati.
+Ecco alcuni suggerimenti:
+
+* **Non sei limitato nel numero di campi personalizzati o oggetti personalizzati**. Aggiungere oggetti e campi personalizzati non comporterà l'aggiornamento del tuo piano.
+* **Persone, Aziende e Opportunità sono i tre oggetti da cui puoi accedere alle email e alle riunioni sincronizzate dalla tua casella di posta e dal calendario**. Si consiglia di utilizzarli il più possibile, aggiungendo campi per categorizzare i tuoi record se necessario. Ecco un esempio:
+  * È meglio utilizzare l'oggetto Persone per le vostre prospettive e partner, creando un campo sull'oggetto Persone chiamato \`\`\`Persona Tipo\`\`\`\`, invece di creare un oggetto personalizzato partner, perché non si sarebbe in grado di accedere alle email scambiate con questa persona dai record partner.
+  * Crea viste diverse sotto Persone, una per visualizzare i partner e una per visualizzare i potenziali clienti.
+* Due Persone non possono avere lo stesso indirizzo email. Due Aziende non possono avere lo stesso dominio.
+* Puoi disattivare i campi e gli oggetti standard che non vuoi utilizzare.
+* Puoi nascondere i campi dalle viste: non aver paura di creare campi, non dovrai mostrarli tutti.
+
+Leggi [questo articolo](/l/it/user-guide/data-model/overview) per imparare a progettare il tuo modello di dati.
+
+## 2. Importa i tuoi dati
+
+Importare i tuoi dati esistenti in Twenty dà al tuo team un contesto fin dall'inizio.
+
+### Collega la tua casella di posta
+
+Se non lo hai fatto creando il tuo spazio di lavoro, collega il tuo **account Google o Microsoft** sotto Impostazioni → Account. Questo permette a Twenty di:
+
+* Importare i tuoi messaggi e incontri
+* Creare automaticamente i contatti basandosi sulle interazioni (opzionale)
+* Mantenere visibile la cronologia delle comunicazioni per il tuo team
+
+**Usi un altro provider?**
+Puoi aggiungere un'altra casella di posta tramite SMTP o un altro calendario tramite CalDAV. Vai a **Impostazioni → Account** per configurare.
+
+### Importa dati tramite CSV
+
+Usa il menu Comando (`Cmd + K` o `Ctrl + K`) per importare Persone, Aziende, Opportunità o qualsiasi oggetto personalizzato tramite CSV.
+
+**Linee guida principali**:
+
+* Scarica il file di esempio per capire il formato richiesto
+* Limita ogni file a 10k record
+* Rimuovi email duplicate per le Persone o domini duplicati per le Aziende
+* Rivedi e correggi gli errori (evidenziati in giallo) prima di importare
+
+Leggi [questo articolo](/l/it/user-guide/data-migration/overview) per saperne di più sull'importazione dei dati.
+
+## 3. Crea la tua prima vista
+
+La creazione di diverse viste è fondamentale per rendere i dati utilizzabili per il tuo team.
+Ecco come procedere:
+
+* **Aggiungi o nascondi colonne**
+  Gestisci i campi visibili in una data vista facendo clic su Opzioni → Campi (dall'alto a destra). Puoi mostrare/nascondere i campi da lì.
+
+* **Riordina i campi**
+  Riordina i campi da una data vista facendo clic su Opzioni → Campi (dall'alto destra). Trascina e rilascia i campi per riorganizzarli.
+
+* **Filtra la tua vista**
+  Restringi i record visibili utilizzando i Filtri dalla parte in alto a destra.
+
+* **Ordina i record**
+  Riordina i record visualizzati utilizzando la funzione Ordina dalla parte in alto a destra, o cliccando direttamente sul nome della colonna.
+
+* **Scegli il layout**
+  Puoi passare a un layout **Kanban** o a un layout elenco **Raggruppa Per**, purché l'oggetto abbia un campo di selezione tipo `Stadio` o simile.
+
+* **Salva la tua vista come Preferiti**
+  Ciò può essere fatto utilizzando il menu a discesa che mostra le diverse viste.
+
+## Cosa c'è dopo?
+
+Inizia a creare automazioni usando [flussi di lavoro](/l/it/user-guide/workflows/overview).

packages/twenty-docs/l/it/user-guide/getting-started/how-tos/create-workspace.mdx

@@ -0,0 +1,48 @@
+---
+title: Crea un Workspace
+description: Segui una guida passo passo su come registrarti su Twenty, scegliere un piano di abbonamento e configurare il tuo account.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Fase 1: Registrazione
+
+1. Vai a [Registrati su Twenty](https://app.twenty.com).
+2. Seleziona il tuo metodo di registrazione preferito:
+   * **Continua con Google** per registrazione con account Google.
+   * **Continua con Microsoft** per registrazione con account Microsoft.
+   * Oppure, **Continua con Email** per la registrazione delle email.
+
+<VimeoEmbed videoId="927066829" title="Dimostrazione video" />
+
+## Fase 2: Scelta del Periodo di Prova
+
+Scegli tra due periodi di prova:
+
+### 30 giorni
+
+Con carta di credito
+
+### 7 giorni
+
+Senza carta di credito
+
+Entrambe le prove comprendono:
+
+* Accesso completo
+* Contatti illimitati
+* Integrazione e-mail
+* Oggetti personalizzati
+* API e Webhook
+
+Puoi cliccare su "Cambia piano" per scegliere un piano o un intervallo di fatturazione diverso.
+
+<img src="/images/user-guide/create-workspace/choose-plan.png" style={{width:'100%'}} />
+
+## Fase 3: Conferma di Pagamento e Configurazione dell'Account
+
+Dopo l'approvazione del pagamento tramite Stripe, sei diretto a creare il tuo spazio di lavoro e il profilo utente. Ricorda che puoi annullare il tuo abbonamento in qualsiasi momento.
+
+## Supporto
+
+Per domande o aiuto, contatta il team di supporto dedicato a [contact@twenty.com](mailto:contact@twenty.com) o invia un messaggio su [Discord](https://discord.gg/cx5n4Jzs57).

packages/twenty-docs/l/it/user-guide/getting-started/how-tos/navigate-around-twenty.mdx

@@ -0,0 +1,84 @@
+---
+title: Naviga in Twenty
+description: Ottieni una panoramica rapida su come navigare nella piattaforma e dove eseguire diverse azioni.
+---
+
+## Il Layout Principale
+
+Il centro dello schermo è **dove vivono i tuoi record**: Persone, Aziende, Opportunità, Attività, Note, Dashboard, Flussi di lavoro e qualsiasi altro oggetto che hai creato. È qui che si svolge il lavoro quotidiano.
+È possibile **visualizzare, modificare o eliminare i record** da lì, così come **creare nuove viste**.
+
+<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
+
+## La Barra di Navigazione
+
+Sul lato sinistro, dall'alto verso il basso, potrai:
+
+* Passa tra i tuoi diversi spazi di lavoro usando il menu a discesa oppure crea un nuovo spazio di lavoro.
+* Usa la barra di ricerca (premi `/` per attivarla all’istante)
+* Apri la sezione Impostazioni
+* Avere accesso diretto alle tue **viste preferite**. I preferiti sono unici per ogni utente.
+* Passa tra i diversi oggetti
+* **Crea automazioni** utilizzando i flussi di lavoro
+
+<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
+
+## Il Menu Comandi
+
+Il Menu Comandi ti offre **accesso rapido alle azioni** in Twenty. Puoi accedervi in due modi:
+
+* **Scorciatoia da tastiera**: Premi `Cmd + K` (Mac) o `Ctrl + K` (Windows)
+* **Mouse**: fai clic sui tre puntini nell'angolo in alto a destra
+  Da lì, puoi:
+* Crea nuovi record
+* **Importa ed esporta dati tramite CSV**
+* Crea nuove viste
+* Accedi ai record eliminati (Twenty supporta eliminazioni temporanee e definitive)
+* Consulta le scorciatoie da tastiera per accedere rapidamente agli oggetti nel tuo spazio di lavoro
+
+<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
+
+## La barra di ricerca
+
+La barra di ricerca è accessibile tramite il Menu Comandi, nella parte superiore della barra di navigazione, oppure premendo `/` per attivarla all'istante. La ricerca funziona su tutti gli oggetti.
+
+<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
+
+## Il pannello laterale
+
+Quando fai clic su un record, il pannello laterale appare a destra. Questo ti offre una rapida panoramica delle informazioni chiave del record, senza portarti in un'altra pagina. Da lì, puoi decidere di chiudere questa panoramica o di ottenere ulteriori informazioni su questo record, facendo clic sul pulsante Apri.
+
+<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
+
+## Viste
+
+Ogni oggetto (come Opportunità o Persone) supporta più viste. Non c’è un limite al numero di viste per oggetto.
+
+Utilizza il menu a discesa in alto a sinistra del layout principale per passare tra le diverse visualizzazioni. Ad esempio:
+
+* Usa una vista Kanban per monitorare le opportunità in base alla fase
+* Usa la vista Group By per creare sezioni e migliorare l’efficienza
+* Usa i filtri per concentrarti su record specifici (ad es. contatti creati la settimana scorsa)
+* Salva le viste filtrate per riutilizzarle in seguito
+* Viste preferite per un accesso veloce
+
+<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
+
+Se sei nuovo alle Viste, leggi la nostra [Guida a Viste e Pipeline](/l/it/user-guide/views-pipelines/overview) per imparare come crearle e personalizzarle.
+
+## Impostazioni
+
+Apri le tue Impostazioni dall'angolo in alto a sinistra per:
+
+* **Connetti i tuoi account di posta e calendario** per una sincronizzazione senza interruzioni
+* Personalizza il tuo **modello di dati**: crea oggetti, campi e relazioni personalizzati
+* **Accedi all’area di prova delle API e configura i webhook**
+* **Gestisci i permessi utente** e i controlli di accesso dello spazio di lavoro
+* Invita i membri del team e gestisci i ruoli utente
+* Modifica il tuo profilo e le preferenze dello spazio di lavoro
+* Configura la fatturazione e monitora l’utilizzo dei crediti dei flussi di lavoro
+* Scopri e abilita le funzionalità in arrivo (in Aggiornamenti → Accesso anticipato)
+* **Accedi al Supporto** per contattare l'assistenza tramite live chat
+* **Apri la Documentazione** per consultare la Guida utente e la documentazione per sviluppatori
+
+<Note>Se non vedi tutte queste sezioni in Impostazioni, contatta l'amministratore del tuo workspace — alcune sezioni hanno un accesso limitato.</Note>

packages/twenty-docs/l/it/user-guide/introduction.mdx

@@ -0,0 +1,59 @@
+---
+title: Guida utente
+description: Benvenuto nella Guida utente di Twenty, la tua risorsa per configurazioni avanzate e migliori pratiche.
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+<CardGroup cols={3}>
+  <Card href="/l/it/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
+    <CardTitle>Modello di dati</CardTitle>
+    Personalizza il tuo modello di dati per adattarlo ai tuoi processi aziendali.
+  </Card>
+
+  <Card href="/l/it/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
+    <CardTitle>Migrazione dei dati</CardTitle>
+    Importa ed esporta i tuoi dati via CSV o API.
+  </Card>
+
+  <Card href="/l/it/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
+    <CardTitle>Calendario ed email</CardTitle>
+    Centralizza le riunioni e le email del tuo team.
+  </Card>
+
+  <Card href="/l/it/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
+    <CardTitle>Flussi di lavoro</CardTitle>
+    Automatizza i processi e integra con strumenti esterni.
+  </Card>
+
+  <Card href="/l/it/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
+    <CardTitle>IA</CardTitle>
+    Potenzia il tuo team con agenti IA.
+  </Card>
+
+  <Card href="/l/it/user-guide/layout/overview" img="/images/user-guide/halftone/layout.png">
+    <CardTitle>Layout</CardTitle>
+    Navigazione, viste e personalizzazione della pagina del record.
+  </Card>
+
+  <Card href="/l/it/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
+    <CardTitle>Dashboard</CardTitle>
+    Informazioni in tempo reale per monitorare le prestazioni.
+  </Card>
+
+  <Card href="/l/it/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>Autorizzazioni e accesso</CardTitle>
+    Gestisci i ruoli e l'accesso a Twenty.
+  </Card>
+
+  <Card href="/l/it/user-guide/billing/overview" img="/images/user-guide/halftone/billing.png">
+    <CardTitle>Fatturazione</CardTitle>
+    Comprendi come funzionano i prezzi e la fatturazione di Twenty.
+  </Card>
+
+  <Card href="/l/it/user-guide/settings/overview" img="/images/user-guide/halftone/settings.png">
+    <CardTitle>Impostazioni</CardTitle>
+    Configura le preferenze del tuo spazio di lavoro.
+  </Card>
+
+</CardGroup>

packages/twenty-docs/l/it/user-guide/layout/capabilities/navigation.mdx

@@ -0,0 +1,38 @@
+---
+title: Navigazione
+description: Personalizza la barra laterale sinistra per adattarla al modo in cui lavora il tuo team.
+---
+
+La barra laterale sinistra è il modo principale per navigare in Twenty. È completamente personalizzabile — puoi riorganizzarla per adattarla al tuo flusso di lavoro senza toccare alcuna pagina delle impostazioni.
+
+## Riordinare gli elementi
+
+Trascina e rilascia qualsiasi elemento nella barra laterale per cambiarne la posizione. L'ordine viene salvato per utente, così ogni membro del team può organizzare la propria barra laterale.
+
+## Cartelle
+
+Raggruppa gli elementi correlati in cartelle. Ad esempio, puoi creare una cartella "Vendite" contenente le tue viste della pipeline, una cartella "Assistenza" per i ticket o una cartella "Operazioni" per gli oggetti interni.
+
+Per creare una cartella, fai clic con il tasto destro nella barra laterale oppure usa il pulsante `+`.
+
+## Nascondere gli oggetti
+
+Gli oggetti che non utilizzi possono essere nascosti dalla barra laterale. Non vengono eliminati — sono solo fuori dalla vista. È possibile mostrarli di nuovo in qualsiasi momento da Impostazioni → Modello di dati.
+
+## Preferiti
+
+Aggiungi viste, record o ricerche alla sezione Preferiti in cima alla barra laterale per un accesso con un clic. I Preferiti sono personali — ogni utente gestisce i propri.
+
+## Collegamenti personalizzati
+
+Aggiungi collegamenti a strumenti esterni direttamente nella barra laterale. Utile per collegare il tuo wiki, le dashboard in altri strumenti o qualsiasi URL che il tuo team utilizza regolarmente.
+
+## Menu Comandi
+
+Premi `Cmd+K` (o `Ctrl+K`) per aprire il menu comandi — una barra di ricerca ad accesso rapido per passare a qualsiasi record, vista o azione senza usare la barra laterale.
+
+## Personalizzare la barra laterale
+
+Per personalizzare la barra laterale, passa il mouse sulla sezione "Workspace" nella barra laterale e fai clic sull'icona a forma di chiave inglese.
+
+<img src="/images/user-guide/layout/navigation-edit-icon.png" alt="Icona di modifica della navigazione" />

packages/twenty-docs/l/it/user-guide/layout/capabilities/record-pages.mdx

@@ -0,0 +1,61 @@
+---
+title: Pagine dei record
+description: Personalizza il layout delle singole pagine di dettaglio dei record con schede e widget.
+---
+
+## Panoramica
+
+Quando apri un record in Twenty, la pagina di dettaglio è composta da **schede** e **widget**. Entrambi sono completamente personalizzabili per ciascun tipo di oggetto.
+
+## Schede
+
+Ogni pagina del record può avere più schede — simili alle schede di un browser. Utilizzale per organizzare i diversi aspetti di un record. Ad esempio, un record Azienda potrebbe avere schede per Panoramica, Comunicazione, Attività e File.
+
+Puoi:
+
+* Aggiungi e rimuovi schede
+* Rinomina le schede
+* Riordina le schede trascinandole
+* Imposta quale scheda viene mostrata per impostazione predefinita
+
+## Widget
+
+I widget sono gli elementi costitutivi all'interno di ogni scheda. Tipi di widget disponibili:
+
+| Widget                 | Cosa mostra                                       |
+| ---------------------- | ------------------------------------------------- |
+| **Campi**              | Campi del record, raggruppati o singolarmente     |
+| **Record correlati**   | Tabella di record collegati tramite una relazione |
+| **Email**              | Cronologia delle email dagli account collegati    |
+| **Calendario**         | Eventi di calendario associati al record          |
+| **Sequenza temporale** | Cronologia di attività ed eventi                  |
+| **Attività**           | Attività associate                                |
+| **Note**               | Note in testo formattato                          |
+| **File**               | File allegati                                     |
+| **Grafici**            | Dati visivi provenienti da record correlati       |
+| **iFrame**             | Contenuto esterno incorporato                     |
+| **Testo formattato**   | Contenuto statico o descrizioni                   |
+
+## Personalizzazione di una pagina del record
+
+1. Apri un record qualsiasi
+2. Premi `Cmd+K` e cerca "Modifica il layout della pagina del record"
+
+o
+
+1. Vai a Impostazioni → Modello dati → oggetto di tua scelta → Layout
+
+2. Fai clic sul pulsante "Personalizza pagina del record" per quell'oggetto
+
+3. Ora sei in modalità di personalizzazione:
+   * **Aggiungi widget** dal selettore di widget
+   * **Trascina i widget** per riposizionarli sulla griglia
+   * **Ridimensiona i widget** trascinando i bordi
+   * **Configura i campi** mostrati all'interno di ciascun widget
+   * **Gestisci le schede** — aggiungi, rimuovi, rinomina, riordina
+
+4. Salva le modifiche — si applicano a tutti i record di quel tipo di oggetto
+
+## Visibilità dei campi
+
+All'interno di un widget Campi, puoi controllare quali campi sono visibili e in quale ordine. Questo ti consente di creare layout mirati — ad esempio, mostrando solo i campi più importanti nella scheda Panoramica e inserendo i campi dettagliati in una scheda separata.

packages/twenty-docs/l/it/user-guide/layout/overview.mdx

@@ -0,0 +1,45 @@
+---
+title: Disposizione
+description: Personalizza il modo in cui navighi, esplori e visualizzi i record in Twenty.
+---
+
+Il layout di Twenty è personalizzabile su tre livelli: come navighi nell'app, come consulti gli elenchi di record e cosa vedi quando apri un singolo record.
+
+## Navigazione
+
+La barra laterale sinistra è completamente personalizzabile. Puoi:
+
+* **Riordina gli elementi** trascinandoli e rilasciandoli
+* **Crea cartelle** per raggruppare oggetti e viste correlati
+* **Nascondi gli oggetti** che non usi
+* **Aggiungi collegamenti personalizzati** a strumenti esterni
+* **Aggiungi ai preferiti** per accedere rapidamente a viste, record o ricerche
+
+[Riferimento alla navigazione →](/l/it/user-guide/layout/capabilities/navigation)
+
+## Viste
+
+Le viste determinano come vengono visualizzati gli elenchi di record. Twenty supporta tre tipi di vista:
+
+| Vista          | Ideale per                                                                                |
+| -------------- | ----------------------------------------------------------------------------------------- |
+| **Tabella**    | Lavorare con molti record contemporaneamente — righe e colonne in stile foglio di calcolo |
+| **Kanban**     | Monitoraggio della pipeline — schede da trascinare e rilasciare organizzate per fase      |
+| **Calendario** | Pianificazione basata sul tempo — record posizionati in base a un campo data              |
+
+Ogni vista salva i propri filtri, l'ordinamento, la visibilità dei campi e la configurazione del raggruppamento. Le viste possono essere condivise con lo spazio di lavoro o mantenute private.
+
+[Viste tabella →](/l/it/user-guide/views-pipelines/capabilities/table-views) · [Viste Kanban →](/l/it/user-guide/views-pipelines/capabilities/kanban-views) · [Vista calendario →](/l/it/user-guide/views-pipelines/capabilities/calendar-view)
+
+## Pagine dei record
+
+Quando apri un record, la pagina dei dettagli è composta da schede e widget configurabili. Puoi:
+
+* **Aggiungi, rimuovi e riordina le schede** su qualsiasi tipo di record
+* **Configura widget** — campi, record correlati, e-mail, timeline, calendario, attività, note, file, grafici, iFrame e altro ancora
+* **Trascina e ridimensiona i widget** in un layout a griglia
+* **Controlla la visibilità dei campi** per ciascun widget
+
+Accedi alla modalità di personalizzazione del layout dal menu comandi (`Cmd+K` → "Modifica layout della pagina del record").
+
+[Riferimento alle pagine dei record →](/l/it/user-guide/layout/capabilities/record-pages)

packages/twenty-docs/l/it/user-guide/legal/how-tos/legal-faq.mdx

@@ -0,0 +1,125 @@
+---
+title: FAQ Legali
+description: Domande legali più frequenti.
+---
+
+## Residenza dei dati e trasferimenti internazionali
+
+<AccordionGroup>
+<Accordion title="In quale paese e regione saranno memorizzati i nostri dati, allegati, registri e backup?">
+Venti Cloud funzionano su server AWS situati a Francoforte, Germania.
+</Accordion>
+<Accordion title="La regione di hosting può essere fissata contrattualmente per il nostro spazio di lavoro?">
+La selezione della regione di hosting sarà disponibile a partire dal 2027, inizialmente per i nuovi workspace. Gli utenti potranno richiedere un cambio di regione per un workspace esistente in una fase successiva. In alternativa, puoi contattare i [nostri Partner](https://twenty.com/partners/list?categories=HOSTING) per aiutarti a configurare la tua istanza.
+</Accordion>
+<Accordion title="Quali subprocessori possono trattare o accedere ai nostri dati CRM e in quali paesi si trovano?">
+Un elenco di tutti i sub-responsabili del trattamento è disponibile nel [nostro Trust Center](https://trust.twenty.com/?tab=subprocessors).
+</Accordion>
+<Accordion title="Quali garanzie si applicano ai trasferimenti internazionali di dati?">
+Le Clausole contrattuali standard dell'UE, insieme all'Addendum UK e alle modifiche svizzere, si applicano ai trasferimenti internazionali di dati al di fuori dell'UE, inclusi i trasferimenti verso tutti i sub-responsabili del trattamento.
+</Accordion>
+</AccordionGroup>
+
+## Accordo di trattamento dei dati e ruoli giuridici
+
+<AccordionGroup>
+<Accordion title="Dove possiamo trovare l'attuale Data Processing Agreement (DPA)?">
+Puoi generare il tuo DPA firmato all'indirizzo https://{your-domain}/settings/legal/dpa (ad es. https://getting-started.twenty.com/settings/legal/dpa).
+</Accordion>
+<Accordion title="Venti fungono da responsabili del trattamento dei dati per il commerciante e le informazioni di contatto memorizzate nel CRM, mentre la nostra azienda rimane il titolare del trattamento?">
+Secondo la nostra [Privacy Policy](https://twenty.com/privacy-policy), Venti agisce come il responsabile del trattamento dei dati per il commerciante e le informazioni di contatto memorizzate nel CRM, mentre la tua azienda rimane il titolare del trattamento.
+</Accordion>
+<Accordion title="Il contenuto di CRM è mai utilizzato per addestrare modelli di IA Venti o di terze parti?">
+I contenuti del CRM possono essere utilizzati per addestrare modelli di IA in base ai Termini e condizioni dei sub-responsabili del trattamento. Twenty non dispone di un proprio modello di IA: tutti i modelli di IA disponibili su Twenty Cloud sono forniti dai nostri sub-responsabili del trattamento.
+</Accordion>
+<Accordion title="Se esiste un trattamento AI opzionale, può essere completamente disabilitato per il nostro spazio di lavoro?">
+L'IA può essere completamente disattivata disattivando tutti i modelli di IA in Impostazioni → AI → Modelli. Inoltre, nessun dato viene inviato all'IA a meno che tu non interagisca attivamente con la chat dell'IA o con un nodo di IA in un workflow.
+</Accordion>
+</AccordionGroup>
+
+## Controlli di sicurezza e di accesso
+
+<AccordionGroup>
+<Accordion title="Viene utilizzata la crittografia in transito e a riposo, quali sono le vostre pratiche di gestione delle chiavi e come vengono isolati i dati dei tenant?">
+Tutti i dati sono crittografati in transito e a riposo. I dati dei tenant sono isolati tramite una configurazione schema-per-tenant e le chiavi di crittografia vengono ruotate periodicamente.
+</Accordion>
+<Accordion title="A quali venti membri del personale o subprocessori possono accedere agli spazi di lavoro dei clienti, per quali scopi e come viene approvato l'accesso e registrato?">
+I team di ingegneria e supporto di Venti possono accedere ai workspace dei clienti per studiare e risolvere i problemi. I proprietari dello spazio di lavoro controllano questo: l'accesso al supporto può essere disabilitato in qualsiasi momento in Impostazioni → Generale → Sicurezza, e rimane spento fino a quando non si accende indietro.
+</Accordion>
+<Accordion title="Qual è il processo di notifica degli incidenti e il calendario di notifica di destinazione a seguito di un incidente di sicurezza confermato che colpisce i nostri dati?">
+In caso di violazione confermata di dati personali che interessano i Suoi dati, vi informeremo senza indebito ritardo e in ogni caso entro 48 ore dalla presa di conoscenza. La nostra notifica includerà, nella misura conosciuta al tempo: la natura della violazione, le categorie e il volume approssimativo dei dati e degli individui interessati, le conseguenze probabili e le misure di risanamento e di mitigazione adottate o previste. Forniremo aggiornamenti man mano che l'indagine progredisce.
+</Accordion>
+</AccordionGroup>
+
+## Conservazione e cancellazione dei dati
+
+<AccordionGroup>
+<Accordion title="Quando viene eliminato un record CRM individuale, quando viene rimosso dai sistemi attivi?">
+Quando un record viene eliminato, inizialmente viene eliminato in modalità soft-delete e può ancora essere ripristinato. Viene eliminato in modo permanente e rimosso dai sistemi attivi una volta trascorso il periodo di conservazione o quando un utente lo distrugge manualmente.
+</Accordion>
+<Accordion title="Per quanto tempo i record in soft-delete vengono mantenuti nel sistema?">
+Per impostazione predefinita, i record in soft-delete vengono mantenuti per 14 giorni, dopodiché vengono rimossi definitivamente dal sistema. Il periodo di conservazione dei record in soft-delete può essere modificato in Impostazioni → Generale → Sicurezza.
+</Accordion>
+<Accordion title="Per quanto tempo questo record può rimanere in backup o registri tecnici?">
+Un record rimosso rimane nei backup per 30 giorni, dopodiché viene eliminato definitivamente.
+</Accordion>
+<Accordion title="Quando uno spazio di lavoro è chiuso o viene richiesta la cancellazione completa, quale timeline esatta si applica ai dati di produzione, agli allegati, ai registri e ai backup?">
+Quando uno spazio di lavoro viene eliminato, i suoi dati vengono rimossi dai sistemi live entro circa 90 giorni dalla terminazione del servizio, e di solito molto prima. Le copie di backup e di archivio vengono poi sovrascritte o cancellate entro altri 90 giorni, dopo di che tutti i dati vengono eliminati definitivamente. Durante entrambi i periodi i dati sono isolati da qualsiasi uso operativo. Su richiesta, possiamo fornire una certificazione scritta una volta completata la purga. Cfr. la clausola 4.9 del vostro Contratto di trattamento dei dati per tutti i termini.
+</Accordion>
+<Accordion title="Durante un periodo di backup-retention vengono eliminati i dati isolati dall'accesso operativo e uso?">
+Sì, durante qualsiasi periodo di backup-retention i dati cancellati sono isolati dall'uso operativo.
+</Accordion>
+<Accordion title="Qualche categoria di dati viene conservata più a lungo per scopi giuridici, di fatturazione, di prevenzione delle frodi, di sicurezza o di audit? In caso affermativo, quali categorie e per quanto tempo?">
+Per maggiori informazioni sulla conservazione dei dati, è possibile richiedere la nostra Politica di gestione e conservazione dei dati disponibile nel [nostro Trust Center](https://trust.twenty.com/?tab=documents).
+</Accordion>
+<Accordion title="Venti possono fornire una conferma scritta quando è stata completata una richiesta di cancellazione completa?">
+Riconosciamo le richieste di cancellazione e forniamo una conferma scritta una volta completata la cancellazione.
+</Accordion>
+</AccordionGroup>
+
+## Backup e resilienza
+
+<AccordionGroup>
+<Accordion title="Qual è la frequenza di backup e il periodo di conservazione?">
+I backup vengono creati in modo continuo con snapshot giornalieri e il periodo di conservazione è di 30 giorni.
+</Accordion>
+<Accordion title="Qual è l'obiettivo del punto di recupero e l'obiettivo del periodo di recupero per Twenty Cloud?">
+RTO e RPO sono entrambe 6 ore (secondo il nostro DPA).
+</Accordion>
+<Accordion title="Qual è il processo per richiedere o eseguire un restauro?">
+Per richiedere un ripristino, contatta il nostro team tramite la chat di supporto o via email a [contact@twenty.com](mailto:contact@twenty.com).
+</Accordion>
+<Accordion title="I backup sono crittografati e memorizzati nella stessa regione dei dati primari dello spazio di lavoro?">
+Tutti i backup sono criptati e memorizzati in luoghi geograficamente separati all'interno della stessa giurisdizione (ad esempio all'interno dell'UE per i dati dell'UE).
+</Accordion>
+</AccordionGroup>
+
+## Conformità
+
+<AccordionGroup>
+<Accordion title="Venti GDPR sono conformi?">
+Sì, Venti sono [conformi al GDPR](https://trust.twenty.com/?tab=securityControls\&frameworks=gdpr_v1).
+</Accordion>
+<Accordion title="Venti SOC 2 sono conformi?">
+Sì, Twenty è [conforme a SOC 2](https://trust.twenty.com/?tab=securityControls\&frameworks=soc2_v1).
+</Accordion>
+<Accordion title="Venti HIPAA sono conformi?">
+No, Venti sono in procinto di diventare conformi agli HIPAA.
+</Accordion>
+</AccordionGroup>
+
+## Licenze
+
+<AccordionGroup>
+<Accordion title="Se modifico il codice per aggiungere funzionalità destinate solo all’uso interno del mio team, devo pubblicare tali modifiche?">
+No. Eseguire una versione modificata per il tuo team interno non costituisce distribuzione, quindi non sorge alcun obbligo di pubblicazione. La clausola di rete dell'AGPL si applica quando persone esterne alla tua organizzazione interagiscono con la tua istanza modificata tramite la rete.
+</Accordion>
+<Accordion title="Se creo un front-end separato e utilizzo Twenty come backend così com'è, devo pubblicare tali modifiche?">
+No. Il tuo front-end è un tuo lavoro separato, e comunicare con Twenty tramite le sue API non cambia questa situazione. Poiché Twenty stesso non è modificato, non c'è nulla da pubblicare.
+</Accordion>
+<Accordion title="Se modifico il codice per aggiungere funzionalità per poi rivenderlo, devo pubblicare tali modifiche?">
+Sì, poiché stai modificando codice per distribuirlo ad altri, sei tenuto a pubblicare tali modifiche. Se non vuoi pubblicare le tue modifiche, puoi ottenere una licenza Organization.
+</Accordion>
+</AccordionGroup>
+
+Se hai altre domande, consulta i nostri [Termini e condizioni](https://twenty.com/terms), l'[Informativa sulla privacy](https://twenty.com/privacy-policy) e il [Trust Center](https://trust.twenty.com/). Se hai ancora domande senza risposta, inviale a [contact@twenty.com](mailto:contact@twenty.com) o tramite la chat di supporto.

packages/twenty-docs/l/it/user-guide/legal/overview.mdx

@@ -0,0 +1,12 @@
+---
+title: Legale
+description: Aspetti legali
+---
+
+Consulta le nostre [FAQ](/l/it/user-guide/legal/how-tos/legal-faq).
+
+## Link utili
+
+* [Termini e condizioni](https://twenty.com/terms)
+* [Informativa sulla privacy](https://twenty.com/privacy-policy)
+* [Trust Center](https://trust.twenty.com/)

packages/twenty-docs/l/it/user-guide/permissions-access/capabilities/permissions.mdx

@@ -0,0 +1,213 @@
+---
+title: Permessi
+description: Controlla l'accesso a oggetti, campi e impostazioni con permessi basati sui ruoli.
+---
+
+Il sistema di permessi di Twenty ti consente di controllare l'accesso a tre aree principali:
+
+* **Oggetti e Campi**: Controlla chi può visualizzare, modificare o eliminare i record e i singoli campi
+* **Impostazioni**: Gestisci l'accesso alla configurazione dello spazio di lavoro e alle funzioni amministrative
+* **Azioni**: Controlla le azioni generali dello spazio di lavoro come importare dati o inviare e-mail
+
+## Crea un Ruolo
+
+Per creare un nuovo ruolo:
+
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Sotto **Tutti i Ruoli**, clicca su **+ Crea Ruolo**
+3. Inserisci un nome per il ruolo
+4. Nella scheda predefinita **Permessi**, [configura i permessi](#customize-permissions)
+5. Clicca su **Salva** per concludere
+
+## Elimina un Ruolo
+
+Per eliminare un ruolo:
+
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Clicca sul ruolo che desideri rimuovere
+3. Apri la scheda **Impostazioni**, quindi clicca su **Elimina Ruolo**
+4. Clicca su **Conferma** nel modulo
+
+<Note>
+Se un ruolo viene eliminato, ogni membro dello spazio di lavoro assegnato a esso verrà automaticamente riassegnato al ruolo predefinito. Tutti i ruoli tranne il ruolo **Admin** possono essere eliminati. Deve sempre esserci almeno un membro assegnato al ruolo di **Admin**.
+</Note>
+
+## Assegna Ruoli ai Membri
+
+### Visualizza Assegnazioni Correnti
+
+* Vai a **Impostazioni → Membri → Ruoli**
+* Vedi tutti i ruoli e quanti membri sono assegnati a ciascuno
+* Visualizza quali membri hanno quali ruoli
+
+### Assegna un Ruolo a un Membro
+
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Clicca sul ruolo che vuoi assegnare
+3. Apri la scheda **Assegnazione**
+4. Clicca su **+ Assegna a membro**
+5. Seleziona il membro dello spazio di lavoro dall'elenco
+6. Conferma l'assegnazione
+
+### Imposta Ruolo Predefinito
+
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Nella sezione **Opzioni**, trova **Ruolo Predefinito**
+3. Seleziona quale ruolo i nuovi membri dovrebbero ricevere automaticamente
+4. I nuovi membri dello spazio di lavoro riceveranno questo ruolo al momento della registrazione
+
+<Note>
+Puoi assegnare ruoli solo ai membri esistenti dello spazio di lavoro. Per invitare nuovi membri, utilizza [Gestione Membri](/l/it/user-guide/settings/capabilities/member-management).
+</Note>
+
+## Personalizza Permessi
+
+I permessi determinano a cosa ogni ruolo può accedere o modificare all'interno del tuo workspace, inclusi oggetti workspace, record, impostazioni e azioni.
+
+### Permessi a livello di oggetto
+
+La sezione **Oggetti** controlla cosa può fare questo ruolo con i record in tutto il tuo spazio di lavoro.
+
+#### Imposta i permessi predefiniti (Tutti gli oggetti)
+
+Per prima cosa, configura i permessi di base che si applicano per impostazione predefinita a **tutti gli oggetti**:
+
+| Permesso                                     | Descrizione                                                           |
+| -------------------------------------------- | --------------------------------------------------------------------- |
+| **Visualizzare record su tutti gli oggetti** | Visualizza i record negli elenchi e nelle pagine di dettaglio         |
+| **Modificare record su tutti gli oggetti**   | Modifica i record esistenti                                           |
+| **Cancellare record su tutti gli oggetti**   | Elimina i record in modo non definitivo (possono essere ripristinati) |
+| **Distruggere record su tutti gli oggetti**  | Elimina definitivamente i record                                      |
+
+Seleziona o deseleziona in base a quello che dovrebbe essere il comportamento predefinito per questo ruolo.
+
+<Note>
+**Esempio — ruolo Tirocinante**: Un tirocinante dovrebbe poter vedere tutti gli oggetti ma non modificarli per impostazione predefinita. Abilita "Visualizza record su tutti gli oggetti" ma lascia "Modifica record su tutti gli oggetti" non selezionato.
+</Note>
+
+#### Aggiungi eccezioni a livello di oggetto
+
+Dopo aver impostato i valori predefiniti, usa la sottosezione **A livello di oggetto** per aggiungere regole che sostituiscono i valori predefiniti per oggetti specifici.
+
+Fai clic su **+ Aggiungi regola** e seleziona un oggetto per creare un'eccezione.
+
+**Esempi di regole per un ruolo Tirocinante:**
+
+| Regola                                         | Effetto                                                                     |
+| ---------------------------------------------- | --------------------------------------------------------------------------- |
+| Opportunities → disabilita "Visualizza record" | Il tirocinante non può vedere affatto l'oggetto Opportunities               |
+| People → abilita "Modifica record"             | Il tirocinante può modificare i record di People (ma non gli altri oggetti) |
+
+### Permessi a Livello di Riga
+
+<Note>
+I permessi a livello di riga costituiscono una **funzionalità Premium** disponibile nel piano **Organization** (Cloud e Self-Hosted).
+</Note>
+
+I permessi a livello di riga ti consentono di limitare quali singoli record un ruolo può visualizzare o modificare, in base a criteri dinamici. A differenza dei permessi a livello di oggetto (che si applicano a un intero tipo di oggetto), i permessi a livello di riga valutano ogni record in modo indipendente.
+
+**Esempi di casi d'uso:**
+
+* I rappresentanti commerciali possono vedere solo le proprie opportunità
+* I manager possono vedere tutti i record nella loro regione
+* Gli agenti di supporto possono visualizzare solo i ticket a loro assegnati
+
+Per configurare i permessi a livello di riga, apri un ruolo, vai alla scheda **Objects** e utilizza la sezione **Row-Level** per definire le condizioni di filtro per un determinato oggetto.
+
+### Permessi a livello di campo
+
+All'interno di ogni regola a livello di oggetto, puoi inoltre configurare i **permessi a livello di campo** per controllare l'accesso a campi specifici.
+
+| Permesso           | Descrizione                       |
+| ------------------ | --------------------------------- |
+| **Vedi campo**     | Visualizza il valore del campo    |
+| **Modifica campo** | Modifica il valore del campo      |
+| **Nessun accesso** | Il campo è completamente nascosto |
+
+**Esempio — Limitare i campi sensibili:**
+
+Per il ruolo Tirocinante con accesso di modifica a People, potresti voler limitare alcuni campi:
+
+* People → Email → solo **Vedi campo** (non può modificare)
+* People → Address → **Nessun accesso** (completamente nascosto)
+
+Questo consente al tirocinante di modificare la maggior parte dei campi di People proteggendo al contempo le informazioni sensibili.
+
+### Come funziona l'ereditarietà dei permessi
+
+I permessi si applicano in cascata dal globale allo specifico:
+
+1. **Tutti gli oggetti** → definisce le impostazioni di base per tutti gli oggetti
+2. **Regole a livello di oggetto** → sostituiscono le impostazioni di base per oggetti specifici
+3. **Regole a livello di campo** → sostituiscono l'impostazione dell'oggetto per campi specifici
+
+Le impostazioni più specifiche hanno sempre la precedenza.
+
+### Gestione degli Override sui Permessi
+
+Per sostituire i permessi ereditati:
+
+1. Clicca su **X** per rimuovere la regola ereditata
+2. Seleziona i permessi specifici che desideri
+3. Clicca sull'icona arancione **Annulla** (freccia circolare) per ripristinare le modifiche
+
+Al termine, clicca su **Fine**, quindi **Salva** una volta reindirizzato alla pagina del ruolo.
+
+### Permessi delle Impostazioni dello Spazio di lavoro
+
+Controlla l'accesso alle impostazioni dello spazio di lavoro in due modi:
+
+* Attiva **Accesso Completo Impostazioni** per concedere pieno accesso
+* Oppure abilita permessi specifici (ad es., generazione chiave API, preferenze dello spazio di lavoro, assegnazione ruoli, configurazione del modello di dati, impostazioni di sicurezza e gestione dei flussi di lavoro)
+
+<Note>
+**Limitazione attuale**: Per attivare manualmente i workflow è attualmente richiesto l'accesso alla gestione dei workflow. Questo comportamento potrebbe cambiare nelle versioni future.
+</Note>
+
+### Permessi per Azioni dello Spazio di lavoro
+
+Controlla l'accesso alle azioni generali dello spazio di lavoro:
+
+* Attiva **Accesso Completo all'Applicazione** per concedere pieni permessi
+* Oppure abilita azioni individuali come **Invia Email**, **Importa CSV** e **Esporta CSV**
+
+## Assegna ruoli alle chiavi API e agli agenti AI
+
+Oltre ai membri dello spazio di lavoro, i ruoli possono essere assegnati anche alle **Chiavi API** e agli **Agenti IA**. Questo è particolarmente utile per i team che vogliono controllare esattamente "chi" può fare cosa nel loro spazio di lavoro, inclusi i processi automatizzati e le integrazioni.
+
+### Perché assegnare ruoli a chiavi API e Agenti IA?
+
+* **Sicurezza**: Limita ciò a cui i processi automatizzati possono accedere o che possono modificare
+* **Conformità**: Garantisci che le integrazioni accedano solo ai dati di cui hanno bisogno
+* **Controllo**: Previeni modifiche accidentali ai dati dovute ad automazioni configurate in modo errato
+* **Auditabilità**: Tieni traccia di quali azioni sono state eseguite da quale integrazione o agente
+
+### Assegna un ruolo a una chiave API
+
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Clicca sul ruolo che vuoi assegnare
+3. Apri la scheda **Assegnazione**
+4. In **Chiavi API**, fai clic su **+ Assegna a chiave API**
+5. Seleziona la chiave API dall'elenco
+6. Conferma l'assegnazione
+
+La chiave API erediterà ora tutti i permessi definiti da quel ruolo. Qualsiasi chiamata API effettuata con questa chiave sarà limitata di conseguenza.
+
+<Note>
+Le chiavi API senza un ruolo assegnato utilizzano i permessi predefiniti. Per una sicurezza maggiore, assegna sempre un ruolo specifico alle chiavi API di produzione.
+</Note>
+
+### Assegna un ruolo a un Agente IA
+
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Clicca sul ruolo che vuoi assegnare
+3. Apri la scheda **Assegnazione**
+4. In **Agenti IA**, fai clic su **+ Assegna ad agente IA**
+5. Seleziona l'agente IA dall'elenco
+6. Conferma l'assegnazione
+
+L'agente IA potrà accedere ai dati ed eseguire solo le azioni consentite dal ruolo assegnato.
+
+<Note>
+Per gli agenti IA in esecuzione all'interno dei workflow, questo garantisce che l'agente non possa accedere o modificare dati al di fuori dell'ambito previsto, anche se il workflow dispone di permessi più ampi.
+</Note>

packages/twenty-docs/l/it/user-guide/permissions-access/capabilities/sso-configuration.mdx

@@ -0,0 +1,125 @@
+---
+title: Configurazione SSO
+description: Configura il Single Sign-On per un'autenticazione aziendale sicura.
+---
+
+## Informazioni su SSO
+
+Il Single Sign-On (SSO) consente ai membri del tuo team di accedere a Twenty utilizzando il provider di identità della tua organizzazione. Questo offre:
+
+* **Controllo degli accessi centralizzato**: Gestisci gli accessi da un unico punto
+* **Sicurezza avanzata**: Sfrutta i tuoi criteri di sicurezza esistenti
+* **Migliore esperienza utente**: Un unico set di credenziali per tutti gli strumenti
+
+## Provider supportati
+
+Twenty supporta l'SSO con:
+
+* **SAML 2.0**: Funziona con la maggior parte dei provider di identità aziendali
+* **Google Workspace**: Per le organizzazioni che usano Google
+* **Microsoft Entra ID** (ex Azure AD): Per ambienti Microsoft
+
+## Configurazione dell'SSO
+
+### Prerequisiti
+
+* Piano Organization (spazi di lavoro cloud e self-hosted)
+* Accesso amministratore al tuo provider di identità
+* Accesso amministratore al tuo spazio di lavoro Twenty
+
+### Passaggi di configurazione
+
+#### 1. Accedi alle impostazioni dell'SSO
+
+1. Vai a **Impostazioni → Sicurezza**
+2. Trova la sezione **Configurazione SSO**
+3. Fai clic su **Configura SSO**
+
+#### 2) Scegli il tuo provider
+
+Seleziona il tuo provider di identità dall'elenco oppure scegli "Custom SAML" per altri provider.
+
+#### 3. Configura il tuo provider di identità
+
+Dovrai configurare il tuo provider di identità con:
+
+* **Entity ID**: Fornito da Twenty
+* **ACS URL**: L'URL di callback per l'autenticazione
+* **Certificate**: Per una comunicazione sicura
+
+#### 4. Inserisci i dettagli del provider in Twenty
+
+* **SSO URL**: URL di accesso fornito dal tuo provider
+* **Entity ID**: L'identificatore del tuo provider
+* **Certificate**: Certificato X.509 del tuo provider
+
+#### 5. Test e abilitazione
+
+1. Fai clic su **Test Configuration** per verificare la configurazione
+2. Abilita l'SSO quando il test ha esito positivo
+3. Configura le preferenze di provisioning degli utenti
+
+## Provisioning degli utenti
+
+### Provisioning Just-in-Time (JIT)
+
+* Gli utenti vengono creati automaticamente al primo accesso
+* Agli utenti viene assegnato un ruolo predefinito automaticamente
+* Non è necessaria la creazione manuale degli utenti
+
+### Provisioning manuale
+
+* Invita gli utenti prima che possano accedere
+* Preassegna ruoli specifici
+* Più controllo su chi può accedere allo spazio di lavoro
+
+## Gestione degli utenti SSO
+
+### Assegnazione dei ruoli
+
+Agli utenti SSO possono essere assegnati ruoli come agli utenti normali:
+
+1. Vai a **Impostazioni → Membri**
+2. Trova l'utente
+3. Modifica il loro ruolo secondo necessità
+
+### Revoca dell'accesso
+
+Per rimuovere l'accesso per gli utenti SSO:
+
+* Rimuovili dal tuo provider di identità oppure
+* Rimuovili dallo spazio di lavoro Twenty
+
+## Migliori Pratiche
+
+### Sicurezza
+
+* **Richiedi SSO**: Disabilita l'accesso con password per gli utenti SSO
+* **Audit periodici**: Riesamina periodicamente gli accessi
+* **Policy IdP rigorose**: Applica l'MFA nel provider di identità
+
+### Gestione utenti
+
+* **Nomenclatura chiara**: Usa una nomenclatura coerente con la tua directory
+* **Mappatura dei gruppi**: Mappa i gruppi IdP ai ruoli di Twenty (se disponibile)
+* **Processo di offboarding**: Includi Twenty nel tuo flusso di lavoro di deprovisioning
+
+## Risoluzione dei problemi
+
+### Problemi comuni
+
+* **Errori del certificato**: Assicurati che il certificato non sia scaduto
+* **URL non corrisponde**: Verificare che l'URL ACS corrisponda esattamente
+* **Utente non trovato**: Controlla le impostazioni del provisioning JIT
+
+### Ottenere aiuto
+
+Se riscontri problemi, contatta l'assistenza fornendo:
+
+* Messaggi di errore ricevuti
+* Provider di identità utilizzato
+* Dettagli di configurazione (senza dati sensibili)
+
+<Tip>
+Hai bisogno di configurare l’SSO per la tua organizzazione? [Trova un partner Twenty certificato](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-sso) specializzato in SSO e configurazione dell’identità. *(Preferisci coinvolgere direttamente Twenty? [contact@twenty.com](mailto:contact@twenty.com))*
+</Tip>

packages/twenty-docs/l/it/user-guide/permissions-access/how-tos/permissions-faq.mdx

@@ -0,0 +1,120 @@
+---
+title: Domande frequenti sui permessi
+description: Domande frequenti su ruoli e permessi.
+---
+
+## Ruoli
+
+<AccordionGroup>
+<Accordion title="Quali ruoli sono inclusi in Twenty per impostazione predefinita?">
+Venti vengono forniti con i ruoli **Admin** e **Membro** per impostazione predefinita. Puoi creare ulteriori ruoli personalizzati in base alle esigenze del tuo team (ad es., Addetto alle vendite, Manager, Utente in sola lettura).
+</Accordion>
+
+<Accordion title="Posso eliminare il ruolo Admin?">
+No, il ruolo Admin non può essere eliminato. Deve sempre esserci almeno un membro assegnato al ruolo Admin.
+</Accordion>
+
+<Accordion title="Cosa succede quando elimino un ruolo?">
+Ogni membro dell'area di lavoro assegnato a quel ruolo verrà automaticamente riassegnato al ruolo predefinito.
+</Accordion>
+
+<Accordion title="Come imposto un ruolo predefinito per i nuovi membri?">
+Vai su **Impostazioni → Membri → Ruoli**, trova l'opzione **Ruolo predefinito** e seleziona quale ruolo i nuovi membri devono ricevere automaticamente quando si uniscono.
+</Accordion>
+
+<Accordion title="Posso assegnare più ruoli a un utente?">
+No, ogni utente può avere un solo ruolo alla volta. Crea un ruolo personalizzato se hai bisogno di una combinazione di permessi.
+</Accordion>
+</AccordionGroup>
+
+## Permessi
+
+<AccordionGroup>
+<Accordion title="Qual è la differenza tra permessi sugli oggetti e permessi sui campi?">
+* **Permessi sugli oggetti**: Controllano l'accesso ai record interi (ad es., possono vedere/modificare/eliminare i record di Persone)
+* **Permessi sui campi**: Controllano l'accesso ai campi specifici all'interno di un oggetto (ad es., possono vedere ma non modificare il campo Stipendio)
+
+I permessi sui campi consentono un controllo più granulare sui dati sensibili.
+</Accordion>
+
+<Accordion title="Come funzionano le sovrascritture dei permessi?">
+I permessi si applicano in cascata dal globale allo specifico:
+1. **Tutti gli oggetti** definisce le impostazioni di base per tutti gli oggetti
+2. **Permessi a livello di oggetto** possono sostituire l'impostazione globale per oggetti specifici
+3. **Permessi a livello di campo** possono sostituire l'impostazione dell'oggetto per campi specifici
+
+Le impostazioni più specifiche hanno sempre la precedenza.
+</Accordion>
+
+<Accordion title="Cosa significano i diversi livelli di permessi?">
+Per gli oggetti:
+* **Visualizza record**: Permette di vedere i record negli elenchi e nelle pagine dei dettagli
+* **Modifica record**: Modifica i record esistenti
+* **Elimina record**: Elimina i record in modo non definitivo (possono essere ripristinati)
+* **Elimina definitivamente i record**: Elimina i record in modo permanente
+
+Per i campi:
+* **Visualizza campo**: Visualizza il valore del campo
+* **Modifica campo**: Modifica il valore del campo
+* **Nessun accesso**: Il campo è completamente nascosto
+</Accordion>
+
+<Accordion title="Posso limitare l'accesso a record specifici (permessi a livello di riga)?">
+I permessi a livello di riga sono disponibili nel piano **Organization**. Ciò consente di limitare l'accesso a record specifici in base a criteri (ad es., vedere solo le proprie opportunità).
+</Accordion>
+
+<Accordion title="Come rendo un campo di sola lettura per determinati utenti?">
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Seleziona il ruolo
+3. Vai all'oggetto contenente il campo
+4. Imposta il permesso del campo su **Visualizza campo** (senza Modifica campo)
+</Accordion>
+</AccordionGroup>
+
+## Impostazioni e azioni
+
+<AccordionGroup>
+<Accordion title="Quali permessi relativi alle impostazioni sono disponibili?">
+Puoi controllare l'accesso a:
+* Generazione delle chiavi API
+* Preferenze dell'area di lavoro
+* Assegnazione dei ruoli
+* Configurazione del modello di dati
+* Impostazioni di sicurezza
+* Gestione dei flussi di lavoro
+
+Usa **Accesso completo alle impostazioni** per concedere pieno accesso oppure abilita permessi specifici.
+</Accordion>
+
+<Accordion title="Quali permessi relativi alle azioni sono disponibili?">
+Puoi controllare:
+* **Invia email**: Possibilità di inviare email da Twenty
+* **Importa CSV**: Possibilità di importare dati tramite CSV
+* **Esporta CSV**: Possibilità di esportare dati in CSV
+
+Usa **Accesso completo all'applicazione** per concedere tutte le azioni oppure abilita quelle specifiche.
+</Accordion>
+</AccordionGroup>
+
+## SSO
+
+<AccordionGroup>
+<Accordion title="L'SSO è disponibile in tutti i piani?">
+No, l'SSO è una funzionalità Premium disponibile solo nel piano **Organization**.
+</Accordion>
+
+<Accordion title="Quali provider di identità sono supportati?">
+Twenty supporta:
+* **SAML 2.0** (funziona con la maggior parte dei provider di identità aziendali)
+* **Google Workspace**
+* **Microsoft Entra ID** (precedentemente Azure AD)
+</Accordion>
+
+<Accordion title="Che cos'è il provisioning Just-in-Time (JIT)?">
+Con il provisioning JIT, gli account utente vengono creati automaticamente in Twenty quando qualcuno accede tramite SSO per la prima volta. Viene assegnato loro automaticamente il ruolo predefinito.
+</Accordion>
+
+<Accordion title="Posso rendere obbligatorio l'SSO per tutti gli utenti?">
+Sì, una volta configurato l'SSO, puoi disabilitare l'accesso con password per gli utenti SSO per imporre l'autenticazione tramite il tuo provider di identità.
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/it/user-guide/permissions-access/overview.mdx

@@ -0,0 +1,34 @@
+---
+title: Permessi E Accesso
+description: Gestisci ruoli, permessi e il controllo degli accessi nel tuo spazio di lavoro.
+---
+
+Il sistema di permessi di Twenty ti consente di controllare chi può accedere e modificare i dati nel tuo spazio di lavoro. Crea ruoli, assegna permessi e configura SSO per un accesso sicuro.
+
+## Cosa c'è in questa sezione
+
+<CardGroup cols={2}>
+  <Card title="Permessi" icon="lock" href="/l/it/user-guide/permissions-access/capabilities/permissions">
+    Crea ruoli e configura i permessi per oggetti, campi e impostazioni.
+  </Card>
+  <Card title="Configurazione SSO" icon="key" href="/l/it/user-guide/permissions-access/capabilities/sso-configuration">
+    Configura il Single Sign-On con il tuo provider di identità.
+  </Card>
+  <Card title="FAQ" icon="circle-question" href="/l/it/user-guide/permissions-access/how-tos/permissions-faq">
+    Domande frequenti su ruoli, permessi e SSO.
+  </Card>
+</CardGroup>
+
+## Funzionalità principali
+
+* **Accesso basato sui ruoli**: Crea ruoli personalizzati con permessi specifici
+* **Permessi sugli oggetti**: Controlla chi può visualizzare, modificare o eliminare i record
+* **Permessi sui campi**: Limita l'accesso ai campi sensibili
+* **Permessi sulle impostazioni**: Controlla l'accesso alla configurazione dello spazio di lavoro
+* **Integrazione SSO**: Configura il single sign-on per la sicurezza a livello aziendale (piano Organization)
+
+## Collegamenti rapidi
+
+* [Crea un ruolo](/l/it/user-guide/permissions-access/capabilities/permissions#create-a-role)
+* [Configura SSO](/l/it/user-guide/permissions-access/capabilities/sso-configuration)
+* [Gestisci i membri del team](/l/it/user-guide/settings/capabilities/member-management)

packages/twenty-docs/l/it/user-guide/settings/capabilities/community-settings.mdx

@@ -0,0 +1,36 @@
+---
+title: Impostazioni della Community
+description: Abilita le funzionalità di accesso anticipato in Twenty.
+---
+
+## Informazioni sulle impostazioni della Community
+
+La sezione Community consente di abilitare le funzionalità di accesso anticipato prima che siano generalmente disponibili, oltre a cercare partner di Twenty.
+
+## Funzionalità di accesso anticipato
+
+Le funzionalità di accesso anticipato sono funzionalità ancora in fase di test prima della disponibilità generale.
+
+**Attualmente in accesso anticipato:**
+
+* **Relazioni di giunzione** — Relazioni molti-a-molti
+
+### Come abilitare le funzionalità di accesso anticipato
+
+1. Vai a **Impostazioni → Community**
+2. Vai alla sezione **Funzionalità**
+3. Trova la funzionalità che desideri abilitare
+4. Attivala
+5. La funzionalità sarà disponibile immediatamente
+
+<Note>
+Le funzionalità di accesso anticipato possono cambiare in base al feedback degli utenti. Il tuo contributo ci aiuta a migliorare Twenty!
+</Note>
+
+## Feedback sulle funzionalità
+
+Il tuo feedback aiuta a migliorare Twenty:
+
+* Segnala problemi con le funzionalità di accesso anticipato
+* Condividi come stai utilizzando le nuove funzionalità
+* Suggerisci miglioramenti tramite il [Discord della community](https://discord.gg/cx5n4Jzs57)

packages/twenty-docs/l/it/user-guide/settings/capabilities/domains-settings.mdx

@@ -0,0 +1,52 @@
+---
+title: Impostazioni del dominio
+description: Configura il dominio dello spazio di lavoro, i domini di accesso approvati e i domini personalizzati dell'app.
+---
+
+Le impostazioni di dominio si trovano in tre posizioni, a seconda di ciò che stai configurando.
+
+## Dominio del workspace
+
+Configurare sotto **Impostazioni → Generale**.
+
+Modifica il nome del sottodominio o imposta un dominio personalizzato per il tuo spazio di lavoro.
+
+### Personalizza dominio
+
+1. Clicca su **Sottodominio** per modificare il sottodominio (ad es. `yourcompany.twenty.com`)
+2. Oppure clicca su **Dominio personalizzato** per impostare un dominio personalizzato (ad esempio, `crm.yourcompany.com`)
+
+Per i domini personalizzati, dovrai configurare le impostazioni DNS con il tuo provider del dominio.
+
+## Domini approvati
+
+Configura in **Impostazioni → Membri → Invita**.
+
+Aggiungi il tuo dominio aziendale per consentire ai membri del team di iscriversi automaticamente a questo workspace.
+
+### Aggiungi dominio di accesso approvato
+
+1. Fai clic su **Aggiungi dominio di accesso approvato**
+2. Inserisci il dominio della tua azienda (ad es., `yourcompany.com`)
+3. Salva
+
+Una volta configurato, chiunque abbia un indirizzo email su quel dominio può unirsi al tuo spazio di lavoro senza bisogno di un invito diretto.
+
+<Note>
+Questo è utile per consentire a tutto il tuo team di registrarsi autonomamente, mantenendo lo spazio di lavoro limitato alla tua organizzazione.
+</Note>
+
+## Domini personalizzati dell'app
+
+Configura in **Impostazioni → App → la tua app → Impostazioni → URL dell'app**.
+
+Le app che espongono route sul web vengono servite da un URL dedicato, mostrato nella sezione **URL dell'app**. Puoi invece servire un'app da un dominio di tua proprietà.
+
+### Aggiungi dominio personalizzato
+
+1. Clicca Su **Dominio Personalizzato**
+2. Inserisci il dominio che vuoi usare (ad es., `app.yourcompany.com`)
+3. Configura le impostazioni DNS come indicato
+4. Verifica il dominio
+
+Solo le route di quell'app sono raggiungibili sul dominio. I certificati SSL vengono emessi automaticamente.

packages/twenty-docs/l/it/user-guide/settings/capabilities/experience-settings.mdx

@@ -0,0 +1,38 @@
+---
+title: Impostazioni esperienza
+description: Personalizza il tema della tua interfaccia e le preferenze regionali.
+---
+
+Personalizza la tua esperienza con Twenty in **Impostazioni → Esperienza**.
+
+## Aspetto
+
+Scegli il tema visivo:
+
+* **Chiaro**: Interfaccia pulita e luminosa
+* **Scuro**: Più facile per gli occhi in condizioni di scarsa illuminazione
+* **Impostazioni di sistema**: Si adatta automaticamente al tema del tuo dispositivo
+
+## Lingua
+
+Seleziona la lingua preferita per l'interfaccia Twenty dal menu a discesa.
+
+## Formati
+
+Configura data, ora, numero, fuso orario e giorno di inizio del calendario.
+
+| Impostazione                       | Descrizione                                                       |
+| ---------------------------------- | ----------------------------------------------------------------- |
+| **Fuso orario**                    | Il tuo fuso orario locale per timestamp e pianificazione accurati |
+| **Formato della data**             | Come vengono visualizzate le date (ad es. 12 dic 2025)            |
+| **Formato dell'ora**               | Formato a 12 ore (7:22 PM) o a 24 ore                             |
+| **Formato numerico**               | Separatori decimali e delle migliaia (ad es. 1.234,56)            |
+| **Giorno iniziale del calendario** | Primo giorno della settimana (domenica o lunedì)                  |
+
+Ogni impostazione può essere impostata su **Impostazioni di sistema** per adattarsi automaticamente alle preferenze del tuo dispositivo, oppure puoi scegliere un formato specifico.
+
+## Come aggiornare
+
+1. Vai a **Impostazioni → Esperienza**
+2. Regola le tue preferenze in ogni sezione
+3. Le modifiche vengono salvate automaticamente

packages/twenty-docs/l/it/user-guide/settings/capabilities/member-management.mdx

@@ -0,0 +1,86 @@
+---
+title: Gestione dei Membri
+description: Invita i membri del team e gestisci l'accesso allo spazio di lavoro.
+---
+
+Gestisci chi ha accesso al tuo spazio di lavoro in **Impostazioni → Membri**.
+
+## Invita Nuovi Membri
+
+### Utilizzo dell'invito via email
+
+1. Vai a **Impostazioni → Membri → Invita**
+2. Fai clic su **+ Invita**
+3. Inserisci l'indirizzo email della persona
+4. Seleziona un ruolo per il nuovo membro
+5. Fai clic su **Invia invito**
+
+La persona invitata riceverà un'email con un link per unirsi al tuo spazio di lavoro.
+
+### Utilizzo del link di invito
+
+1. Vai a **Impostazioni → Membri → Invita**
+2. Copia il link di invito allo spazio di lavoro
+3. Condividi il link con i nuovi membri del team
+4. Riceveranno accesso una volta registrati
+
+## Visualizza e gestisci i membri
+
+### Visualizza tutti i membri
+
+Vai a **Impostazioni → Membri → Team** per vedere tutti i membri attivi
+
+Vai a **Impostazioni → Membri → Invito** per vedere gli inviti in sospeso
+
+### Modifica il profilo di un membro
+
+Fai clic su un membro per aprire la sua pagina del profilo. Come amministratore, puoi:
+
+* Modifica il **nome**
+* Aggiorna la **foto del profilo**
+* **Impersona** il loro account (utile per la risoluzione dei problemi)
+* **Elimina** il loro account
+
+### Modifica il ruolo di un membro
+
+Nella pagina del profilo del membro:
+
+1. Apri la scheda **Autorizzazioni**
+2. Visualizza il ruolo attualmente assegnato
+3. Seleziona un ruolo diverso dall'elenco a discesa
+4. La modifica ha effetto immediato
+
+→ [Scopri di più su ruoli e autorizzazioni](/l/it/user-guide/permissions-access/capabilities/permissions)
+
+### Rimuovi un membro
+
+1. Fai clic sul membro per aprire il suo profilo
+2. Clicca su **Elimina account** per rimuoverli dal workspace
+
+<Warning>
+I membri rimossi perdono immediatamente l'accesso. I loro dati (record, note, attività) rimangono nello spazio di lavoro.
+</Warning>
+
+<Note>
+Le email e gli eventi di calendario del membro cancellato sono archiviati e disponibili per gli altri membri.
+</Note>
+
+## Inviti in sospeso
+
+Gestisci gli inviti non ancora accettati:
+
+* **Reinvia**: Invia nuovamente l'email di invito
+* **Annulla**: Revoca l'invito prima che venga accettato
+
+## Domini di Accesso Approvati
+
+Consenti ai membri del team di unirsi automaticamente in base al loro dominio email:
+
+1. Vai a **Impostazioni → Membri → Invita**
+2. Aggiungi il dominio della tua azienda (ad es., `yourcompany.com`)
+3. Chiunque con quel dominio email può unirsi senza invito
+
+## Correlati
+
+* [Autorizzazioni](/l/it/user-guide/permissions-access/capabilities/permissions) — configura ciò che ogni ruolo può fare
+* [Impostazioni dominio](/l/it/user-guide/settings/capabilities/domains-settings) — configurare i domini approvati

packages/twenty-docs/l/it/user-guide/settings/capabilities/profile-settings.mdx

@@ -0,0 +1,43 @@
+---
+title: Impostazioni del profilo
+description: Gestisci il tuo profilo personale e le impostazioni di sicurezza.
+---
+
+## Informazioni Personali
+
+### Nome e Email
+
+* **Nome Visualizzato**: Aggiorna come appare il tuo nome agli altri membri del workspace
+* **Indirizzo Email**: Cambia la tua email di login (richiede verifica)
+* **Immagine del Profilo**: Carica un avatar personalizzato o usa le tue iniziali
+
+## Impostazioni di Sicurezza
+
+### Autenticazione a Due Fattori (2FA)
+
+Abilita 2FA per aggiungere un livello extra di sicurezza al tuo account:
+
+1. Vai a **Impostazioni → Profilo**
+2. Fai clic su **App di autenticazione**
+3. Scansiona il codice QR con la tua app di autenticazione
+4. Inserisci il codice di verifica per confermare
+
+### Gestione delle Password
+
+* **Cambia Password**: Aggiorna la tua password attuale
+* **Requisiti della Password**: Deve avere almeno 8 caratteri
+
+## Gestione del Profilo
+
+### Elimina Account
+
+<Warning>
+Eliminare il tuo account rimuoverà permanentemente il tuo accesso a tutti i workspace. Questa azione non può essere annullata. Perderai l'accesso a tutti gli spazi di lavoro in cui sei membro. Se vuoi solo uscire da determinati team, valuta invece di abbandonare i singoli spazi di lavoro.
+</Warning>
+
+Per eliminare il tuo account:
+
+1. Vai a **Impostazioni → Profilo**
+2. Scorri fino a **Zona di Pericolo**
+3. Clicca **Elimina Account**
+4. Conferma digitando il tuo indirizzo email

packages/twenty-docs/l/it/user-guide/settings/capabilities/workspace-settings.mdx

@@ -0,0 +1,30 @@
+---
+title: Impostazioni del workspace
+description: Personalizza il tuo nome e il branding del workspace.
+---
+
+L'immagine, il nome e le opzioni di eliminazione dello spazio di lavoro sono tutte accessibili sotto **Impostazioni → Generale**.
+
+## Immagine del workspace
+
+* **Carica logo**: Aggiungi un logo personalizzato del workspace
+* **Formati supportati**: file PNG, JPEG e GIF inferiori a 10MB
+* **Rimuovi**: Elimina il logo corrente del workspace
+
+## Nome dello spazio di lavoro
+
+* **Nome**: Cambia il nome visualizzato del workspace
+* Questo nome appare a tutti i membri del workspace
+
+## Zona pericolosa
+
+<Warning>
+L'eliminazione del tuo workspace rimuove permanentemente tutti i dati e revoca immediatamente l'accesso per tutti i membri: questa azione non può essere annullata.
+</Warning>
+
+Per eliminare il tuo workspace:
+
+1. Clicca sul pulsante **Elimina workspace**
+2. Conferma l'eliminazione quando richiesto
+
+**Nota**: Solo gli amministratori del workspace possono eliminare i workspace.

packages/twenty-docs/l/it/user-guide/settings/how-tos/settings-faq.mdx

@@ -0,0 +1,171 @@
+---
+title: Impostazioni FAQ
+description: Domande frequenti sulle impostazioni di Twenty.
+---
+
+## Impostazioni del workspace
+
+<AccordionGroup>
+<Accordion title="Come faccio a cambiare il nome del mio spazio di lavoro?">
+1. Vai a **Impostazioni → Generali**
+2. Trova il campo Nome spazio di lavoro
+3. Inserisci il nuovo nome
+4. Le modifiche vengono salvate automaticamente
+</Accordion>
+
+<Accordion title="Come faccio ad aggiornare il logo del mio spazio di lavoro?">
+1. Vai a **Impostazioni → Generali**
+2. Fai clic sul logo attuale o sull'area di caricamento
+3. Seleziona un file immagine (PNG, JPEG o GIF di dimensioni inferiori a 10 MB)
+4. Il logo viene aggiornato immediatamente
+</Accordion>
+
+<Accordion title="Posso avere più spazi di lavoro?">
+Sì, puoi creare ed essere membro di più spazi di lavoro. Ogni spazio di lavoro ha i propri dati, impostazioni e abbonamento.
+</Accordion>
+
+<Accordion title="Come faccio a eliminare il mio spazio di lavoro?">
+1. Vai a **Impostazioni → Generali**
+2. Scorri fino a Zona di pericolo
+3. Fai clic su **Elimina spazio di lavoro**
+4. Conferma l'eliminazione
+
+Nota: questa operazione elimina definitivamente tutti i dati e non può essere annullata.
+</Accordion>
+
+<Accordion title="Ho creato accidentalmente più spazi di lavoro. Cosa devo fare?">
+Elimina gli spazi di lavoro di cui non hai più bisogno in **Impostazioni → Generali → Elimina spazio di lavoro**.
+
+<Warning>
+Non eliminare il tuo **account** (accessibile in Impostazioni → Profilo): il tuo account è condiviso tra tutti i tuoi spazi di lavoro. Eliminare il tuo account rimuove l'accesso a TUTTI gli spazi di lavoro.
+</Warning>
+</Accordion>
+
+<Accordion title="Come faccio a disattivare il mio spazio di lavoro senza eliminarlo?">
+Se vuoi disattivare temporaneamente il tuo spazio di lavoro (non eliminarlo definitivamente), vai a **Impostazioni → Fatturazione** e fai clic su **Annulla piano**. I tuoi dati verranno conservati per un periodo di grazia.
+</Accordion>
+</AccordionGroup>
+
+## Impostazioni del profilo
+
+<AccordionGroup>
+<Accordion title="Come faccio a cambiare la mia password?">
+1. Vai a **Impostazioni → Profilo**
+2. Trova la sezione Password
+3. Inserisci la tua password attuale
+4. Inserisci la tua nuova password
+5. Salva le modifiche
+</Accordion>
+
+<Accordion title="Come faccio ad abilitare l'autenticazione a due fattori?">
+1. Vai a **Impostazioni → Profilo**
+2. Trova la sezione 2FA
+3. Clicca **Abilita 2FA**
+4. Scansiona il codice QR con la tua app di autenticazione
+5. Inserisci il codice di verifica
+</Accordion>
+
+<Accordion title="Posso cambiare il mio indirizzo email?">
+Per modificare il tuo indirizzo email, contatta [contact@twenty.com](mailto:contact@twenty.com).
+</Accordion>
+
+<Accordion title="Come faccio a eliminare il mio account?">
+1. Vai a **Impostazioni → Profilo**
+2. Scorri fino a Zona di pericolo
+3. Clicca **Elimina Account**
+4. Conferma digitando la tua email
+
+Nota: questa operazione rimuove il tuo accesso a tutti gli spazi di lavoro ed elimina tutte le email sincronizzate dai tuoi account collegati.
+</Accordion>
+</AccordionGroup>
+
+## Impostazioni esperienza
+
+<AccordionGroup>
+<Accordion title="Come faccio a passare tra modalità chiara e scura?">
+1. Vai a **Impostazioni → Esperienza**
+2. Trova la sezione Tema
+3. Seleziona Chiaro, Scuro o Sistema
+</Accordion>
+
+<Accordion title="Come faccio a cambiare il formato della data?">
+1. Vai a **Impostazioni → Esperienza**
+2. Trova Formato data
+3. Seleziona il formato preferito
+4. Le modifiche si applicano immediatamente
+</Accordion>
+
+<Accordion title="Come faccio a cambiare il mio fuso orario?">
+1. Vai a **Impostazioni → Esperienza**
+2. Trova Fuso orario
+3. Seleziona il tuo fuso orario locale
+4. Tutti i timestamp verranno adeguati
+</Accordion>
+
+<Accordion title="Posso cambiare la lingua?">
+1. Vai a **Impostazioni → Esperienza**
+2. Trova Lingua
+3. Seleziona tra le lingue disponibili
+4. L'interfaccia si aggiorna in base alla tua selezione
+</Accordion>
+</AccordionGroup>
+
+## Impostazioni dell'account
+
+<AccordionGroup>
+<Accordion title="Come faccio a collegare il mio account email?">
+1. Vai a **Impostazioni → Account**
+2. Clicca su **Aggiungi account**
+3. Scegli Google o Microsoft
+4. Autorizza l'accesso
+5. Configura le impostazioni di sincronizzazione
+</Accordion>
+
+<Accordion title="Posso collegare più account email?">
+Sì, puoi collegare più account email. Vai a **Impostazioni → Account** e aggiungi altri account secondo necessità.
+</Accordion>
+
+<Accordion title="Come faccio a scollegare un account email?">
+1. Vai a **Impostazioni → Account**
+2. Trova l'account da rimuovere
+3. Fai clic su **Disconnetti**
+4. Conferma l'azione
+</Accordion>
+</AccordionGroup>
+
+## Domini
+
+<AccordionGroup>
+<Accordion title="Posso personalizzare il dominio del mio workspace?">
+Sì! Vai a **Impostazioni → Generali → Dominio dell'area di lavoro** e fai clic su **Personalizza dominio**. Hai due opzioni:
+
+* **Sottodominio**: usa un sottodominio di Twenty come `yourcompany.twenty.com`
+* **Dominio personalizzato**: usa il tuo dominio, ad esempio `crm.yourcompany.com` (richiede la configurazione DNS)
+
+Un sottodominio è rapido da configurare, mentre un dominio personalizzato offre un'esperienza completamente a marchio per il tuo team.
+</Accordion>
+
+<Accordion title="Come funzionano i domini di accesso approvati?">
+Puoi configurare domini di accesso approvati in modo che i membri del team con indirizzi email aziendali possano unirsi automaticamente al tuo spazio di lavoro. Vai a **Impostazioni → Membri → Invita** e aggiungi il dominio della tua azienda (ad es., `yourcompany.com`).
+</Accordion>
+</AccordionGroup>
+
+## Funzionalità di accesso anticipato
+
+<AccordionGroup>
+<Accordion title="Che cosa sono le funzionalità di accesso anticipato?">
+Le funzionalità di accesso anticipato sono funzionalità in fase di test prima della disponibilità generale.
+</Accordion>
+
+<Accordion title="Le funzionalità di accesso anticipato sono sicure da utilizzare?">
+Le funzioni di accesso anticipato sono funzionali e sicure da usare, ma possono cambiare in base al feedback dell'utente prima della disponibilità generale.
+</Accordion>
+
+<Accordion title="Come attivo le funzionalità di accesso anticipato?">
+1. Vai a **Impostazioni → Comunità**
+2. Scorri verso il basso fino alla sezione **Caratteristiche**
+3. Trova la funzionalità che ti interessa
+4. Attivala
+5. La funzionalità diventa disponibile immediatamente
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/it/user-guide/settings/overview.mdx

@@ -0,0 +1,62 @@
+---
+title: Impostazioni
+description: Configura il tuo spazio di lavoro Twenty con le configurazioni essenziali.
+---
+
+## Configurazione iniziale
+
+Quando crei per la prima volta il tuo spazio di lavoro, ci sono diverse impostazioni chiave da configurare.
+
+### Nome e logo dello spazio di lavoro
+
+1. Vai a **Impostazioni → Generali**
+2. Aggiorna il nome del tuo spazio di lavoro
+3. Carica il logo della tua azienda
+4. Salva le modifiche
+
+### Fuso orario e formato della data
+
+1. Vai a **Impostazioni → Esperienza**
+2. Seleziona il tuo fuso orario
+3. Scegli il tuo formato di data preferito
+4. Salva le modifiche
+
+## Configurazioni essenziali
+
+### Collega email e calendario
+
+Configura la sincronizzazione di email e calendario:
+
+1. Vai a **Impostazioni → Account**
+2. Clicca su **Aggiungi account**
+3. Collega il tuo account Google o Microsoft
+4. Configura le impostazioni di sincronizzazione
+
+→ [Guida completa alla configurazione di email e calendario](/l/it/user-guide/calendar-emails/overview)
+
+### Invita il tuo team
+
+Aggiungi membri del team al tuo spazio di lavoro:
+
+1. Vai a **Impostazioni → Membri**
+2. Fai clic su **+ Invita**
+3. Inserisci gli indirizzi email
+4. Assegna i ruoli appropriati
+
+<Note>
+Prima di invitare il tuo team, verifica il ruolo predefinito in **Impostazioni → Membri → Ruoli**. Ai nuovi membri viene assegnato automaticamente questo ruolo quando si uniscono.
+</Note>
+
+## Elenco di controllo delle impostazioni dello spazio di lavoro
+
+* Nome e logo dello spazio di lavoro configurati
+* Fuso orario e formato della data impostati
+* Email e calendario collegati
+* Membri del team invitati
+* Ruoli e permessi configurati
+
+## Prossimi Passi
+
+* [Impostazioni dello spazio di lavoro](/l/it/user-guide/settings/capabilities/workspace-settings)
+* [Impostazioni del profilo](/l/it/user-guide/settings/capabilities/profile-settings)
+* [Impostazioni dell'esperienza](/l/it/user-guide/settings/capabilities/experience-settings)

packages/twenty-docs/l/it/user-guide/views-pipelines/capabilities/calendar-view.mdx

@@ -0,0 +1,46 @@
+---
+title: Vista Calendario
+description: Visualizza i record con campi data su un calendario.
+---
+
+## Informazioni sulla Vista Calendario
+
+La Vista Calendario visualizza i tuoi record su un calendario in base a un campo data. Ogni record viene visualizzato come evento nella data corrispondente.
+
+<img src="/images/user-guide/views/calendar-view-zoom.png" style={{width:'100%'}} />
+
+## Creare una Vista Calendario
+
+1. Vai a un oggetto con campi data
+2. Clicca sul menu a discesa della vista → **+ Aggiungi vista**
+3. Dai un nome alla tua vista e clicca su **Crea**
+4. Apri le **Opzioni** sulla destra
+5. Seleziona **Calendario** come layout
+6. Scegli il **campo data** da usare per posizionare i record
+7. Clicca su **Aggiorna vista**
+
+## Configurare il Calendario
+
+### Scegli il campo data
+
+In **Opzioni**, seleziona quale campo data determina dove vengono visualizzati i record sul calendario.
+
+### Campi da visualizzare
+
+Configura quali campi vengono mostrati in ogni evento del calendario:
+
+1. Clicca su **Opzioni → Campi**
+2. Attiva/disattiva i campi
+3. Trascina per riordinare
+
+## Casi d'uso
+
+* **Riunioni e chiamate**: Visualizza gli appuntamenti in arrivo
+* **Scadenze**: Tieni traccia delle date di scadenza e delle date di chiusura
+* **Eventi**: Pianifica e visualizza le attività programmate
+* **Follow-up**: Vedi quando le attività scadono
+
+## Correlati
+
+* [Panoramica delle viste](/l/it/user-guide/views-pipelines/overview) — creazione e gestione delle viste
+* [Filtri e ordinamento](/l/it/user-guide/views-pipelines/capabilities/filters-and-sorting) — filtrare i dati del calendario

packages/twenty-docs/l/it/user-guide/views-pipelines/capabilities/fields-and-columns.mdx

@@ -0,0 +1,52 @@
+---
+title: Campi e colonne
+description: Scegli quali campi visualizzare e come organizzarli.
+---
+
+## Selezionare i campi da visualizzare
+
+Ogni vista può mostrare un insieme di campi diverso. Personalizza ciò che è visibile per concentrarti sulle informazioni importanti.
+
+### Mostrare o nascondere i campi
+
+1. Fai clic su **Opzioni** in alto a destra
+2. Fai clic su **Campi**
+3. Fai clic sull'**icona a forma di occhio** accanto a ogni campo per mostrarlo/nasconderlo
+
+### Riordinare i campi
+
+Modifica l'ordine in cui i campi vengono visualizzati nella vista:
+
+1. Fai clic su **Opzioni → Campi**
+2. Trascina i campi in alto o in basso
+3. Le modifiche vengono salvate automaticamente
+
+## Visualizzazione dei campi per tipo di vista
+
+### Viste della tabella
+
+* I campi vengono visualizzati come colonne
+* Ridimensiona le colonne trascinando i bordi
+
+### Viste Kanban
+
+* I campi compaiono sulle schede
+* Riordina tramite Opzioni → Campi
+* Usa la vista compatta per nascondere tutti i campi
+
+### Viste calendario
+
+* I campi selezionati vengono mostrati negli eventi del calendario
+* Configura tramite Opzioni → Campi
+
+## Migliori Pratiche
+
+* **Mostra solo ciò che è necessario** — troppi campi ingombrano la vista
+* **Metti i campi importanti per primi** — le colonne più utilizzate a sinistra
+* **Crea più viste** — insiemi di campi diversi per scopi diversi
+* **Usa la visibilità dei campi per ogni vista** — stesso oggetto, focus diverso
+
+## Correlati
+
+* [Viste tabella](/l/it/user-guide/views-pipelines/capabilities/table-views) — funzionalità delle viste tabella
+* [Viste Kanban](/l/it/user-guide/views-pipelines/capabilities/kanban-views) — viste basate su schede

packages/twenty-docs/l/it/user-guide/views-pipelines/capabilities/filters-and-sorting.mdx

@@ -0,0 +1,78 @@
+---
+title: Filtri e ordinamento
+description: Filtra e ordina i record per trovare esattamente quello che ti serve.
+---
+
+## Filtraggio dei dati
+
+I filtri ti aiutano a concentrarti su record specifici mostrando solo quelli che corrispondono ai tuoi criteri.
+
+### Aggiunta di un filtro
+
+1. Fai clic sul pulsante **Filtro** nella barra degli strumenti
+2. Seleziona il campo su cui filtrare
+3. Scegli l'operatore (uguale a, contiene, ecc.)
+4. Inserisci il valore del filtro
+5. Fai clic su **Applica**
+
+### Operatori di filtro
+
+| Tipo di campo | Operatori disponibili                                |
+| ------------- | ---------------------------------------------------- |
+| Testo         | Uguale a, Contiene, Inizia con, Termina con, È vuoto |
+| Numero        | Uguale a, Maggiore di, Minore di, È vuoto            |
+| Data          | Uguale a, Prima di, Dopo, È vuoto                    |
+| Seleziona     | Uguale a, È uno di, È vuoto                          |
+| Checkbox      | È vero, È falso                                      |
+| Relazione     | Uguale a, È vuoto                                    |
+
+### Filtri multipli
+
+Combina più filtri per restringere i risultati:
+
+* Tutti i filtri vengono applicati con logica AND
+* Ogni filtro aggiuntivo restringe ulteriormente i risultati
+
+### Rimozione dei filtri
+
+* Fai clic sulla **X** sui singoli chip del filtro
+* Fai clic su **Cancella tutto** per rimuovere tutti i filtri
+
+## Ordinamento dei dati
+
+L'ordinamento determina l'ordine in cui vengono visualizzati i record.
+
+### Aggiunta di un ordinamento
+
+1. Fai clic sul pulsante **Ordina** nella barra degli strumenti
+2. Seleziona il campo su cui ordinare
+3. Scegli crescente (A-Z, 0-9) o decrescente (Z-A, 9-0)
+4. Fai clic su **Applica**
+
+### Più ordinamenti
+
+Aggiungi più livelli di ordinamento:
+
+* Il primo ordinamento è quello principale
+* Gli ordinamenti successivi si applicano all'interno di gruppi di valori uguali
+
+### Ordinamento rapido per colonna
+
+Fai clic sull'intestazione di una colonna per ordinare:
+
+* Primo clic: Crescente
+* Secondo clic: Decrescente
+* Terzo clic: Rimuovi ordinamento
+
+## Salvataggio delle impostazioni di filtro e ordinamento
+
+Filtri e ordinamenti vengono salvati con la vista:
+
+1. Configura filtri e ordinamenti
+2. Fai clic su **Salva** per aggiornare la vista corrente
+3. Oppure fai clic su **Salva come nuova vista** per creare una variante
+
+## Correlati
+
+* [Viste tabella](/l/it/user-guide/views-pipelines/capabilities/table-views) — funzionalità Raggruppa per
+* [Panoramica delle viste](/l/it/user-guide/views-pipelines/overview) — creazione e gestione delle viste

packages/twenty-docs/l/it/user-guide/views-pipelines/capabilities/kanban-views.mdx

@@ -0,0 +1,98 @@
+---
+title: Viste Kanban
+description: Scopri come utilizzare le viste Kanban per visualizzare e gestire i flussi di lavoro.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Informazioni sulle viste Kanban
+
+Le viste Kanban mappano visivamente i flussi di processo, dove ogni colonna rappresenta una fase distinta e ogni scheda rappresenta un record.
+
+## Sposta le Carte tra le Fasi
+
+Puoi spostare ogni carta tra le fasi mentre attraversa il tuo flusso di lavoro facendo clic e tenendo premuto su una carta, quindi trascinandola alla fase successiva.
+
+<VimeoEmbed videoId="927888627" title="Dimostrazione video" />
+
+## Aggiungi ed elimina fasi
+
+Puoi adattare il tuo flusso di lavoro alle tue esigenze usando le fasi, ognuna delle quali rappresenta un valore in un campo Seleziona:
+
+### Aggiungi Fasi
+
+Per aggiungere una fase, accedi alle impostazioni del campo Seleziona navigando in Impostazioni > Modello dati, selezionando il tuo oggetto e quindi il campo da cui dipende la tua bacheca Kanban.
+
+<VimeoEmbed videoId="927890428" title="Dimostrazione video" />
+
+### Rimuovi Fasi
+
+Per rimuovere una fase, passa il mouse sul nome della fase o sull'icona `⋮`, fai clic su `Edit from settings` nelle impostazioni del campo Seleziona e quindi fai clic su **Elimina** accanto alla fase pertinente.
+
+## Campi da visualizzare
+
+Puoi configurare la tua bacheca Kanban per mostrare alcuni campi e nasconderne altri. Per mostrare o nascondere un campo, fai clic su **Opzioni** in alto a destra, poi su **Campi** per visualizzare l'elenco delle opzioni e fai clic sull'icona dell'occhio accanto al campo per mostrarlo o nasconderlo.
+
+Puoi anche riordinare l'ordine dei campi tenendo premuto sul nome del campo e trascinandolo dove vuoi.
+
+<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />
+
+## Vista compatta
+
+Puoi nascondere tutti i campi e ottenere una panoramica di tutti i record a colpo d'occhio. Per abilitare:
+
+1. Fai clic su **Opzioni** in alto a destra
+2. Attiva l'interruttore per **Vista compatta**
+
+<img src="/images/user-guide/kanban-views/compact-view.png" style={{width:'100%'}} />
+
+## Aggregazioni per colonna
+
+Ogni colonna in una vista Kanban può mostrare in alto valori aggregati, aiutandoti a comprendere i dati a colpo d'occhio.
+
+### Aggregazioni disponibili
+
+| Aggregazione  | Descrizione                                                    |
+| ------------- | -------------------------------------------------------------- |
+| **Conteggio** | Numero di record nella colonna                                 |
+| **Somma**     | Totale di un campo numerico (ad es., importi delle trattative) |
+| **Media**     | Valore medio di un campo numerico                              |
+| **Minimo**    | Valore minimo                                                  |
+| **Massimo**   | Valore massimo                                                 |
+
+### Configurazione delle aggregazioni
+
+1. Fai clic sul numero visualizzato accanto al valore della fase, nella parte superiore di una colonna
+2. Seleziona il tipo di aggregazione
+3. Scegli il campo da aggregare
+
+**Esempio:** Mostra il valore totale delle trattative per fase aggregando il campo Importo con Somma.
+
+## Quando utilizzare le viste Kanban
+
+Le viste Kanban sono ideali per:
+
+* **Pipeline di vendita**: Tieni traccia delle trattative attraverso le varie fasi, dal lead alla chiusura
+* **Gestione progetti**: Monitora le attività attraverso gli stati del flusso di lavoro
+* **Selezione del personale**: Tieni traccia dei candidati attraverso le fasi di assunzione
+* **Qualsiasi processo a fasi**: Visualizza qualsiasi flusso di lavoro con fasi definite
+
+## Migliori Pratiche
+
+### Organizza le fasi
+
+* **Limita le fasi**: 5-7 fasi sono ideali per la visibilità
+* **Nomi chiari**: Usa nomi di fasi descrittivi
+* **Ordine logico**: Disponi le fasi nell'ordine del processo
+
+### Ottimizza la visualizzazione delle schede
+
+* **Mostra i campi chiave**: Visualizza solo le informazioni più importanti
+* **Usa la vista compatta**: per panoramiche di alto livello
+* **Codifica a colori**: Usa i colori delle fasi per identificare rapidamente lo stato
+
+### Mantieni la qualità dei dati
+
+* **Aggiorna regolarmente**: Mantieni le schede in movimento tra le fasi
+* **Archivia gli elementi completati**: Sposta gli elementi chiusi fuori dalla vista attiva
+* **Rivedi le schede inattive**: Esegui un follow-up sulle schede bloccate nelle fasi

packages/twenty-docs/l/it/user-guide/views-pipelines/capabilities/table-views.mdx

@@ -0,0 +1,64 @@
+---
+title: Viste della tabella
+description: Visualizza i tuoi dati in un formato di elenco simile a un foglio di calcolo.
+---
+
+## Informazioni sulle viste della tabella
+
+Le viste tabella mostrano i record in righe con colonne personalizzabili—come un foglio di calcolo. Questo è il tipo di vista predefinito per la maggior parte degli oggetti.
+
+<img src="/images/user-guide/table-views/table-view.png" style={{width:'100%'}} />
+
+## Funzionalità
+
+### Configurazione delle colonne
+
+* Mostra o nascondi colonne (campi)
+* Ridimensiona la larghezza delle colonne
+* Riordina le colonne trascinandole
+
+### Raggruppa per un campo di tipo Select
+
+Organizza i record in gruppi comprimibili in base a un campo di tipo Select.
+
+<img src="/images/user-guide/table-views/table-group-by.png" style={{width:'100%'}} />
+
+1. Fai clic su **Opzioni**
+2. Seleziona **Raggruppa**
+3. Scegli un campo di tipo Select
+4. Configura l'ordine dei gruppi in **Opzioni → Raggruppa → Ordina**:
+   * **Alfabetico** o **Alfabetico inverso**
+   * **Ordine manuale**: trascina i gruppi sotto "Gruppi visibili" per riordinarli
+   * Fai clic sull'**icona a forma di occhio** accanto a un gruppo per nasconderlo
+
+**Casi di utilizzo:**
+
+* Raggruppa società per tipo
+* Raggruppa Opportunità per fase
+* Raggruppa Attività per stato
+
+<Note>
+**Per prestazioni ottimali, limita a 10-15 gruppi visibili per vista.** Se ti servono più gruppi, prendi in considerazione l'uso di una Dashboard.
+</Note>
+
+### Larghezza delle colonne
+
+Ridimensiona le colonne per mostrare più o meno contenuto:
+
+1. Posiziona il puntatore tra due intestazioni di colonna
+2. Fai clic e trascina il bordo della colonna
+3. Rilascia per impostare la nuova larghezza
+
+## Quando utilizzare le viste tabella
+
+Le viste tabella sono ideali per:
+
+* **Esplorare set di dati di grandi dimensioni** — scorrere rapidamente molti record
+* **Inserimento dati** — modificare più record in modo efficiente
+* **Analisi dettagliata** — vedere molti campi contemporaneamente
+* **Ordinamento e filtraggio** — trovare record specifici
+
+## Correlati
+
+* [Campi e colonne](/l/it/user-guide/views-pipelines/capabilities/fields-and-columns) — configurazione dei campi da visualizzare
+* [Filtri e ordinamento](/l/it/user-guide/views-pipelines/capabilities/filters-and-sorting) — restringere l'elenco dei record

packages/twenty-docs/l/it/user-guide/views-pipelines/capabilities/view-settings.mdx

@@ -0,0 +1,74 @@
+---
+title: Impostazioni della vista
+description: Gestisci la visibilità, i nomi, le icone e l'organizzazione delle viste.
+---
+
+## Visibilità delle viste
+
+Controlla chi può vedere le tue viste personalizzate.
+
+### Opzioni di visibilità
+
+| Impostazione      | Chi può vedere                        |
+| ----------------- | ------------------------------------- |
+| **Workspace**     | Tutti i membri dello spazio di lavoro |
+| **Non in elenco** | Solo tu                               |
+
+### Modificare la visibilità
+
+1. Apri la vista
+2. Fai clic su **Opzioni → Visibilità**
+3. Seleziona **Workspace** o **Non in elenco**
+
+<Note>
+Le viste predefinite "All [Object Name]" non possono avere la visibilità modificata.
+</Note>
+
+## Rinominare una vista
+
+1. Apri il menu a discesa della vista
+2. Fai clic sul menu **⋮** accanto alla vista
+3. Seleziona **Modifica**
+4. Inserisci il nuovo nome
+
+## Modificare l'icona della vista
+
+1. Apri il menu a discesa della vista
+2. Fai clic sul menu **⋮** accanto alla vista
+3. Seleziona **Modifica**
+4. Fai clic sull'icona per modificarla
+
+## Riordinare le viste
+
+Modifica l'ordine in cui le viste compaiono nel menu a discesa:
+
+1. Apri il menu a discesa della vista
+2. Trascina le viste tramite la maniglia
+3. Rilascia nella posizione desiderata
+4. L'ordine viene salvato automaticamente
+
+## Preferisci una vista
+
+Fissa le viste usate di frequente per un accesso rapido:
+
+1. Apri il menu a discesa della vista
+2. Fai clic sul menu **⋮** accanto a una vista
+3. Seleziona **Aggiungi ai preferiti**
+
+Le viste aggiunte ai preferiti compaiono in una sezione dedicata per un accesso rapido.
+
+## Eliminare una vista
+
+1. Apri il menu a discesa della vista
+2. Fai clic sul menu **⋮** accanto alla vista
+3. Seleziona **Elimina**
+4. Conferma l'eliminazione
+
+<Warning>
+Le viste eliminate non possono essere ripristinate.
+</Warning>
+
+## Correlati
+
+* [Panoramica delle viste](/l/it/user-guide/views-pipelines/overview) — creazione delle viste
+* [Come limitare l'accesso](/l/it/user-guide/views-pipelines/how-tos/restrict-access-to-your-view) — guida passo passo

packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/create-a-calendar-view-for-tasks-due.mdx

@@ -0,0 +1,61 @@
+---
+title: Crea una vista Calendario per le attività in scadenza
+description: Visualizza le tue attività e le scadenze su un calendario.
+---
+
+<img src="/images/user-guide/views/calendar-view-zoom.png" style={{width:'100%'}} />
+
+## Prerequisiti
+
+Il tuo oggetto Attività necessita di un campo **Data di scadenza** (tipo Data o Data e Ora).
+
+## Passaggi
+
+1. Vai su **Attività**
+2. Clicca sul menu a discesa della vista → **+ Aggiungi vista**
+3. Dai un nome alla tua vista (ad es., "Calendario attività")
+4. Clicca **Crea**
+5. Clicca su **Opzioni** e seleziona **Calendario** come layout
+6. Scegli **Data di scadenza** come campo data
+7. Clicca su **Salva**
+
+## Configura il tuo calendario
+
+### Visualizza i campi negli eventi
+
+1. Clicca su **Opzioni → Campi**
+2. Clicca sull'**icona dell'occhio** per mostrare/nascondere i campi
+3. Trascina per riordinare
+
+Campi consigliati da visualizzare:
+
+* **Titolo** — nome dell'attività
+* **Assegnatario** — chi è responsabile
+* **Stato** — avanzamento attuale
+
+### Filtra il tuo calendario
+
+Crea viste mirate:
+
+* **Le mie attività**: Filtra per Assegnatario = Io
+* **Questa settimana**: Filtra per Data di scadenza = Questa settimana
+* **In ritardo**: Filtra per Data di scadenza < Oggi, Stato ≠ Completato
+
+## Altri casi d'uso del calendario
+
+| Oggetto               | Campo data       | Scopo                                 |
+| --------------------- | ---------------- | ------------------------------------- |
+| Opportunità           | Data di chiusura | Tieni traccia delle chiusure previste |
+| Eventi personalizzati | Data dell'evento | Pianifica le attività                 |
+| Progetti              | Scadenza         | Monitora le tempistiche dei progetti  |
+
+## Suggerimenti
+
+* **Rivedi ogni settimana**: Inizia ogni settimana controllando la vista calendario
+* **Combina con la vista tabella**: Usa il calendario per la panoramica, la tabella per i dettagli
+* **Imposta la visibilità**: Mantieni i calendari delle attività personali come Non in elenco
+
+## Correlati
+
+* [Vista calendario](/l/it/user-guide/views-pipelines/capabilities/calendar-view) — tutte le funzionalità del calendario
+* [Filtri e ordinamento](/l/it/user-guide/views-pipelines/capabilities/filters-and-sorting) — filtra il calendario

packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/create-a-kanban-view-for-projects.mdx

@@ -0,0 +1,80 @@
+---
+title: Crea una vista Kanban per i progetti
+description: Tieni traccia dei progetti nelle varie fasi utilizzando una bacheca visiva.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Usa una vista Kanban per visualizzare i tuoi progetti (o qualsiasi oggetto con fasi) come schede che si spostano tra le colonne.
+
+<VimeoEmbed videoId="927888627" title="Dimostrazione video" />
+
+## Prerequisiti
+
+Il tuo oggetto necessita di un **campo Select** da usare come colonne (ad es., Stato, Stage, Fase).
+
+Se non ne hai uno:
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona il tuo oggetto
+3. Aggiungi un campo Select con le opzioni di fase
+
+## Passaggi
+
+1. Vai al tuo oggetto (ad es., Progetti, Attività)
+2. Clicca sul menu a discesa della vista → **+ Aggiungi vista**
+3. Dai un nome alla tua vista (ad es., "Bacheca progetti")
+4. Clicca **Crea**
+5. Clicca su **Opzioni** e seleziona **Kanban** come layout
+6. La vista utilizza automaticamente il tuo campo Select per le colonne
+7. Clicca su **Salva**
+
+## Configura la tua bacheca
+
+### Mostra i campi chiave sulle schede
+
+1. Fai clic su **Opzioni → Campi**
+2. Cerca i campi nella sezione "Campi nascosti"
+3. Clicca sull'**icona dell'occhio** per visualizzarli sulle schede
+4. Trascina per riordinare
+
+<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />
+
+### Abilita vista compatta
+
+Per una panoramica di alto livello:
+
+1. Clicca su **Opzioni**
+2. Attiva **Vista compatta**
+
+Le schede mostrano solo il nome del record.
+
+<img src="/images/user-guide/kanban-views/compact-view.png" style={{width:'100%'}} />
+
+### Aggiungi aggregazioni
+
+Mostra conteggi o totali nella parte superiore di ogni colonna:
+
+1. Clicca sul numero accanto al nome di una colonna
+2. Seleziona un'aggregazione (Conteggio, Somma, ecc.)
+3. Scegli un campo, se necessario
+
+## Spostare le schede
+
+Trascina e rilascia le schede tra le colonne per aggiornarne lo stato.
+
+<VimeoEmbed videoId="927888627" title="Dimostrazione video" />
+
+## Esempio: Bacheca attività
+
+| Colonna (Stato) | Schede                    |
+| --------------- | ------------------------- |
+| **Da fare**     | Nuove attività            |
+| **In corso**    | Lavoro attivo             |
+| **Revisione**   | In attesa di approvazione |
+| **Completato**  | Completato                |
+
+## Correlati
+
+* [Viste Kanban](/l/it/user-guide/views-pipelines/capabilities/kanban-views) — aggregazioni, vista compatta, fasi
+* [Come configurare una pipeline di vendita](/l/it/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline) — Kanban per le opportunità

packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx

@@ -0,0 +1,51 @@
+---
+title: Crea una vista tabella con raggruppamento
+description: Organizza i tuoi record in gruppi comprimibili per valore di campo.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Raggruppa la vista tabella in base a un campo Selezione per organizzare i record in sezioni comprimibili.
+
+<img src="/images/user-guide/table-views/table-group-by.png" style={{width:'100%'}} />
+
+## Passaggi
+
+1. Vai all'oggetto (Persone, Aziende, ecc.)
+2. Clicca sul menu a discesa della vista → **+ Aggiungi vista**
+3. Dai un nome alla tua vista (ad es., "Aziende per tipo")
+4. Clicca **Crea**
+5. Clicca **Opzioni → Raggruppa**
+6. Scegli un campo Selezione in base al quale raggruppare
+7. Clicca su **Salva**
+
+## Configura l'ordine dei gruppi
+
+In **Opzioni → Raggruppa → Ordina**, scegli come ordinare i gruppi:
+
+| Opzione                | Descrizione                                               |
+| ---------------------- | --------------------------------------------------------- |
+| **Alfabetico**         | Da A a Z                                                  |
+| **Alfabetico inverso** | Da Z a A                                                  |
+| **Ordine manuale**     | Trascina i gruppi per riordinarli sotto "Gruppi visibili" |
+
+Clicca sull'**icona a forma di occhio** accanto a un gruppo per nasconderlo dalla vista.
+
+<Note>
+**Per prestazioni ottimali, limita a 10-15 gruppi visibili.** Se te ne servono di più, prendi in considerazione l'uso di una Dashboard.
+</Note>
+
+## Esempio: Aziende per settore
+
+1. Vai su **Aziende**
+2. Crea una nuova vista chiamata "Per settore"
+3. Clicca **Opzioni → Raggruppa**
+4. Seleziona il campo **Settore**
+5. Salva
+
+Ora le tue aziende sono organizzate per settore, rendendo facile concentrarti su un segmento alla volta.
+
+## Correlati
+
+* [Viste tabella](/l/it/user-guide/views-pipelines/capabilities/table-views) — tutte le funzionalità delle viste tabella
+* [Filtri e ordinamento](/l/it/user-guide/views-pipelines/capabilities/filters-and-sorting) — combina il raggruppamento con i filtri

packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/restrict-access-to-your-view.mdx

@@ -0,0 +1,32 @@
+---
+title: Limita l'accesso alla tua vista
+description: Controlla chi può vedere le tue visualizzazioni personalizzate.
+---
+
+Ogni visualizzazione (tranne le visualizzazioni predefinite "All [Object Name]") ha la propria impostazione di visibilità.
+
+## Passaggi
+
+1. Apri la visualizzazione a cui vuoi limitare l'accesso
+2. Fai clic su **Opzioni** in alto a destra
+3. Fai clic su **Visibilità**
+4. Seleziona **Non in elenco**
+
+La tua visualizzazione è ora visibile solo a te.
+
+## Opzioni di visibilità
+
+| Impostazione      | Chi può vedere                        |
+| ----------------- | ------------------------------------- |
+| **Workspace**     | Tutti i membri dello spazio di lavoro |
+| **Non in elenco** | Solo tu                               |
+
+## Note
+
+* Le visualizzazioni predefinite "All [Object Name]" non possono essere impostate come non in elenco
+* Le visualizzazioni non in elenco non compaiono nei menu a discesa delle visualizzazioni degli altri utenti
+* Puoi ripristinare la visibilità su Workspace in qualsiasi momento
+
+## Correlati
+
+* [Impostazioni della visualizzazione](/l/it/user-guide/views-pipelines/capabilities/view-settings) — tutte le opzioni di configurazione della visualizzazione

packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx

@@ -0,0 +1,120 @@
+---
+title: Configura una pipeline di vendita
+description: Configura la tua pipeline di vendita per tracciare le opportunità attraverso le fasi.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Una pipeline di vendita in Twenty è una vista Kanban del tuo oggetto Opportunità, in cui ogni colonna rappresenta una fase del tuo processo di vendita.
+
+## Passaggio 1: Configura le tue fasi
+
+Le fasi sono definite nel campo **Fase** dell'oggetto Opportunità.
+
+1. Vai a **Impostazioni → Modello dati**
+2. Seleziona **Opportunità**
+3. Trova e fai clic sul campo **Fase**
+4. Aggiungi, rimuovi o rinomina le fasi per allinearle al tuo processo
+
+<VimeoEmbed videoId="927890428" title="Dimostrazione video" />
+
+### Fasi consigliate
+
+| Fase               | Scopo                          |
+| ------------------ | ------------------------------ |
+| **Nuovo**          | Opportunità appena individuate |
+| **Qualificato**    | Confermate come idonee         |
+| **Incontro**       | In fase di discussione         |
+| **Proposta**       | Proposta inviata               |
+| **Negoziazione**   | Definizione dei termini        |
+| **Chiuso - Vinta** | Trattativa vinta               |
+| **Chiuso - Persa** | Trattativa persa               |
+
+<Note>
+**5-7 stadi sono ottimali.** Troppe fasi rendono difficile la scansione della pipeline; troppo poche perdono visibilità nel progresso dell'offerta.
+</Note>
+
+## Passaggio 2: Crea una vista pipeline
+
+1. Vai a **Opportunità**
+2. Clicca sul menu a discesa della vista → **+ Aggiungi vista**
+3. Chiamala "Pipeline di vendita"
+4. Clicca **Crea**
+5. Apri **Opzioni** e seleziona **Kanban** come layout
+
+La vista utilizza automaticamente il campo Fase per le colonne.
+
+## Passaggio 3: Configura la tua vista
+
+### Mostra i campi chiave
+
+1. Clicca su **Opzioni → Campi**
+2. Cerca i campi nella sezione "Campi nascosti"
+3. Clicca sull'**icona a forma di occhio** per visualizzare: Azienda, Importo, Data di chiusura, Proprietario
+
+### Abilita le aggregazioni
+
+Mostra i totali nella parte superiore di ogni colonna:
+
+1. Clicca sul numero visualizzato accanto al nome di una fase nella parte superiore di una colonna
+2. Seleziona il tipo di aggregazione (Conteggio, Somma, Media, ecc.)
+3. Scegli il campo da aggregare (ad es., Importo)
+
+**Esempio:** Mostra il valore totale delle trattative per fase aggregando il campo Importo con Somma.
+
+### Usa vista compatta (opzionale)
+
+Per una panoramica di alto livello con contenuto della scheda minimo:
+
+1. Clicca su **Opzioni**
+2. Attiva l'interruttore per **Vista compatta**
+
+## Passaggio 4: Crea viste personali e di team
+
+### "La mia pipeline"
+
+* **Filtro**: Proprietario = Io
+* **Visibilità**: Non in elenco (vista personale)
+
+### "Pipeline del team"
+
+* **Filtro**: Nessuno (mostra tutto)
+* **Visibilità**: Spazio di lavoro (vista condivisa)
+
+### "In chiusura questo mese"
+
+* **Tipo**: Tabella
+* **Filtro**: Data di chiusura = Questo mese, Fase ≠ Chiuso - Vinta, Fase ≠ Chiuso - Persa
+* **Ordina**: Data di chiusura crescente
+
+## Lavorare con le opportunità
+
+### Creazione di opportunità
+
+* Clicca su **+ Nuovo** nella vista Opportunità
+* Oppure clicca su **+** nella colonna di una specifica fase
+
+### Passare tra le fasi
+
+Trascina e rilascia le schede delle opportunità tra le colonne per aggiornarne la fase.
+
+<VimeoEmbed videoId="927888627" title="Dimostrazione video" />
+
+## Migliori Pratiche
+
+### Igiene della pipeline
+
+* Aggiorna quotidianamente le trattative man mano che avanzano
+* Sposta o chiudi tempestivamente le trattative stagnanti
+* Mantieni realistiche le date di chiusura
+
+### Disciplina delle fasi
+
+* Definisci criteri chiari per ogni fase
+* Sposta le trattative tempestivamente quando i criteri sono soddisfatti
+* Non lasciare le trattative troppo a lungo nelle fasi
+
+## Correlati
+
+* [Viste Kanban](/l/it/user-guide/views-pipelines/capabilities/kanban-views) — aggregazioni e vista compatta
+* [Filtri e ordinamento](/l/it/user-guide/views-pipelines/capabilities/filters-and-sorting) — creazione di viste filtrate

packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx

@@ -0,0 +1,149 @@
+---
+title: Mostra l"Importo previsto nella tua pipeline\
+description: Calcola e visualizza i valori delle opportunità ponderati in base alla probabilità della fase.
+---
+
+L"Importo previsto è un valore calcolato: **Importo × Probabilità**. Questo ti aiuta a prevedere i ricavi ponderando le opportunità in base alla probabilità di chiusura.
+
+<Tip>
+Questo è un esempio di creazione di [Campi formula](/l/it/user-guide/workflows/how-tos/crm-automations/formula-fields) usando i workflow.
+</Tip>
+
+Questa guida ti accompagna nella configurazione dei campi personalizzati e dei workflow necessari per calcolare e visualizzare gli importi previsti nella tua pipeline.
+
+## Passaggio 1: Crea campi personalizzati
+
+Hai bisogno di due campi personalizzati sull"oggetto Opportunità.
+
+### Crea il campo Probabilità
+
+1. Vai a **Impostazioni → Modello dati → Opportunità**
+2. Fai clic su **+ Aggiungi campo**
+3. Configura:
+   * **Nome**: Probabilità
+   * **Tipo**: Numero
+   * **Descrizione**: Probabilità basata sulla fase (0-100%)
+4. Clicca su **Salva**
+
+### Crea il campo Importo previsto
+
+1. Fai clic su **+ Aggiungi campo**
+2. Configura:
+   * **Nome**: Importo previsto
+   * **Tipo**: Valuta
+   * **Descrizione**: Calcolato: Importo × Probabilità
+3. Clicca su **Salva**
+
+### Opzionale: Imposta i campi come di sola lettura per gli utenti
+
+Se non vuoi che gli utenti modifichino manualmente questi campi calcolati:
+
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Seleziona il ruolo da configurare
+3. Trova l"oggetto Opportunità
+4. Imposta i campi **Probabilità** e **Importo previsto** come di sola lettura
+
+Questo garantisce che solo i workflow possano aggiornare questi valori.
+
+## Passaggio 2: Crea il workflow n. 1 — Aggiorna la Probabilità al cambio di fase
+
+Questo workflow imposta automaticamente la Probabilità quando un"opportunità passa a una nuova fase.
+
+### Crea il workflow
+
+1. Vai a **Workflows**
+2. Fai clic su **+ Nuovo workflow**
+3. Assegna il nome "Aggiorna la probabilità al cambio di fase"
+
+### Configura il trigger
+
+1. Aggiungi un trigger **Record creato o aggiornato**
+2. Seleziona **Opportunità** come oggetto
+3. Filtra su: il campo **Fase** è aggiornato
+
+### Aggiungi rami per ogni fase
+
+Crea un ramo per ogni fase con la relativa probabilità:
+
+| Fase           | Probabilità |
+| -------------- | ----------- |
+| Nuovo          | 10%         |
+| Qualificato    | 25%         |
+| Riunione       | 40%         |
+| Proposta       | 60%         |
+| Negoziazione   | 80%         |
+| Chiuso - Vinta | 100%        |
+| Chiuso - Persa | 0%          |
+
+<Note>
+Per creare un nuovo ramo, fai clic con il tasto destro sul canvas del workflow e fai clic su **Nuova azione**. Quindi, collega questa azione al nodo precedente trascinando la freccia dal nodo precedente a questa nuova azione.
+</Note>
+
+Per ogni fase:
+
+1. Aggiungi un nodo **Filtro**: Fase = [nome della fase]
+2. Aggiungi un"azione **Aggiorna record**:
+   * Record: l"Opportunità che ha attivato il trigger
+   * Campo: Probabilità
+   * Valore: [probabilità per quella fase]
+
+### Calcola l"Importo previsto
+
+Dopo che i rami si ricongiungono:
+
+1. Aggiungi un nodo **Filtro**: Importo non è vuoto
+2. Aggiungi un"azione **Aggiorna record**:
+   * Record: l"Opportunità che ha attivato il trigger
+   * Campo: Importo previsto
+   * Valore: Importo × Probabilità
+
+## Passaggio 3: Crea il workflow n. 2 — Ricalcola al cambio dell"Importo
+
+Questo workflow aggiorna l"Importo previsto quando l"Importo dell"opportunità cambia.
+
+### Crea il workflow
+
+1. Vai a **Workflows**
+2. Fai clic su **+ Nuovo workflow**
+3. Assegna il nome "Ricalcola l"Importo previsto al cambio dell"Importo"
+
+### Configura il trigger
+
+1. Aggiungi un trigger **Record creato o aggiornato**
+2. Seleziona **Opportunità** come oggetto
+3. Filtra su: il campo **Importo** è aggiornato
+
+### Aggiungi la logica
+
+1. Aggiungi un nodo **Filtro**: Importo non è vuoto
+2. Aggiungi un"azione **Aggiorna record**:
+   * Record: l"Opportunità che ha attivato il trigger
+   * Campo: Importo previsto
+   * Valore: Importo × Probabilità
+
+## Passaggio 4: Visualizza nella tua pipeline
+
+Ora mostra i totali dell"Importo previsto nella tua vista Kanban:
+
+1. Apri la vista Kanban della tua **Pipeline di vendita**
+2. Fai clic sul **numero** accanto al nome di qualsiasi Fase nella parte superiore di una colonna
+3. Seleziona **Somma**
+4. Scegli **Importo previsto**
+
+Ogni colonna ora mostra il valore totale ponderato della pipeline per quella fase.
+
+## Sommario
+
+| Componente                 | Scopo                                                                              |
+| -------------------------- | ---------------------------------------------------------------------------------- |
+| **Campo Probabilità**      | Memorizza la probabilità di vittoria basata sulla fase                             |
+| **Campo Importo previsto** | Memorizza Importo × Probabilità                                                    |
+| **Workflow n. 1**          | Aggiorna la Probabilità quando la Fase cambia, quindi ricalcola l"Importo previsto |
+| **Workflow n. 2**          | Ricalcola l"Importo previsto quando l"Importo cambia                               |
+| **Aggregazione**           | Mostra la somma dell"Importo previsto per fase                                     |
+
+## Correlati
+
+* [Campi formula](/l/it/user-guide/workflows/how-tos/crm-automations/formula-fields) — crea campi calcolati usando i workflow
+* [Visualizzazioni Kanban](/l/it/user-guide/views-pipelines/capabilities/kanban-views) — aggregazioni di colonna
+* [Come creare campi personalizzati](/l/it/user-guide/data-model/how-tos/create-custom-fields) — configurazione dei campi

packages/twenty-docs/l/it/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx

@@ -0,0 +1,231 @@
+---
+title: Tieni traccia di quanto a lungo le opportunità restano in ogni fase.
+description: Monitora la velocità delle trattative tenendo traccia di quando le opportunità entrano in ogni fase.
+---
+
+<Tip>
+Questo è un esempio di creazione di [Campi formula](/l/it/user-guide/workflows/how-tos/crm-automations/formula-fields) utilizzando i workflow — in particolare calcoli di date.
+</Tip>
+
+Tenere traccia di quando le opportunità entrano in ogni fase ti aiuta a identificare i colli di bottiglia e a misurare la velocità delle trattative.
+
+Questa guida ti accompagna nella configurazione di campi personalizzati e di un workflow per registrare automaticamente quando un'opportunità passa a ciascuna fase e calcolare quanti giorni ha trascorso nella fase precedente.
+
+## Passaggio 1: Crea campi personalizzati
+
+Per ogni fase servono due tipi di campi:
+
+* **Campi Data e ora**: registrano quando l'opportunità è entrata in ciascuna fase
+* **Campi Numero**: memorizzano quanti giorni l'opportunità ha trascorso in ciascuna fase
+
+### Crea i campi "Ultimo ingresso"
+
+1. Vai a **Impostazioni → Modello dati → Opportunità**
+2. Per ogni fase, fai clic su **+ Aggiungi campo** e configura:
+   * **Nome**: Ultimo ingresso in [Nome fase] (ad es., "Ultimo ingresso in Nuovo", "Ultimo ingresso in Qualificato")
+   * **Tipo**: Data e ora
+   * **Descrizione**: Timestamp dell'ingresso dell'opportunità in questa fase
+3. Clicca su **Salva**
+
+Crea questi campi:
+
+* Ultimo ingresso in Nuovo
+* Ultimo ingresso in Qualificato
+* Ultimo ingresso in Riunione
+* Ultimo ingresso in Proposta
+* Ultimo ingresso in Negoziazione
+* Ultimo ingresso in Chiuso vinto
+* Ultimo ingresso in Chiuso perso
+
+### Crea i campi "Giorni nella fase"
+
+1. Per ogni fase, fai clic su **+ Aggiungi campo** e configura:
+   * **Nome**: Giorni in [Nome fase] (ad es., "Giorni in Nuovo", "Giorni in Qualificato")
+   * **Tipo**: Numero
+   * **Descrizione**: Numero di giorni trascorsi in questa fase
+2. Clicca su **Salva**
+
+Crea questi campi:
+
+* Giorni in Nuovo
+* Giorni in Qualificato
+* Giorni in Riunione
+* Giorni in Proposta
+* Giorni in Negoziazione
+
+<Note>
+Non servono campi "Giorni in" per Chiuso vinto e Chiuso perso, poiché sono fasi finali.
+</Note>
+
+### Opzionale: rendi i campi di sola lettura
+
+Se non vuoi che gli utenti modifichino manualmente questi campi calcolati:
+
+1. Vai a **Impostazioni → Membri → Ruoli**
+2. Seleziona il ruolo da configurare
+3. Trova l'oggetto Opportunità
+4. Imposta i campi "Ultimo ingresso" e "Giorni in" come di sola lettura
+
+## Passaggio 2: Crea il workflow
+
+Questo singolo workflow gestisce entrambe le attività:
+
+* Registra il timestamp quando si entra in una nuova fase
+* Calcola i giorni trascorsi nella fase precedente
+
+### Crea il workflow
+
+1. Vai a **Workflows**
+2. Fai clic su **+ Nuovo workflow**
+3. Assegnagli il nome "Traccia tempo per fase"
+
+### Configura il trigger
+
+1. Aggiungi un trigger **Record aggiornato**
+2. Seleziona **Opportunità** come oggetto
+3. Filtro su: il campo **Fase** viene aggiornato
+
+### Aggiungi rami per ogni fase
+
+<Note>
+Per creare un nuovo ramo, fai clic con il tasto destro sul canvas del workflow e fai clic su **Nuova azione**. Quindi, collega questa azione al nodo precedente trascinando la freccia dal nodo precedente a questa nuova azione.
+</Note>
+
+---
+
+**Ramo 1: Fase = Nuovo (prima fase)**
+
+Poiché si tratta della prima fase, viene registrato solo il timestamp di ingresso: non c'è alcuna fase precedente su cui basare il calcolo.
+
+1. Aggiungi un nodo **Filtro**: Fase = Nuovo
+2. Aggiungi un'azione **Codice**:
+
+```javascript
+export const main = async (): Promise<object> => {
+  return { now: new Date().toISOString() };
+};
+```
+
+3. Aggiungi un'azione **Aggiorna record**:
+   * Record: l'Opportunità che ha attivato il workflow
+   * Campo: Ultimo ingresso in Nuovo
+   * Valore: `now` dal nodo Codice
+
+---
+
+**Ramo 2: Fase = Qualificato**
+
+Quando si passa a Qualificato, registra l'ora di ingresso E calcola i giorni trascorsi in Nuovo.
+
+1. Aggiungi un nodo **Filtro**: Fase = Qualificato
+2. Aggiungi un'azione **Codice**:
+
+```javascript
+export const main = async (params: {
+  lastEnteredPreviousStage: Date;
+}): Promise<object> => {
+  const { lastEnteredPreviousStage } = params;
+
+  const now = new Date();
+  const entryDate = new Date(lastEnteredPreviousStage);
+  const diffTime = Math.abs(now.getTime() - entryDate.getTime());
+  const daysInPreviousStage = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
+
+  return {
+    now: now.toISOString(),
+    daysInPreviousStage: daysInPreviousStage
+  };
+};
+```
+
+3. Configura l'input del nodo Codice: mappa `lastEnteredPreviousStage` al campo **Ultimo ingresso in Nuovo**
+4. Aggiungi un'azione **Aggiorna record**:
+   * Record: l'Opportunità che ha attivato il workflow
+   * Campi da aggiornare:
+     * Ultimo ingresso in Qualificato = `now`
+     * Giorni in Nuovo = `daysInPreviousStage`
+
+---
+
+**Ramo 3: Fase = Riunione**
+
+Quando si passa a Riunione, registra l'ora di ingresso E calcola i giorni trascorsi in Qualificato.
+
+1. Aggiungi un nodo **Filtro**: Fase = Riunione
+2. Aggiungi un'azione **Codice**:
+
+```javascript
+export const main = async (params: {
+  lastEnteredPreviousStage: Date;
+}): Promise<object> => {
+  const { lastEnteredPreviousStage } = params;
+
+  const now = new Date();
+  const entryDate = new Date(lastEnteredPreviousStage);
+  const diffTime = Math.abs(now.getTime() - entryDate.getTime());
+  const daysInPreviousStage = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
+
+  return {
+    now: now.toISOString(),
+    daysInPreviousStage: daysInPreviousStage
+  };
+};
+```
+
+3. Configura l'input del nodo Codice: mappa `lastEnteredPreviousStage` al campo **Ultimo ingresso in Qualificato**
+4. Aggiungi un'azione **Aggiorna record**:
+   * Record: l'Opportunità che ha attivato il workflow
+   * Campi da aggiornare:
+     * Ultimo ingresso in Riunione = `now`
+     * Giorni in Qualificato = `daysInPreviousStage`
+
+---
+
+**Continua per le fasi rimanenti:**
+
+| Fase         | Registra                        | Calcola                |
+| ------------ | ------------------------------- | ---------------------- |
+| Proposta     | Ultimo ingresso in Proposta     | Giorni in Riunione     |
+| Negoziazione | Ultimo ingresso in Negoziazione | Giorni in Proposta     |
+| Chiuso vinto | Ultimo ingresso in Chiuso vinto | Giorni in Negoziazione |
+| Chiuso perso | Ultimo ingresso in Chiuso perso | Giorni in Negoziazione |
+
+I rami non devono ricongiungersi—ognuno viene eseguito in modo indipendente quando la relativa condizione di fase è soddisfatta.
+
+## Passaggio 3: Analizza il tempo per fase
+
+Con timestamp e conteggi dei giorni registrati, ora puoi analizzare la velocità delle trattative.
+
+### Crea una vista "Trattative lente"
+
+1. Crea una vista Tabella di Opportunità
+2. Aggiungi colonne: Nome, Fase, Giorni in [fase precedente], Importo
+3. Ordina per il campo "Giorni in" (decrescente)
+4. Filtra per Fase per concentrarti su una fase alla volta
+
+Le trattative in cima hanno trascorso più tempo nella fase precedente.
+
+### Usa le aggregazioni
+
+Nella vista Kanban della pipeline:
+
+1. Fai clic sul numero accanto al nome di una Fase
+2. Seleziona **Media**
+3. Scegli un campo "Giorni in"
+
+Questo mostra il tempo medio che le trattative trascorrono in ciascuna fase.
+
+## Sommario
+
+| Componente                  | Scopo                                                                  |
+| --------------------------- | ---------------------------------------------------------------------- |
+| **Campi "Ultimo ingresso"** | Memorizzano quando l'opportunità è entrata in ciascuna fase            |
+| **Campi "Giorni in"**       | Memorizzano quanti giorni sono stati trascorsi in ciascuna fase        |
+| **Workflow**                | Registra il timestamp E calcola i giorni in un unico passaggio         |
+| **Viste e aggregazioni**    | Analizza la velocità delle trattative e individua i colli di bottiglia |
+
+## Correlati
+
+* [Workflows](/l/it/user-guide/workflows/overview) — nozioni di base sull'automazione
+* [Come creare campi personalizzati](/l/it/user-guide/data-model/how-tos/create-custom-fields) — configurazione dei campi
+* [Viste Kanban](/l/it/user-guide/views-pipelines/capabilities/kanban-views) — aggregazioni

packages/twenty-docs/l/it/user-guide/views-pipelines/overview.mdx

@@ -0,0 +1,132 @@
+---
+title: Viste e Pipeline
+description: Scopri come creare e gestire le viste in Twenty.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Comprendere le viste
+
+Le viste sono configurazioni salvate che determinano come vengono visualizzati i tuoi dati. Ogni vista può avere:
+
+* **Layout**: Tabella, Kanban o Calendario
+* **Filtri**: quali record mostrare
+* **Ordinamento**: come vengono ordinati i record
+* **Campi**: quali colonne sono visibili
+
+## Tipi di vista
+
+### Vista tabella
+
+La vista predefinita simile a un foglio di calcolo che mostra i record in righe con colonne personalizzabili.
+
+### Vista Kanban
+
+Una vista a bacheca visiva in cui i record appaiono come schede organizzate per fasi. Ideale per:
+
+* Pipeline di vendita
+* Monitoraggio dei progetti
+* Qualsiasi flusso di lavoro con fasi definite
+
+### Vista Calendario
+
+Una vista del calendario che visualizza i record con campi data. Perfetto per:
+
+* Riunioni ed eventi
+* Scadenze e date di consegna
+* Pianificazione basata sul tempo
+
+## Creare una Visualizzazione
+
+Esistono due modi per creare una nuova visualizzazione.
+
+### Usa il menu a discesa della vista
+
+1. Vai a qualsiasi oggetto (Persone, Aziende, ecc.)
+2. Fai clic sul nome della vista in alto a sinistra (mostra la vista corrente con una freccia a discesa)
+3. Fai clic su **+ Aggiungi vista**
+4. Dai un nome alla vista e fai clic su **Crea**
+5. Scegli un layout (Tabella, Kanban o Calendario) in **Opzioni**
+6. Aggiungi filtri e ordinamento secondo necessità
+7. Puoi scegliere quali campi visualizzare e riordinarli
+8. Clicca su **Salva**
+
+<VimeoEmbed videoId="1145648745" title="Dimostrazione video" />
+
+### Inizia modificando una vista esistente
+
+1. Vai a qualsiasi oggetto (Persone, Aziende, ecc.)
+2. Scegli un layout (Tabella, Kanban o Calendario) in **Opzioni** e aggiungi filtri e ordinamenti secondo le necessità
+3. Fai clic su **Salva come nuova vista**
+4. Dai un nome alla vista e fai clic su **Crea**
+5. Continua a modificare la nuova vista
+6. Fai clic su **Aggiorna vista** per salvare le configurazioni aggiuntive
+
+<VimeoEmbed videoId="1145654005" title="Dimostrazione video" />
+
+## Gestione delle viste
+
+### Modifica una vista
+
+1. Seleziona la vista dal menu a discesa
+2. Apporta le tue modifiche (filtri, ordinamento, colonne)
+3. Fai clic su **Salva** per aggiornare la vista
+
+### Rinomina una vista o cambia la sua icona
+
+1. Apri il menu a discesa della vista
+2. Fai clic sul menu **⋮** accanto al nome della vista
+3. Seleziona **Modifica**
+4. Modifica il nome o l'icona
+5. Clicca su **Salva**
+
+### Riordina le viste
+
+1. Apri il menu a discesa della vista
+2. Fai clic e trascina una vista dalla maniglia di trascinamento
+3. Rilasciala nella posizione desiderata
+4. Il nuovo ordine viene salvato automaticamente
+
+### Aggiungi ai preferiti
+
+Fissa le viste usate di frequente per un accesso rapido:
+
+1. Apri il menu a discesa della vista
+2. Fai clic sul menu **⋮** accanto a una vista
+3. Seleziona **Aggiungi ai preferiti**
+4. La vista appare nella sezione dei preferiti
+
+### Elimina una vista
+
+1. Seleziona la vista da eliminare
+2. Fai clic sul menu a discesa della vista
+3. Fai clic sul menu **⋮** accanto alla vista
+4. Seleziona **Elimina**
+5. Conferma l'eliminazione
+
+<Warning>
+Le viste eliminate non possono essere ripristinate. Assicurati di volerla rimuovere prima di confermare.
+</Warning>
+
+## Visibilità delle viste
+
+Ogni vista (eccetto le viste predefinite "Tutti [Nome oggetto]") ha la propria impostazione di visibilità.
+
+Per modificare la visibilità:
+
+1. Apri la vista
+2. Fai clic su **Opzioni → Visibilità**
+3. Scegli:
+   * **Workspace**: visibile a tutti i membri dello spazio di lavoro
+   * **Unlisted**: visibile solo a te
+
+<Note>
+La visibilità delle viste predefinite "Tutti [Nome oggetto]" non può essere modificata.
+</Note>
+
+## Prossimi Passi
+
+* [Viste tabella](/l/it/user-guide/views-pipelines/capabilities/table-views)
+* [Viste Kanban](/l/it/user-guide/views-pipelines/capabilities/kanban-views)
+* [Filtri e ordinamento](/l/it/user-guide/views-pipelines/capabilities/filters-and-sorting)
+* [Impostazioni della vista](/l/it/user-guide/views-pipelines/capabilities/view-settings)

packages/twenty-docs/l/it/user-guide/workflows/capabilities/send-emails-from-workflows.mdx

@@ -0,0 +1,167 @@
+---
+title: Invia email dai flussi di lavoro
+description: Invia automaticamente email personalizzate utilizzando le azioni dei flussi di lavoro.
+---
+
+Invia automaticamente email quando si verificano eventi specifici nel tuo CRM—dai il benvenuto ai nuovi contatti, effettua il follow-up delle opportunità o avvisa i membri del team.
+
+## Prerequisiti
+
+Prima di poter inviare email dai flussi di lavoro:
+
+1. Collega un account email in **Impostazioni → Account**
+2. Assicurati che l'account abbia le autorizzazioni di invio abilitate
+
+## Flusso di lavoro email di base
+
+### Esempio: Email di benvenuto per i nuovi contatti
+
+**Obiettivo**: Inviare un'email di benvenuto quando una nuova persona viene aggiunta al CRM.
+
+**Impostazione**:
+
+1. **Crea flusso di lavoro**: Vai su **Impostazioni → Flussi di lavoro** e fai clic su **+ Nuovo flusso di lavoro**
+
+2. **Aggiungi trigger**: Seleziona **Record creato** → **Persone**
+
+3. **Aggiungi l'azione Invia email**:
+   * Fai clic su **+** per aggiungere un'azione
+   * Seleziona **Invia email**
+   * Configura l'email:
+
+| Campo       | Valore                                 |
+| ----------- | -------------------------------------- |
+| **A**       | `{{trigger.object.email}}`             |
+| **Oggetto** | `Benvenuto in {{Your Company Name}}`   |
+| **Corpo**   | `Hi {{trigger.object.firstName}}, ...` |
+
+4. **Testa e attiva**: Esegui un test con un record di esempio, quindi attiva
+
+## Uso delle variabili nelle email
+
+Richiama i dati dai passaggi precedenti usando la sintassi `{{variable}}`:
+
+```text
+Hi {{trigger.object.firstName}},
+
+Thank you for connecting with us!
+
+Your company, {{trigger.object.company.name}}, is now in our system.
+
+Best regards,
+The Team
+```
+
+### Variabili disponibili dai trigger
+
+| Tipo di trigger              | Variabili comuni                       |
+| ---------------------------- | -------------------------------------- |
+| **Record creato/aggiornato** | `{{trigger.object.fieldName}}`         |
+| **Manuale**                  | `{{trigger.selectedRecord.fieldName}}` |
+| **Webhook**                  | `{{trigger.body.fieldName}}`           |
+
+## Avanzato: Email condizionali
+
+### Esempio: Email diverse in base all'origine del lead
+
+**Obiettivo**: Inviare email di benvenuto diverse in base alla provenienza del lead.
+
+**Impostazione**:
+
+1. **Trigger**: Record creato (Persone)
+
+2. **Aggiungi l'azione Filtro**:
+   * Condizione: `{{trigger.object.source}}` uguale a `"Website"`
+   * Se vero → continua con l'email di benvenuto per il sito web
+
+3. **Diramazione per altre origini**:
+   * Crea diramazioni parallele per origini diverse
+   * Ogni diramazione ha la propria azione Invia email
+
+## Inviare email a più destinatari
+
+### Esempio: Notifica al team quando un'opportunità viene chiusa
+
+**Obiettivo**: Inviare un'email al commerciale e al suo responsabile quando un'opportunità viene vinta.
+
+**Impostazione**:
+
+1. **Trigger**: Record aggiornato (Opportunità, Fase = "Chiusa vinta")
+
+2. **Cerca record**: Trova il responsabile del proprietario dell'opportunità
+
+3. **Invia email n. 1**: Al proprietario dell'opportunità
+   * A: `{{trigger.object.owner.email}}`
+   * Oggetto: `Congratulazioni per la chiusura di {{trigger.object.name}}!`
+
+4. **Invia email n. 2**: Al responsabile
+   * A: `{{searchRecords.manager.email}}`
+   * Oggetto: `Opportunità vinta: {{trigger.object.name}}`
+
+## Email di follow-up programmate
+
+### Esempio: Follow-up 3 giorni dopo la riunione
+
+**Obiettivo**: Inviare un'email di follow-up 3 giorni dopo la registrazione di una riunione.
+
+**Impostazione**:
+
+1. **Trigger**: Record creato (Attività, Tipo = "Riunione")
+
+2. **Azione di ritardo**: Attendi 3 giorni
+
+3. **Invia email**:
+   * A: Partecipante alla riunione
+   * Oggetto: Seguito alla nostra conversazione
+   * Corpo: Richiama i dettagli della riunione dal trigger
+
+## Allegati email
+
+Puoi allegare file alle email inviate dai flussi di lavoro. L'allegato è un file statico che carichi durante la configurazione del flusso di lavoro.
+
+### Come aggiungere un allegato
+
+1. Nell'azione **Invia email**, fai clic sul pulsante **Allegati**
+2. Fai clic per caricare un file dal tuo computer
+3. Il file verrà allegato a tutte le email inviate da questa azione
+
+### Casi d'Uso Comuni
+
+| Caso d'uso                 | File di esempio                    |
+| -------------------------- | ---------------------------------- |
+| **Email di benvenuto**     | Brochure aziendale (PDF)           |
+| **Sequenze di onboarding** | Guida per iniziare                 |
+| **Follow-up vendite**      | Catalogo prodotti o listino prezzi |
+| **Conferme degli eventi**  | Dettagli dell'evento o programma   |
+
+<Note>
+Gli allegati sono statici—lo stesso file viene inviato a tutti i destinatari. Per documenti dinamici (come i preventivi personalizzati), genera e allega i file utilizzando una [Funzione serverless](/l/it/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty).
+</Note>
+
+## Migliori Pratiche
+
+### Contenuto dell'email
+
+* Mantieni le righe dell'oggetto concise e pertinenti
+* Personalizza con il nome del destinatario
+* Includi una chiara chiamata all'azione
+* Testa le email prima di attivare
+
+### Recapito
+
+* Non inviare troppe email troppo rapidamente
+* Usa firme email professionali
+* Evita parole che attivano i filtri antispam
+* Assicurati che le email di marketing includano opzioni di disiscrizione
+
+### Risoluzione dei problemi
+
+* Verifica che l'account email sia connesso e attivo
+* Controlla che l'indirizzo email del destinatario sia valido
+* Esamina le esecuzioni dei flussi di lavoro per eventuali messaggi di errore
+* Prova prima con il tuo indirizzo email
+
+## Correlati
+
+* [Trigger dei flussi di lavoro](/l/it/user-guide/workflows/capabilities/workflow-triggers)
+* [Azioni dei flussi di lavoro](/l/it/user-guide/workflows/capabilities/workflow-actions)

packages/twenty-docs/l/it/user-guide/workflows/capabilities/use-branches-in-workflows.mdx

@@ -0,0 +1,88 @@
+---
+title: Usare le diramazioni nei flussi di lavoro
+description: Comprendi come funzionano le diramazioni e come controllare quale percorso viene eseguito.
+---
+
+## Come funzionano le diramazioni
+
+Nell'editor dei flussi di lavoro, puoi creare più percorsi (diramazioni) che partono da un singolo nodo. Questo ti consente di creare automazioni complesse con risultati diversi.
+
+**Importante**: Quando viene eseguito un flusso di lavoro, **tutte le diramazioni vengono eseguite in parallelo per impostazione predefinita**. Non esiste una logica "if/else" integrata per scegliere una diramazione rispetto a un'altra — ogni percorso verrà eseguito simultaneamente.
+
+## Controllare quale diramazione viene eseguita
+
+Per eseguire una sola diramazione in base a condizioni specifiche, **aggiungi un nodo Filtro all'inizio di ogni diramazione**.
+
+### Esempio di configurazione
+
+1. Crea il tuo flusso di lavoro con più diramazioni da un singolo nodo
+2. Aggiungi un nodo **Filtro** come primo passaggio in ogni diramazione
+3. Imposta le condizioni su ciascun Filtro per determinare quando quella diramazione deve continuare
+4. Procederanno solo le diramazioni per cui le condizioni del Filtro sono soddisfatte
+
+### Come funzionano i filtri
+
+* Se la condizione del Filtro è **soddisfatta**: la diramazione continua l'esecuzione
+* Se la condizione del Filtro **non è soddisfatta**: la diramazione si ferma al nodo Filtro
+
+Questo crea di fatto una logica condizionale in cui, in base ai tuoi dati, viene eseguita solo la diramazione appropriata.
+
+## Esempio: instradare in base al valore dell'opportunità
+
+**Scenario**: Quando un'opportunità viene chiusa, invia notifiche diverse in base al valore dell'opportunità.
+
+1. **Trigger**: Opportunità aggiornata (Fase = Chiusa vinta)
+2. **Diramazione 1**: Filtro per Importo > $10.000 → Invia un messaggio Slack a #big-deals
+3. **Diramazione 2**: Filtro per Importo ≤ $10.000 → Invia un'email al responsabile vendite
+
+Entrambe le diramazioni iniziano, ma solo quella che corrisponde all'importo dell'opportunità continuerà oltre il suo Filtro.
+
+## Creare le diramazioni
+
+<Note>
+Per creare una nuova diramazione da un passaggio esistente, fai clic sul pulsante **+** nel passaggio e aggiungi la tua azione. Puoi aggiungere più diramazioni facendo clic su **+** più volte.
+</Note>
+
+1. Nell'editor dei flussi di lavoro, seleziona il passaggio da cui vuoi creare la diramazione
+2. Fai clic su **+** per aggiungere un'azione
+3. Questo crea una diramazione
+4. Fai di nuovo clic su **+** sullo stesso passaggio per creare diramazioni aggiuntive
+5. Ogni diramazione può avere la propria sequenza di azioni
+
+## Riunire le diramazioni
+
+Dopo che le diramazioni parallele hanno completato il loro lavoro, puoi riunirle in un unico percorso:
+
+1. Completa le azioni nelle diramazioni
+2. Aggiungi un nuovo passaggio che deve essere eseguito dopo tutte le diramazioni
+3. Trascina una connessione dall'ultimo passaggio di ciascuna diramazione verso questo nuovo passaggio
+4. Il passaggio riunito attende il completamento di tutte le diramazioni collegate prima di essere eseguito
+
+### Esempio: elabora quindi notifica
+
+```
+Trigger
+   │
+   ├── Branch A: Update Customer Record
+   │
+   └── Branch B: Create Support Ticket
+
+       ↘  ↙
+
+   Merged Step: Send Confirmation Email
+```
+
+L'email di conferma viene inviata solo dopo che sia l'aggiornamento del cliente che la creazione del ticket sono stati effettuati.
+
+## Migliori Pratiche
+
+* Usa sempre i **nodi Filtro** all'inizio delle diramazioni quando desideri un'esecuzione condizionale
+* Mantieni le condizioni delle diramazioni **mutuamente esclusive** per evitare azioni duplicate
+* Testa i tuoi flussi di lavoro con dati diversi per assicurarti che vengano eseguite le diramazioni corrette
+* **Rinomina i passaggi delle diramazioni** in modo descrittivo, così è chiaro cosa fa ogni percorso
+* **Riunisci le diramazioni** quando ti serve un'azione finale dopo l'elaborazione parallela
+
+## Correlati
+
+* [Domande frequenti sui flussi di lavoro](/l/it/user-guide/workflows/how-tos/need-more-help/workflows-faq) — risposte sull'esecuzione parallela
+* [Azioni dei flussi di lavoro](/l/it/user-guide/workflows/capabilities/workflow-actions) — azioni disponibili per le diramazioni

packages/twenty-docs/l/it/user-guide/workflows/capabilities/use-iterator.mdx

@@ -0,0 +1,183 @@
+---
+title: Usare Iterator
+description: Cicla attraverso array di record per eseguire azioni su ciascun elemento.
+---
+
+Iterator consente di scorrere un array di record ed eseguire azioni su ciascuno. È essenziale per i flussi di lavoro che devono elaborare più record restituiti da Search Records o ricevuti tramite webhook.
+
+## Quando utilizzare Iterator
+
+| Scenario                                | Esempio                                      |
+| --------------------------------------- | -------------------------------------------- |
+| **Elaborare i risultati della ricerca** | Invia un'email a ciascuna persona trovata    |
+| **Gestire array di webhook**            | Crea record per ciascun elemento nell'ordine |
+| **Aggiornamenti massivi**               | Aggiorna più record con valori calcolati     |
+| **Notifiche**                           | Avvisa più persone riguardo a un evento      |
+
+## Comprendere Iterator
+
+Iterator si aspetta un **array** come input. Quindi:
+
+1. Prende il primo elemento dall'array
+2. Esegue tutte le azioni all'interno dell'Iteratore con quell'oggetto
+3. Passa all'elemento successivo
+4. Ripete finché tutti gli elementi non sono stati elaborati
+
+### Selezionare l'array su cui iterare
+
+La maggior parte delle origini di array (Search Records, un campo array di un webhook, un trigger manuale Bulk) può essere selezionata direttamente nel selettore di variabili.
+
+Quando uno step **Code** o **Logic Function** restituisce un *array di primo livello*, il relativo output viene visualizzato nel selettore di variabili come voci indicizzate (`0`, `1`, `2`, …). Per iterare sull'intero array, seleziona l'opzione **Whole list** per quello step — l'Iterator deduce quindi automaticamente la struttura di ciascun elemento dall'elenco.
+
+## Configurazione di base
+
+### Esempio: inviare un'email a tutti nei risultati della ricerca
+
+**Obiettivo**: Trovare tutti i contatti in un'azienda specifica e inviare a ciascuno un'email personalizzata.
+
+### Passaggio 1: Cerca i record
+
+1. Aggiungi un'azione **Search Records**
+2. Oggetto: **Persone**
+3. Filtro: Azienda uguale a "Acme Inc"
+4. Questo restituisce un array di persone
+
+### Passaggio 2: Verifica che i risultati esistano
+
+1. Aggiungi l'azione **Filter**
+2. Condizione: `{{searchRecords.length}}` è maggiore di 0
+3. Questo evita errori di Iterator su risultati vuoti
+
+### Passaggio 3: Aggiungi un Iterator
+
+1. Aggiungi un'azione **Iterator**
+2. Input dell'array: Seleziona `{{searchRecords}}`
+3. Questo crea un ciclo
+
+### Passaggio 4: Aggiungi azioni all'interno di Iterator
+
+Le azioni posizionate sotto Iterator vengono eseguite per ciascun elemento:
+
+1. Aggiungi azione **Invia email** (dentro Iterator)
+2. A: `{{iterator.currentItem.email}}`
+3. Oggetto: Ciao `{{iterator.currentItem.firstName}}`!
+4. Corpo: Messaggio personalizzato utilizzando i campi dell'elemento corrente
+
+### Risultato
+
+Se Search Records restituisce 5 persone, Iterator:
+
+* Invia un'email alla persona 1
+* Invia un'email alla persona 2
+* ... continua per tutte e cinque
+
+## Accedere ai dati dell'elemento corrente
+
+All'interno di Iterator, usa `{{iterator.currentItem}}` per accedere al record corrente:
+
+| Variabile                               | Descrizione                                           |
+| --------------------------------------- | ----------------------------------------------------- |
+| `{{iterator.currentItem}}`              | L'intero oggetto del record corrente                  |
+| `{{iterator.currentItem.id}}`           | ID del record                                         |
+| `{{iterator.currentItem.email}}`        | Campo email                                           |
+| `{{iterator.currentItem.company.name}}` | Nome dell'azienda correlata                           |
+| `{{iterator.index}}`                    | Posizione corrente nell'array (indice a partire da 0) |
+
+Nel selettore di variabili, puoi esplorare un campo specifico dell'elemento corrente oppure scegliere **Use the whole item** per fare riferimento all'intero elemento corrente (`{{iterator.currentItem}}`). Selezionare l'intero elemento è utile quando vuoi passare un record completo direttamente a uno step a valle invece di ricostruirlo campo per campo.
+
+## Modelli comuni
+
+### Aggiornare più record
+
+**Obiettivo**: Contrassegnare tutte le attività in ritardo come "Late"
+
+```
+1. Search Records (Tasks, Due Date < Today, Status ≠ Completed)
+2. Filter (length > 0)
+3. Iterator (searchRecords)
+   └── Update Record
+       - Object: Tasks
+       - Record: {{iterator.currentItem.id}}
+       - Status: Late
+```
+
+### Creare record da un array
+
+**Obiettivo**: Il webhook riceve un ordine con più elementi e crea un record per ciascuno
+
+```
+1. Webhook Trigger (receives items array)
+2. Filter (items.length > 0)
+3. Iterator (trigger.body.items)
+   └── Create Record
+       - Object: Order Items
+       - Name: {{iterator.currentItem.name}}
+       - Quantity: {{iterator.currentItem.qty}}
+       - Related Order: {{trigger.body.orderId}}
+```
+
+### Elaborazione condizionale all'interno del ciclo
+
+**Obiettivo**: Inviare email solo ai contatti con indirizzi email validi
+
+```
+1. Search Records (People)
+2. Iterator (searchRecords)
+   └── Filter (currentItem.email is not empty)
+       └── Send Email
+           - To: {{iterator.currentItem.email}}
+```
+
+## Risoluzione dei problemi
+
+### "Iterator expects an array"
+
+**Causa**: Hai passato un singolo record invece di un array.
+
+**Soluzione**: Assicurati di passare il risultato di Search Records o un campo di tipo array, non un singolo record.
+
+```
+✅ Correct: {{searchRecords}}
+❌ Wrong: {{searchRecords[0]}}
+```
+
+### Iterator non viene eseguito
+
+**Causa**: L'array è vuoto.
+
+**Soluzione**: Aggiungi un'azione **Filter** prima di Iterator per verificare la lunghezza dell'array:
+
+```
+Filter: {{searchRecords.length}} > 0
+```
+
+### Le azioni vengono eseguite troppe volte
+
+**Causa**: Search Records ha restituito più record del previsto.
+
+**Soluzione**:
+
+* Aggiungi filtri più specifici a Search Records
+* Imposta un limite su Search Records (massimo 200)
+* Aggiungi **Filter** all'interno di Iterator per condizioni aggiuntive
+
+## Considerazioni sulle prestazioni
+
+* **Utilizzo dei crediti**: ogni iterazione consuma crediti per le sue azioni
+* **Tempo**: gli array di grandi dimensioni richiedono più tempo per essere elaborati
+* **Limiti**: prendi in considerazione l'esecuzione in batch di operazioni molto grandi
+* **Limiti di frequenza**: le chiamate API esterne potrebbero raggiungere i limiti di frequenza con molte iterazioni
+
+## Migliori Pratiche
+
+1. **Controlla sempre la lunghezza dell'array** prima di Iterator per evitare errori
+2. **Aggiungi filtri all'interno dei cicli** quando non è necessario elaborare tutti gli elementi
+3. **Rinomina il passaggio di Iterator** per descrivere ciò su cui sta scorrendo
+4. **Esegui test con array piccoli** prima di elaborare set di dati di grandi dimensioni
+5. **Monitora le esecuzioni dei flussi di lavoro** per assicurarti che le iterazioni si completino come previsto
+
+## Correlati
+
+* [Azioni dei flussi di lavoro](/l/it/user-guide/workflows/capabilities/workflow-actions)
+* [Come utilizzare le diramazioni](/l/it/user-guide/workflows/capabilities/use-branches-in-workflows)
+* [Domande frequenti sui flussi di lavoro](/l/it/user-guide/workflows/how-tos/need-more-help/workflows-faq)

packages/twenty-docs/l/it/user-guide/workflows/capabilities/workflow-actions.mdx

@@ -0,0 +1,332 @@
+---
+title: Azioni del workflow
+description: Scopri le azioni disponibili nei workflow di Twenty.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Informazioni sulle azioni
+
+Le azioni definiscono cosa accade dopo l'attivazione di un trigger. Puoi concatenare più azioni per creare automazioni complesse.
+
+<Tip>
+* Usa il selettore di variabili (fai clic sull'icona `(x+)`) per sfogliare i dati disponibili dai passaggi precedenti
+* Passa il mouse su qualsiasi campo di input per vedere da quale passaggio proviene una variabile — utile quando lo stesso campo (ad es., ID) esiste in più passaggi precedenti
+* Assegna a ogni azione un nome descrittivo per una manutenzione più semplice
+</Tip>
+
+## Azioni sui record
+
+<img src="/images/user-guide/workflows/workflow_actions.png" style={{width:'100%'}} />
+
+### Crea Record
+
+Aggiunge un nuovo record a un oggetto selezionato.
+
+**Configurazione:**
+
+* Seleziona l'oggetto di destinazione
+* Compila i campi richiesti e opzionali
+* Usa i dati dai passaggi precedenti oppure inserisci i valori manualmente per popolare i campi
+
+**Output**: I dati del nuovo record creato sono disponibili per l'uso in passaggi successivi.
+
+### Aggiorna Record
+
+Modifica un record esistente in un oggetto selezionato.
+
+<img src="/images/user-guide/workflows/update_record.png" style={{width:'100%'}} />
+
+**Configurazione:**
+
+* Seleziona l'oggetto di destinazione
+* Scegli il record specifico da aggiornare.
+  * Puoi scegliere un record fisso, utilizzando il menu a discesa che mostra tutti i record disponibili.
+  * Oppure puoi selezionare dinamicamente il record, indicando un record trovato in un passaggio precedente, usando `(x+)`. In questa fase non è possibile cercare il record in base a criteri diversi. Se non hai ancora identificato il record, aggiungi un passaggio `Search Record` prima di questo passaggio `Update Record`.
+* Seleziona i campi da modificare e inserisci nuovi valori
+
+**Output**: I dati del record aggiornato sono disponibili per l'uso in passaggi successivi.
+
+### Elimina Record
+
+Rimuove un record da un oggetto selezionato.
+
+**Configurazione**:
+
+* Seleziona l'oggetto di destinazione
+* Scegli il record specifico da eliminare
+
+**Output**: I dati del record eliminato rimangono disponibili per l'uso in passaggi successivi.
+
+### Cerca Record
+
+Trova i record all'interno di un oggetto selezionato utilizzando condizioni di filtro.
+
+**Configurazione**:
+
+* Seleziona l'oggetto da cercare
+* Imposta criteri di filtro per restringere i risultati
+* Configura l'ordinamento e i limiti
+
+**Output**: Restituisce i record corrispondenti utilizzabili in passaggi successivi.
+
+<Note>
+**Limite**: Search Records restituisce un massimo di **200 record**. Se devi elaborarne di più, aggiungi filtri specifici per ridurre i risultati oppure usa workflow pianificati per elaborare a lotti.
+</Note>
+
+**Migliore Pratica**: Usa [rami](/l/it/user-guide/workflows/capabilities/workflow-branches) dopo Search Records per gestire scenari "trovato" vs "non trovato".
+
+### Inserisci o aggiorna Record
+
+Crea un nuovo record o aggiorna uno esistente in base ai criteri di corrispondenza. È utile quando non sei sicuro che un record esista già.
+
+<img src="/images/user-guide/workflows/upsert_double_identifier.png" style={{width:'100%'}} />
+
+**Configurazione**:
+
+* Seleziona l'oggetto di destinazione
+* Tieni presente quali campi possono essere utilizzati per la corrispondenza: email per Persone, dominio per Aziende, ID per qualsiasi oggetto o qualsiasi campo contrassegnato come Univoco. Dovrai compilare almeno uno di questi qui sotto.
+* Compila i valori dei campi. Non dimenticare di valorizzare almeno uno degli identificatori univoci.
+
+<Note>
+**La corrispondenza di solito funziona ancora meglio aggiungendo un solo identificatore univoco.** Ad esempio, lo screenshot qui sotto abbinerà le aziende in base al loro dominio. L'ID non è necessariamente richiesto.
+</Note>
+
+<img src="/images/user-guide/workflows/upsert_simple_identifier.png" style={{width:'100%'}} />
+
+* Usa dati dai passaggi precedenti per popolare i campi
+
+**Come funziona**:
+
+1. Cerca un record che corrisponde ai tuoi criteri
+2. Se trovato → aggiorna il record esistente
+3. Se non trovato → crea un nuovo record
+
+**Output**: I dati del record creato o aggiornato sono disponibili per l'uso nei passaggi successivi.
+
+## Azioni del flusso
+
+### Iteratore
+
+**Esegue un ciclo su un array di record** restituito da un passaggio precedente, consentendo di eseguire azioni su ciascun record individualmente.
+
+**Configurazione**:
+
+* Selezionare l'array di record da un passo precedente (ad esempio, risultati da record di ricerca, da un trigger manuale con disponibilità di massa, da un nodo Codice). Quando un passaggio di tipo Code o Logic Function restituisce un array di primo livello, seleziona l'opzione **Whole list** per eseguire il loop su tutto l'output.
+* Definisci le azioni da eseguire su ciascun record nel ciclo.
+
+<Note>
+- È possibile aggiungere diverse azioni all'interno di un Iterator.
+- Quando si utilizzano rami all'interno di un Iterator, assicurarsi che l'ultimo passo di ogni ramo si connetta all'Iteratore per chiudere il ciclo.
+</Note>
+
+* Accedi ai campi di `Current Item`: per utilizzare i campi del record attualmente in elaborazione, fai clic sul passaggio **Iterator**, quindi seleziona **Current item**. Verrà visualizzato l'elenco dei campi disponibili di quel record e potrai selezionarli per l'uso nelle azioni successive. Puoi anche selezionare **Use the whole item** per passare l'intero elemento corrente a un passaggio a valle.
+
+<VimeoEmbed videoId="1146577247" title="Dimostrazione video" />
+
+### Filtro
+
+Filtra i record in base a condizioni specificate, consentendo il passaggio solo ai record che soddisfano i criteri.
+
+**Configurazione**:
+
+* Seleziona il record da filtrare
+* Definisci le condizioni e i criteri di filtro
+* Configura quali record devono passare ai passaggi successivi
+
+<Note>
+1. **Output**: I nodi filtro non restituiscono dati — agiscono come porte di accesso. Se le condizioni sono soddisfatte, il flusso di lavoro continua. In caso contrario, il flusso di lavoro si interrompe in quel ramo.
+2. L'operatore `IS` può essere utilizzato con i campi numerici. Funziona come `EQUAL`.
+</Note>
+
+### Ritardo
+
+Mette in pausa l'esecuzione del flusso di lavoro per una durata specificata o fino a una data/ora specifica.
+
+**Tipi di ritardo**:
+
+| Tipo                 | Descrizione                                                                |
+| -------------------- | -------------------------------------------------------------------------- |
+| **Durata**           | Attendi per una quantità di tempo specifica (giorni, ore, minuti, secondi) |
+| **Data programmata** | Attendi fino a una data e un'ora specifiche                                |
+
+**Configurazione della durata**:
+
+* Imposta giorni, ore, minuti e/o secondi
+* Combina più unità (ad es., 2 giorni e 4 ore)
+
+**Configurazione della data programmata**:
+
+* Seleziona una data e un'ora
+* Può fare riferimento a un campo data di un passaggio precedente (ad es., follow-up 3 giorni dopo una riunione)
+
+**Casi di utilizzo**:
+
+* Attendi 24 ore prima di inviare un'email di follow-up
+* Metti in pausa fino alla data di chiusura di un'opportunità
+* Pianifica azioni per l'orario lavorativo
+
+<Note>
+La data programmata non può essere nel passato. Se viene utilizzato un campo data di un passaggio precedente e la data è già passata, il flusso di lavoro non riuscirà.
+</Note>
+
+**Limiti e crediti**:
+
+* **Nessun limite massimo di durata** — puoi impostare ritardi di minuti, giorni, settimane o oltre
+* **1 credito consumato** quando il nodo Ritardo viene eseguito, indipendentemente dalla durata
+* **Nessun credito consumato** durante l'attesa — un ritardo di 5 minuti costa come un ritardo di 5 giorni
+
+## Azioni di comunicazione
+
+### Invia email
+
+Invia un'email dal tuo flusso di lavoro. Ottimo per email di gruppo basate su modelli. Le email avranno l'aspetto di quelle inviate dalla tua casella di posta.
+Non è adatto per le newsletter (che richiedono una formattazione più ricca) o le sequenze automatiche di posta elettronica.
+
+**Prerequisiti**: Aggiungi un account email in Impostazioni → Account
+
+**Configurazione**:
+
+* Seleziona l'account email del mittente
+
+<Note>
+Puoi inviare email solo dalle caselle di posta sincronizzate con il tuo account Twenty. L'invio dalle caselle di posta di altri membri del team (ad es., l'email del proprietario dell'account) è nella roadmap.
+</Note>
+
+Per tutti i passaggi seguenti, puoi fare riferimento a variabili dei passaggi precedenti per la personalizzazione.
+
+* Inserisci l'indirizzo email del destinatario.
+
+<Note>
+Al momento è possibile un solo destinatario.
+</Note>
+
+* Imposta l'oggetto della email.
+* Componi il corpo del messaggio. È possibile formattare i collegamenti, creare liste numerate, elenchi punti puntati e aggiungere allegati.
+
+<Note>
+Al momento non è possibile aggiungere firme HTML.
+</Note>
+
+### Modulo
+
+Visualizza un modulo durante l'esecuzione del flusso di lavoro per raccogliere l'input dell'utente. Le risposte possono quindi essere utilizzate nei passaggi successivi per creare record, inviare email o eseguire qualsiasi altra azione basata sull'input.
+
+<Warning>
+**I moduli sono progettati solo per i trigger manuali**. Per i flussi di lavoro con altri trigger (Record Creato, Aggiornato, ecc.), i moduli sono accessibili solo tramite l'interfaccia di esecuzione del flusso di lavoro, il che non è l'esperienza utente prevista. Un centro di notifica sarà rilasciato nel 2026 per supportare adeguatamente i moduli nei flussi di lavoro automatizzati.
+</Warning>
+
+**Configurazione**:
+
+* Configura i campi che verranno chiesti agli utenti di compilare. Per ogni campo, scegli
+  * un tipo tra testo, numero, data, un determinato record, un campo di selezione. I campi di tutti gli oggetti sono disponibili per la selezione.
+  * un'etichetta
+  * un valore predefinito sotto `Placeholder` (opzionale)
+* Modifica il titolo del modulo
+
+**Output**: Le risposte ai moduli sono disponibili per l'uso in passaggi successivi.
+
+**Esempio**: Il flusso di lavoro "Quick Lead" è disponibile per impostazione predefinita in tutti gli spazi di lavoro, disponibile ovunque nel menu dei comandi `Cmd+K`.
+
+**Come compilare il modulo**:
+
+* Attiva il tuo flusso di lavoro manuale dal menu dei comandi `Cmd+K`
+* Compila il modulo visualizzato nel pannello laterale e fai clic su `Submit`.
+
+<Note>
+I campi non possono essere resi obbligatori.
+</Note>
+
+<VimeoEmbed videoId="1147277989" title="Dimostrazione video" />
+
+## Azioni di integrazione
+
+### Codice
+
+Esegue JavaScript personalizzato all'interno del tuo workflow.
+
+In background, ogni azione Code è supportata dalla propria **logic function**, una funzione TypeScript lato server che viene eseguita sulla piattaforma Twenty. Quando aggiungi un'azione Code, Twenty crea una logic function dedicata per quel passaggio e ne espone l'editor inline, in modo che il codice che scrivi rimanga all'interno del flusso di lavoro.
+
+**Configurazione**:
+
+* Accedi alle variabili dai passaggi precedenti. È possibile modificare i nomi delle variabili dinamicamente.
+
+<VimeoEmbed videoId="1147281795" title="Dimostrazione video" />
+
+* Scrivi il codice JavaScript nell'editor
+* Restituisci variabili per l'uso in passaggi successivi
+* Verifica il codice direttamente nel passaggio
+
+<Note>
+Se devi utilizzare chiavi API esterne nel tuo codice, devi inserirle direttamente nel corpo della funzione. Non puoi configurare le chiavi API altrove e farvi riferimento nella funzione logica.
+</Note>
+
+<Tip>
+**Lavori con gli array?** Gli array provenienti da sistemi esterni o da passaggi precedenti possono arrivare come stringhe. Vedi [Come gestire gli array nelle azioni Code](/l/it/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions) per la soluzione.
+</Tip>
+
+<Tip>
+Fai clic sull'icona quadrata in alto a destra dell'editor di codice per visualizzarlo a schermo intero — utile poiché la larghezza predefinita dell'editor è limitata.
+</Tip>
+
+#### Riutilizzare una logic function tra i flussi di lavoro
+
+L'azione Code inline è ideale per la logica "usa e getta", ma il codice che contiene appartiene a quel singolo passaggio. Quando vuoi condividere la stessa logica tra vari flussi di lavoro o mantenerla come sorgente versionata in un'app, definisci una **reusable logic function** al posto di copiare e incollare il codice in ogni azione Code.
+
+Una logic function è definita una volta in un'app (usando l'SDK `defineLogicFunction`) ed esposta al generatore di flussi di lavoro aggiungendo `workflowActionTriggerSettings`. Una volta installata l'app, quella funzione compare come azione autonoma nel generatore di flussi di lavoro, insieme alle azioni integrate. Selezionandola, vengono mostrati i campi di input che hai dichiarato (con i selettori di variabili, proprio come per le altre azioni) e viene eseguito il tuo codice condiviso, senza bisogno di JavaScript inline.
+
+|                            | Code action                                                       | Reusable logic function                                                          |
+| -------------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| **Dove risiede il codice** | Editor inline, legato a un singolo passaggio del flusso di lavoro | Definita in un'app, sottoposta a versionamento nel controllo del codice sorgente |
+| **Riutilizzo**             | Copiata e incollata per ogni passaggio                            | Aggiunta come azione in qualsiasi flusso di lavoro                               |
+| **Input**                  | Variabili collegate nell'editor                                   | Campi generati dallo schema di input dichiarato                                  |
+| **Ideale per**             | Logica rapida e specifica del flusso di lavoro                    | Logica condivisa usata in più flussi di lavoro                                   |
+
+Entrambe vengono eseguite sullo stesso runtime di logic function, quindi un'azione Code che hai prototipato inline può in seguito essere trasformata in una reusable logic function con modifiche minime.
+
+<Tip>
+Per le informazioni di riferimento destinate agli sviluppatori sulla definizione delle logic function e sulla loro esposizione al generatore di workflow, vedi [Logic Functions](/l/it/developers/extend/apps/logic/logic-functions), in particolare la sezione **Exposing a function as an AI tool or workflow action** e `workflowActionTriggerSettings`.
+</Tip>
+
+### Richiesta HTTP
+
+Invia una richiesta a un API esterno come parte del tuo workflow.
+
+<img src="/images/user-guide/workflows/http_action.png" style={{width:'100%'}} />
+
+**Configurazione**:
+
+* Inserisci l'URL del punto finale dell'API. È possibile utilizzare parametri dai passaggi precedenti.
+* Seleziona metodo HTTP (GET, POST, PUT, PATCH, DELETE)
+* Aggiungi intestazioni e valori richiesti
+* Fornisci una risposta di esempio per l'anteprima della struttura
+
+## Azioni AI
+
+### Agente AI - In arrivo
+
+Esegue un agente AI all'interno del tuo flusso di lavoro per svolgere attività intelligenti.
+
+**Configurazione**:
+
+* **Agente**: Seleziona un agente AI esistente o usa l'agente predefinito
+* **Prompt**: Scrivi l'istruzione per l'agente AI
+* Fai riferimento a variabili dei passaggi precedenti nel prompt
+
+**Cosa possono fare gli agenti AI**:
+
+* Analizzare e riassumere dati
+* Classificare o categorizzare i record
+* Generare contenuti testuali
+* Prendere decisioni basate sui dati
+* Interagire con i dati del tuo CRM utilizzando strumenti
+
+**Output**: La risposta dell'agente AI è disponibile per l'uso nei passaggi successivi. Se l'agente ha uno schema di output strutturato, la risposta seguirà tale formato.
+
+<Note>
+Le azioni dell'agente AI consumano crediti del flusso di lavoro in base al modello AI utilizzato. Vedi [Crediti del flusso di lavoro](/l/it/user-guide/workflows/capabilities/workflow-credits) per i dettagli.
+</Note>
+
+<Note>
+Gli agenti AI rispettano le autorizzazioni basate sui ruoli. Puoi assegnare ruoli specifici agli agenti in **Impostazioni → Membri → Ruoli** per controllare a quali dati possono accedere. Vedi [Autorizzazioni](/l/it/user-guide/permissions-access/capabilities/permissions) per i dettagli.
+</Note>

packages/twenty-docs/l/it/user-guide/workflows/capabilities/workflow-branches.mdx

@@ -0,0 +1,66 @@
+---
+title: Rami Di Workflow
+description: Crea percorsi paralleli e logica condizionale nei tuoi flussi di lavoro.
+---
+
+I rami ti consentono di suddividere il tuo workflow in più percorsi che possono essere eseguiti simultaneamente o in modo condizionale in base ai tuoi dati.
+
+<img src="/images/user-guide/workflows/branches.png" style={{width:'100%'}} />
+
+## Come funzionano i rami
+
+Quando crei più connessioni da un singolo nodo, ogni percorso diventa un ramo. Per impostazione predefinita, **tutti i rami vengono eseguiti in parallelo**—non si attendono a vicenda.
+
+## Creazione dei rami
+
+### Aggiungi un nuovo ramo
+
+1. **Fai clic con il tasto destro sull'area di lavoro principale** del workflow (non su un nodo esistente)
+2. Clicca su **Aggiungi nodo**
+3. Scegli il tipo di nodo per il tuo nuovo ramo
+4. Trascina una freccia dalla parte inferiore del passaggio precedente alla parte superiore di questa nuova azione
+5. Ripeti per aggiungere altri rami dallo stesso nodo
+
+<Note>
+Ogni ramo è indipendente. L'aggiunta di un ramo non influisce sugli altri percorsi esistenti da quel nodo.
+</Note>
+
+### Layout visivo
+
+I rami appaiono come percorsi paralleli nell'editor del workflow. Puoi trascinare i nodi per riorganizzare il layout visivo senza influire sull'esecuzione.
+
+## Rami condizionali
+
+Poiché tutti i rami vengono eseguiti per impostazione predefinita, usa nodi **Filtro** per controllare quali percorsi vengono effettivamente eseguiti:
+
+| Ramo | Condizione del filtro | Azione                            |
+| ---- | --------------------- | --------------------------------- |
+| A    | Fase = "Vinta"        | Invia un'email di congratulazioni |
+| B    | Fase = "Persa"        | Crea un'attività di follow-up     |
+| C    | Fase = "Negoziazione" | Notifica il responsabile          |
+
+1. Crea rami dal tuo trigger o dall'azione
+2. Aggiungi un nodo **Filtro** come primo passaggio di ciascun ramo
+3. Configura ciascun filtro con condizioni reciprocamente esclusive
+4. Aggiungi le azioni dopo ciascun filtro
+
+Solo i rami in cui la condizione del filtro è soddisfatta continueranno l'esecuzione.
+
+## Unione dei rami
+
+**I rami non si uniscono automaticamente.** Ogni ramo viene eseguito in modo indipendente fino a quando non termina. Hai la massima flessibilità su come gestirlo:
+
+* **Opzione 1: Mantieni i rami separati**
+  Ogni ramo gestisce indipendentemente le proprie azioni di follow-up. Questo è l'approccio più semplice quando i rami non devono convergere.
+
+* **Opzione 2: Unisci i rami manualmente**
+  Quando crei il tuo workflow, puoi collegare manualmente più rami alla stessa azione a valle. Trascina semplicemente le frecce dalla fine di ciascun ramo a un nodo comune.
+
+<Note>
+Sebbene tu possa usare un nodo [Delay](/l/it/user-guide/workflows/capabilities/workflow-actions#delay) per mettere in pausa l'esecuzione, al momento non è configurabile per attendere "fino a quando termina un altro ramo".
+</Note>
+
+## Correlati
+
+* [Come usare i rami nei workflow](/l/it/user-guide/workflows/capabilities/use-branches-in-workflows) - Guida passo passo
+* [Azioni del workflow](/l/it/user-guide/workflows/capabilities/workflow-actions) - Azioni disponibili, incluso Filtro

packages/twenty-docs/l/it/user-guide/workflows/capabilities/workflow-credits.mdx

@@ -0,0 +1,75 @@
+---
+title: Crediti del flusso di lavoro
+description: Comprendere il consumo e la gestione dei crediti dei flussi di lavoro.
+---
+
+I crediti del flusso di lavoro alimentano le tue automazioni in Twenty. Capire come funzionano ti aiuta a ottimizzare i costi e a gestire efficacemente il tuo budget di automazione.
+
+## Allocazione dei crediti
+
+I crediti dei flussi di lavoro sono assegnati in base al ciclo di fatturazione, non al livello del piano:
+
+| Ciclo di fatturazione   | Crediti             |
+| ----------------------- | ------------------- |
+| **Abbonamento mensile** | 5 crediti al mese   |
+| **Abbonamento annuale** | 50 crediti all'anno |
+
+<Note>
+5 crediti mensili sono generosi per le automazioni standard. La maggior parte dei team non supererà questo limite con un utilizzo tipico dei flussi di lavoro. I crediti aggiuntivi sono necessari principalmente per le azioni Code avanzate e i flussi di lavoro basati sull'AI.
+</Note>
+
+## Come Funziona il Consumo dei Crediti
+
+I crediti vengono consumati quando i flussi di lavoro vengono eseguiti, non quando li crei. Ogni azione del flusso di lavoro consuma crediti in base alla sua complessità:
+
+### Consumo di Crediti per Tipo di Azione
+
+* **Operazioni interne di base**: Consumo di crediti molto basso
+  * Cerca Record
+  * Crea Record
+  * Aggiorna Record
+  * Elimina Record
+  * Azioni del modulo
+
+* **Operazioni complesse**: Consumo di crediti più alto
+  * Azioni di codice (esecuzione JavaScript)
+  * Richieste HTTP a servizi esterni
+
+* **Funzionalità AI**: Consumo di crediti più elevato
+  * Le azioni dell'agente AI consumano crediti in base al modello AI utilizzato
+  * Prompt più complessi e output più lunghi utilizzano più crediti
+
+* **Azioni Delay**: Consumo di crediti minimo
+  * Il nodo Delay consuma **1 credito** quando viene eseguito
+  * **Nessun credito viene consumato** durante il periodo di attesa
+  * Un ritardo di 5 minuti costa quanto un ritardo di 5 giorni
+
+### Deduzione in Tempo Reale
+
+I crediti vengono detratti in tempo reale quando i flussi di lavoro vengono eseguiti. Ciò significa:
+
+* I flussi di lavoro di bozza non consumano crediti
+* Solo i flussi di lavoro attivi e in esecuzione utilizzano la tua allocazione di crediti
+* I flussi di lavoro falliti consumano comunque crediti per i passaggi completati
+
+## Gestione dei Crediti
+
+### Verifica l'Uso dei Crediti
+
+1. Vai a **Impostazioni → Fatturazione**
+2. Visualizza il tuo attuale consumo di crediti e il saldo rimanente
+3. Monitora i modelli di utilizzo per ottimizzare i tuoi flussi di lavoro
+
+### Acquisto di Crediti Aggiuntivi
+
+Se hai bisogno di più crediti oltre alla tua assegnazione del piano:
+
+1. Vai a **Impostazioni → Fatturazione**
+2. Clicca sull'opzione per acquistare crediti aggiuntivi. Sono disponibili pacchetti di diverse dimensioni.
+3. I crediti vengono aggiunti al tuo saldo attuale
+
+## Migliori Pratiche
+
+* **Elaborazione batch**: Utilizza in modo efficiente le operazioni di massa e le azioni di Iteratore per ridurre le singole chiamate di azione
+* **Ottimizzazione del trigger manuale**: Per i trigger manuali, scegli la disponibilità `Bulk` per elaborare più record in una singola esecuzione del flusso di lavoro
+* Ottimizza le azioni di codice per l'efficienza

packages/twenty-docs/l/it/user-guide/workflows/capabilities/workflow-runs.mdx

@@ -0,0 +1,93 @@
+---
+title: Esecuzioni del workflow
+description: Monitora e gestisci le esecuzioni dei flussi di lavoro.
+---
+
+## Informazioni sulle esecuzioni
+
+Un'**Esecuzione** è una registrazione dell'esecuzione di un flusso di lavoro. Ogni volta che un flusso di lavoro viene attivato — che sia da un evento di record, una pianificazione, un'azione manuale o un webhook — viene creata una nuova esecuzione.
+
+## Visualizzazione delle esecuzioni
+
+### Dall'editor del flusso di lavoro
+
+1. Apri il flusso di lavoro che desideri monitorare
+2. Fai clic sul pannello **Esecuzioni** a destra
+3. Visualizza un elenco delle esecuzioni recenti con il relativo stato
+
+### Dalla vista Esecuzioni dei flussi di lavoro
+
+1. Vai a **Esecuzioni dei flussi di lavoro** nella barra laterale
+2. Visualizza le esecuzioni in tutti i flussi di lavoro
+3. Filtra per stato, flusso di lavoro o data
+
+## Stati delle esecuzioni
+
+| Stato             | Descrizione                                                                                       |
+| ----------------- | ------------------------------------------------------------------------------------------------- |
+| **In esecuzione** | Il flusso di lavoro è in esecuzione                                                               |
+| **Completato**    | Il flusso di lavoro è terminato correttamente                                                     |
+| **Non riuscito**  | Il flusso di lavoro ha riscontrato un errore ed è stato interrotto                                |
+| **In attesa**     | Il flusso di lavoro è in pausa (ad es., in attesa di un'azione Ritardo o dell'invio di un modulo) |
+
+## Dettagli dell'esecuzione
+
+Fai clic su una qualsiasi esecuzione per visualizzare:
+
+* **Stato**: stato attuale dell'esecuzione
+* **Ora di avvio**: quando è iniziata l'esecuzione
+* **Durata**: quanto è durata l'esecuzione
+* **Dati del trigger**: l'input che ha avviato il flusso di lavoro
+* **Output dei passaggi**: dati restituiti da ciascun passaggio
+* **Messaggi di errore**: se l'esecuzione non è riuscita, cosa è andato storto
+
+## Esecuzione passo dopo passo
+
+Ogni esecuzione mostra l'avanzamento nel flusso di lavoro:
+
+1. Vedi quali passaggi sono stati completati correttamente
+2. Identifica dove si sono verificati errori
+3. Visualizza i dati scambiati tra i passaggi
+4. Esegui il debug dei problemi esaminando gli input e gli output dei passaggi
+
+## Gestione degli errori
+
+Quando un'esecuzione non riesce:
+
+1. Apri l'esecuzione non riuscita
+2. Trova il passaggio che ha causato l'errore
+3. Controlla il messaggio di errore per i dettagli
+
+Problemi comuni:
+
+* Campi obbligatori mancanti
+* Formato dati non valido
+* Errori dell'API esterna
+* Problemi di autorizzazione
+
+## Riesecuzione dei flussi di lavoro
+
+Se un'esecuzione non riesce, puoi:
+
+* Correggere il problema di base e attendere il trigger successivo
+* Per i flussi di lavoro manuali, attiva nuovamente il flusso con gli stessi dati o con dati aggiornati
+* Rivedere la logica del flusso di lavoro per evitare errori futuri
+
+## Consigli Per Prestazioni
+
+### Gestire La Cronologia Esegui
+
+* Le corse sono mantenute per riferimento storico
+* Le corse molto vecchie possono essere archiviate automaticamente
+* Esporta i dati di esecuzione se hai bisogno di mantenere i record
+
+### Monitoraggio Delle Migliori Pratiche
+
+* Controlla viene eseguito regolarmente dopo aver attivato nuovi flussi di lavoro
+* Revisione non riuscita per identificare i modelli
+
+## Correlati
+
+* [Trigger dei flussi di lavoro](/l/it/user-guide/workflows/capabilities/workflow-triggers)
+* [Azioni dei flussi di lavoro](/l/it/user-guide/workflows/capabilities/workflow-actions)
+* [Workflow Troubleshooting](/l/it/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting)

packages/twenty-docs/l/it/user-guide/workflows/capabilities/workflow-triggers.mdx

@@ -0,0 +1,137 @@
+---
+title: Attivatori dei flussi di lavoro
+description: Scopri i diversi attivatori che avviano i tuoi flussi di lavoro.
+---
+
+## Informazioni sugli attivatori
+
+I flussi di lavoro iniziano sempre con un singolo attivatore che definisce quando deve essere eseguita l'automazione.
+
+<img src="/images/user-guide/workflows/workflow_triggers.png" style={{width:'100%'}} />
+
+<Tip>
+**Gli oggetti avanzati sono supportati!** Oltre agli oggetti CRM standard (Persone, Aziende, Opportunità), puoi anche avviare flussi di lavoro ed eseguire azioni su:
+* Membri dello spazio di lavoro
+* Eventi del calendario
+* Messaggi (email)
+* Attività, note e molti altri oggetti di sistema
+
+Questo consente potenti automazioni, come notificare i membri del team quando vengono creati eventi del calendario oppure elaborare automaticamente le email in arrivo.
+</Tip>
+
+## Record Creato
+
+Avvia il flusso di lavoro quando viene creato un nuovo record in un oggetto selezionato (Persone, Aziende, Opportunità o un qualsiasi oggetto personalizzato).
+
+**Configurazione**: Seleziona il tipo di oggetto da monitorare per i nuovi record.
+
+<Note>
+* Questo trigger è ottimo per i record creati da CSV, mailbox e sincronizzazione del calendario, o API.
+* **Non è consigliato per i record creati manualmente**: con questo attivatore, i flussi di lavoro iniziano non appena il record viene creato. Dal momento che Twenty UI offre il salvataggio automatico sul volo (non c'è alcuna modalità di modifica e quindi una convalida per salvare i record), il flusso di lavoro verrà attivato prima che l'utente inserisca tutti i campi.
+  Per attivare questo flusso di lavoro sui record creati manualmente, si consiglia invece di usare l'attivatore `Record is created or updated`.
+</Note>
+
+## Record Aggiornato
+
+Avvia il flusso di lavoro quando vengono apportate modifiche a un record esistente.
+
+**Configurazione**:
+
+* Seleziona il tipo di oggetto
+* Specifica opzionalmente quali campi monitorare per le modifiche
+
+## Record Aggiornato o Creato
+
+Avvia il flusso di lavoro quando un record viene creato o aggiornato in un oggetto selezionato.
+
+**Perché è Importante:** Questo trigger è particolarmente utile perché i record creati tramite diversi metodi si comportano diversamente:
+
+* **Importazioni API/CSV:** I record vengono creati con tutti i campi popolati immediatamente
+* **Creazione manuale:** Prima vengono creati i record, poi i campi vengono aggiunti con aggiornamenti successivi
+
+**Configurazione**:
+
+* Seleziona il tipo di oggetto da monitorare
+* Specifica opzionalmente quali campi monitorare per le modifiche
+* Il flusso di lavoro verrà attivato sia alla creazione iniziale sia a qualsiasi aggiornamento successivo
+
+## Record Eliminato
+
+Avvia il flusso di lavoro quando un record viene rimosso da un oggetto.
+
+**Configurazione**: Seleziona il tipo di oggetto da monitorare per le eliminazioni.
+
+## Attivatore manuale
+
+Avvia il flusso di lavoro quando viene attivato da un'azione dell'utente. È possibile accedere a questo attivatore tramite il menu `Cmd+K` o tramite un pulsante personalizzato che verrà visualizzato nella barra di navigazione superiore dopo aver selezionato uno o più record.
+
+<img src="/images/user-guide/workflows/add_to_newsletter_button.png" style={{width:'100%'}} />
+
+**Configurazione di Disponibilità:**
+Scegli come il flusso di lavoro dovrebbe gestire la selezione dei record:
+
+* **Globale:** Non è richiesto alcun record per attivare questo flusso di lavoro. Il flusso di lavoro viene attivato dal menu di comando `Cmd+K` ovunque (da qualsiasi oggetto) e non usa i record come input.
+
+Per la disponibilità **Single** e **Bulk**, i record selezionati saranno passati al tuo flusso di lavoro. Questo è configurato per un dato oggetto, e diversi record possono essere selezionati prima di attivare il flusso di lavoro.
+
+* **Singolo**: Il flusso di lavoro verrà eseguito dall'inizio alla fine quante volte ci sono record selezionati.
+
+  <Note>
+    **Limite soft: 100 esecuzioni/minuto**. Oltre questa soglia, i flussi di lavoro rimangono nello stato "Not Started" e vengono elaborati gradualmente—o da un processo in background oppure quando un altro flusso di lavoro entra in coda. Questo significa che puoi selezionare più di 100 record con un attivatore Singolo; l'esecuzione sarà semplicemente più lenta.
+  </Note>
+
+* **Bulk**: Il flusso di lavoro verrà eseguito una volta, fornendo l'intero elenco di record come input. Questo significa che il flusso di lavoro deve contenere un'[azione Iteratore](/l/it/user-guide/workflows/capabilities/workflow-actions#iterator).
+
+<Note>
+È più avanzato ed è ideale per chi vuole ottimizzare il numero di esecuzioni del flusso di lavoro.
+</Note>
+
+<img src="/images/user-guide/workflows/manual_trigger.png" style={{width:'100%'}} />
+
+**Configurazione Aggiuntiva**:
+
+* Seleziona l'oggetto di destinazione (per disponibilità Singola e Bulk)
+* Scegli un'icona di comando per attivare il flusso di lavoro.
+* Configura la posizione nella barra di navigazione (Fissa o Non Fissa)
+
+**Metodi di Accesso**:
+
+* Menu `Cmd+K` per trovare e avviare flussi di lavoro manuali
+* Pulsante personalizzato nella barra di navigazione in alto (se configurato)
+
+## Attivatore basato sul tempo: Su pianificazione
+
+Avvia il flusso di lavoro con una ricorrenza da te definita.
+
+**Configurazione**:
+
+* Seleziona l'unità di tempo (minuti, ore, giorni)
+* Inserisci un valore o usa espressioni cron personalizzate per pianificazioni avanzate
+
+<Note>
+**Fuso orario**: I flussi di lavoro pianificati vengono eseguiti in **UTC**. Quando imposti gli orari per le pianificazioni giornaliere, converti la tua ora locale in UTC.
+</Note>
+
+## Attivatore esterno: Webhook
+
+Avvia il flusso di lavoro quando viene ricevuta una richiesta GET o POST da un servizio esterno.
+
+<img src="/images/user-guide/workflows/webhook_trigger.png" style={{width:'100%'}} />
+
+**Configurazione**:
+
+* Il flusso di lavoro fornisce un URL webhook univoco: copialo e aggiungilo al tuo sistema esterno come endpoint da chiamare.
+* Per le richieste POST, definisci la struttura del body prevista in modo che Twenty sappia quali dati aspettarsi. Aggiungi qui i campi che riceverai e che saranno necessari più avanti nel tuo flusso di lavoro.
+* Configura l'autenticazione (presto disponibile).
+
+## Scegliere l'attivatore giusto
+
+| Caso d'uso                            | Attivatore consigliato      |
+| ------------------------------------- | --------------------------- |
+| Nuovi lead da elaborare               | Record Creato               |
+| Modifiche ai dati da sincronizzare    | Record Aggiornato           |
+| Gestione dati da importazione/manuale | Record Aggiornato o Creato  |
+| Pulizia dopo l'eliminazione           | Record Eliminato            |
+| Azione avviata dall'utente            | Avvia Manualmente           |
+| Report ricorrenti                     | Su pianificazione           |
+| Integrazione esterna                  | Webhook o Su pianificazione |

packages/twenty-docs/l/it/user-guide/workflows/capabilities/workflow-versions.mdx

@@ -0,0 +1,84 @@
+---
+title: Versioni del workflow
+description: Gestisci le versioni e le bozze dei workflow.
+---
+
+## Informazioni sulle versioni
+
+Ogni volta che attivi un workflow, viene creata una nuova versione. Questo ti permette di tenere traccia delle modifiche nel tempo e ripristinare le configurazioni precedenti se necessario.
+
+## Stati delle versioni
+
+| Stato           | Descrizione                                   |
+| --------------- | --------------------------------------------- |
+| **Bozza**       | In fase di modifica, non ancora pubblicata    |
+| **Attivo**      | Versione live che risponde ai trigger         |
+| **Disattivato** | In precedenza attivo ma fermato manualmente   |
+| **Archiviato**  | Versioni passate conservate per la cronologia |
+
+## Lavorare con le bozze
+
+Quando modifichi un workflow attivo, le modifiche vengono salvate come **bozza**. La versione attiva continua a essere eseguita mentre lavori agli aggiornamenti.
+
+Una volta terminata la modifica, puoi:
+
+* **Attiva**: Pubblica la bozza come nuova versione attiva (la versione precedente viene archiviata)
+* **Scarta**: Elimina la bozza e mantieni l'attuale versione attiva
+
+## Cronologia Versioni
+
+### Visualizzare le versioni precedenti
+
+1. Apri il workflow
+2. Fai clic sulla scheda **Versioni**
+3. Visualizza tutte le versioni precedenti con timestamp
+
+### Ripristinare una versione
+
+1. Trova la versione che desideri ripristinare
+2. Fai clic su **Usa come bozza**
+3. La versione viene copiata in una nuova bozza
+4. Apporta gli aggiornamenti necessari
+5. Attiva quando sei pronto
+
+## Migliori Pratiche
+
+### Gestione delle versioni
+
+* Attiva solo quando pronta per la produzione
+* Mantieni modifiche significative tra le versioni
+* Documenta le modifiche importanti nei nomi o nelle descrizioni dei workflow
+* Testa in modalità bozza prima di attivare i workflow
+
+### Ripristino delle modifiche
+
+* Se una nuova versione causa problemi, ripristina la versione precedente
+* Usa la cronologia delle versioni per tenere traccia delle modifiche
+* Testa sempre le versioni ripristinate prima di attivare
+
+## Workflow comuni
+
+### Modifica rapida
+
+1. Apporta piccole modifiche a un workflow attivo
+2. Testa in modalità bozza
+3. Attiva la nuova versione
+
+### Revisione importante
+
+1. Usa la versione precedente come punto di partenza
+2. Apporta modifiche significative in bozza
+3. Testa approfonditamente tutti gli scenari
+4. Attiva quando sei sicuro
+
+### Ripristino
+
+1. Identifica il problema con la versione corrente
+2. Trova nella cronologia l'ultima versione funzionante
+3. Fai clic su **Usa come bozza**
+4. Attiva per ripristinare il comportamento precedente
+
+## Correlati
+
+* [Guida introduttiva ai workflow](/l/it/user-guide/workflows/overview)
+* [Esecuzioni dei workflow](/l/it/user-guide/workflows/capabilities/workflow-runs)

packages/twenty-docs/l/it/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx

@@ -0,0 +1,82 @@
+---
+title: Gestire gli array nelle azioni Code
+description: Scopri come gestire correttamente gli input di tipo array nelle azioni Code dei workflow.
+---
+
+Quando lavori con gli array nelle azioni Code, potresti incontrare due problemi comuni:
+
+1. **Array passati come stringhe** — i dati provenienti da sistemi esterni o da passaggi precedenti arrivano come stringa invece che come un vero array
+2. **Impossibile selezionare singoli elementi** — puoi selezionare solo l'intero array, non i campi specifici al suo interno
+
+Entrambi i casi si possono risolvere con un nodo Code.
+
+## Analizzare gli array dalle stringhe
+
+Gli array vengono spesso passati tra i passaggi del workflow come stringhe o JSON invece che come array nativi. Ciò accade quando:
+
+* Ricezione di dati da API esterne tramite HTTP Request
+* Elaborazione dei payload dei webhook
+* Passaggio di dati tra i passaggi del workflow
+
+**Soluzione**: aggiungi questo pattern all'inizio della tua azione Code:
+
+```javascript
+export const main = async (params: {
+  users: any;
+}): Promise<object> => {
+  const { users } = params;
+
+  // Handle input that may come as a string or an array
+  const usersFormatted = typeof users === "string" ? JSON.parse(users) : users;
+
+  // Now you can safely work with usersFormatted as an array
+  return {
+    users: usersFormatted.map((user) => ({
+      ...user,
+      activityStatus: String(user.activityStatus).toUpperCase(),
+    })),
+  };
+};
+```
+
+La riga chiave `typeof users === "string" ? JSON.parse(users) : users` verifica se l'input è una stringa, lo analizza se necessario o lo usa direttamente se è già un array.
+
+## Estrazione di campi specifici dagli array
+
+Un webhook potrebbe restituire un array come `answers: [...]`, ma nei passaggi successivi del workflow puoi selezionare solo l'**intero array** — non i singoli elementi al suo interno.
+
+**Soluzione**: aggiungi un nodo Code per estrarre campi specifici e restituirli come oggetto strutturato:
+
+```javascript
+export const main = async (params: {
+  answers: any;
+}): Promise<object> => {
+  const { answers } = params;
+
+  // Handle input that may come as a string or an array
+  const answersFormatted = typeof answers === "string"
+    ? JSON.parse(answers)
+    : answers;
+
+  // Extract specific fields from the array
+  const firstname = answersFormatted[0]?.text || "";
+  const name = answersFormatted[1]?.text || "";
+
+  return {
+    answer: {
+      firstname,
+      name
+    }
+  };
+};
+```
+
+Il nodo Code restituisce un oggetto strutturato invece di un array. Nei passaggi successivi, ora puoi selezionare campi individuali come `answer.firstname` e `answer.name` dal selettore delle variabili.
+
+<Tip>
+**Vuoi iterare sull'array invece di estrarre i campi?** Quando uno step di Code o Logic Function restituisce un array di primo livello, puoi passarlo direttamente a un [Iterator](/l/it/user-guide/workflows/capabilities/use-iterator): seleziona l'opzione **Whole list** dello step come input dell'Iterator, quindi fai riferimento a ciascun elemento con `{{iterator.currentItem}}` all'interno del ciclo. In quel caso non è necessario ristrutturare l'array in un oggetto.
+</Tip>
+
+<Tip>
+Fai clic sull'icona quadrata in alto a destra dell'editor di codice per visualizzarlo a tutto schermo — utile poiché la larghezza predefinita dell'editor è limitata.
+</Tip>