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

packages/twenty-docs/l/it/getting-started/core-concepts/ai.mdx

@@ -0,0 +1,34 @@
+---
+title: AI
+description: Come Twenty utilizza l'IA per migliorare la tua esperienza CRM.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty integra l'IA direttamente nel tuo CRM — non come un espediente, ma come uno strumento che funziona all'interno del tuo modello di dati e del tuo sistema di autorizzazioni.
+
+## Chatbot con IA
+
+Fai domande sui tuoi dati in linguaggio naturale. Il chatbot con IA può interrogare i record del tuo CRM, riassumere le informazioni e aiutarti a trovare ciò che stai cercando senza creare filtri complessi.
+
+<VimeoEmbed videoId="1185511734" title="Chatbot con IA" />
+
+## Agenti AI
+
+Gli agenti AI vanno oltre la semplice chat — possono eseguire autonomamente attività a più passaggi:
+
+* Arricchisci i record con dati provenienti da fonti esterne
+* Scrivi e invia email di follow-up
+* Analizza lo stato della pipeline e segnala le trattative a rischio
+* Elabora i dati in arrivo e instradali al team corretto
+
+Gli agenti lavorano all'interno dei tuoi workflow esistenti, così puoi combinare l'IA con approvazioni manuali, logica condizionale e chiamate API esterne.
+
+## Autorizzazioni & sicurezza
+
+L'IA in Twenty rispetta il tuo modello di autorizzazioni. Gli agenti possono accedere solo a oggetti e campi che l'utente (o il ruolo) ha l'autorizzazione a visualizzare. I dati sensibili rimangono protetti anche quando è coinvolta l'IA.
+
+<Card title="Guida completa all'IA" icon="arrow-right" href="/l/it/user-guide/ai/overview">
+  Riferimento dettagliato sul chatbot, sugli agenti e sui controlli delle autorizzazioni.
+</Card>

packages/twenty-docs/l/it/getting-started/core-concepts/apps.mdx

@@ -0,0 +1,41 @@
+---
+title: App
+icon: cube
+description: Estendi Twenty con il codice — oggetti personalizzati, logica lato server, componenti UI e agenti IA, tutti come pacchetti TypeScript.
+---
+
+La maggior parte dei CRM ti offre un pannello di configurazione. Twenty ti offre una piattaforma. Le app sono il modo in cui gli sviluppatori estendono Twenty oltre ciò che offre la UI — definendo modelli di dati, logica lato server, componenti UI e funzionalità di IA come codice, quindi distribuendoli a uno o più workspace.
+
+## Perché esistono le app
+
+I flussi di lavoro coprono l’automazione no-code. Ma alcune cose richiedono codice: un motore di prezzi personalizzato, una pipeline di arricchimento proprietaria, un controllo di conformità che viene eseguito a ogni aggiornamento di un record, un pannello UI personalizzato che recupera dati da uno strumento interno.
+
+Le app ti permettono di creare questi elementi come estensioni di prima classe — non script fragili che parlano con un’API dall’esterno, ma codice che viene eseguito sulla piattaforma con pieno accesso al sistema di tipi, al modello di autorizzazioni e all’interfaccia utente.
+
+## Cosa può definire un’app
+
+Un’app è un pacchetto TypeScript che dichiara **entità** utilizzando `twenty-sdk`:
+
+| Entità                   | Cosa fa                                                                                                                     |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
+| **Oggetti e campi**      | Nuove tabelle di dati e campi su oggetti esistenti — stesso trattamento di quelli integrati                                 |
+| **Funzioni logiche**     | TypeScript lato server attivato da route HTTP, pianificazioni cron o eventi del database                                    |
+| **Componenti front-end** | Componenti React sandboxed che vengono renderizzati all'interno dell'UI di Twenty (pannello laterale, widget, menu comandi) |
+| **Skill e agenti**       | Funzionalità di IA — istruzioni riutilizzabili e assistenti autonomi                                                        |
+| **Viste e navigazione**  | Viste elenco preconfigurate e voci di menu della barra laterale                                                             |
+
+Tutto viene rilevato tramite analisi AST in fase di build — nessun file di configurazione, nessun boilerplate di registrazione. Inserisci un `export default defineObject(...)` in qualsiasi file `.ts` e l'SDK lo rileva.
+
+## Come vengono eseguite
+
+* **Le funzioni logiche** vengono eseguite in processi Node.js isolati, sandboxed rispetto all'host. Accedono ai dati tramite un client API tipizzato con ambito limitato alle autorizzazioni del ruolo dell'app.
+* **I componenti front-end** vengono eseguiti in Web Workers utilizzando il Remote DOM — isolati dalla pagina principale ma renderizzando elementi DOM nativi (non iframe).
+* **Le autorizzazioni** vengono applicate a livello di API. Un'app vede solo ciò che il suo ruolo consente.
+
+## L'esperienza di sviluppo
+
+Scrivi la tua app come un progetto TypeScript sulla tua macchina. La CLI osserva i file sorgente e li sincronizza in tempo reale con un server Twenty in esecuzione — modifica un file e vedi il cambiamento nell'UI entro un secondo. Il client API tipizzato viene rigenerato automaticamente quando lo schema cambia. Quando sei pronto, `yarn twenty app:publish --private` esegue il push su un server di produzione, oppure `yarn twenty app:publish` elenca la tua app su npm e sul marketplace di Twenty.
+
+<Card title="Crea la tua prima app" icon="arrow-right" href="/l/it/developers/extend/apps/getting-started/quick-start">
+  Procedura guidata in tre fasi — crea lo scaffold, esegui un server locale, sincronizza le tue modifiche.
+</Card>

packages/twenty-docs/l/it/getting-started/core-concepts/calendar-and-email.mdx

@@ -0,0 +1,46 @@
+---
+title: Calendario & Email
+description: Sincronizza la tua email e il tuo calendario con Twenty.
+icon: envelope
+---
+
+Twenty si collega ai tuoi strumenti esistenti così che il tuo CRM rimanga aggiornato senza inserimento manuale dei dati.
+
+## Sincronizzazione email
+
+Collega la tua casella di posta di **Google Workspace** o **Microsoft 365**. Una volta connesso:
+
+* Le email vengono collegate automaticamente ai relativi record di Aziende e Persone
+* Le conversazioni email complete sono visibili nella timeline di ogni record
+* Puoi inviare email direttamente da Twenty
+* Sono supportate più caselle di posta per utente
+
+Controlli tu cosa viene importato — filtra per intervallo di date o mittente per evitare di importare email irrilevanti.
+
+## Sincronizzazione del calendario
+
+Gli eventi del calendario vengono sincronizzati automaticamente dal tuo account connesso. Gli eventi compaiono sui relativi record del CRM, offrendoti una visione completa delle tue interazioni con ogni contatto o azienda.
+
+## Integrazioni
+
+Oltre a email e calendario, Twenty si collega a strumenti esterni tramite:
+
+| Metodo                       | Caso d'uso                                                                |
+| ---------------------------- | ------------------------------------------------------------------------- |
+| **API**                      | Crea integrazioni personalizzate con l'API GraphQL o REST                 |
+| **Webhooks**                 | Invia notifiche in tempo reale a sistemi esterni quando i record cambiano |
+| **Zapier**                   | Connettiti a più di 5.000 app senza codice                                |
+| **Azioni HTTP dei workflow** | Chiama qualsiasi API esterna come parte di un workflow automatizzato      |
+
+## App personalizzate
+
+Gli sviluppatori possono creare app complete su Twenty, aggiungendo UI personalizzata, logica lato server e integrazioni avanzate. Le app possono essere pubblicate per la community o mantenute private.
+
+<CardGroup cols={2}>
+  <Card title="Guida a Calendario & Email" icon="envelope" href="/l/it/user-guide/calendar-emails/overview">
+    Configura la sincronizzazione delle email e del calendario e risolvi eventuali problemi.
+  </Card>
+  <Card title="API ed estensioni" icon="plug" href="/l/it/developers/extend/api">
+    Crea integrazioni personalizzate con l'API di Twenty.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/it/getting-started/core-concepts/dashboards.mdx

@@ -0,0 +1,37 @@
+---
+title: Cruscotti
+description: Monitora le prestazioni e visualizza i dati del tuo CRM con cruscotti personalizzati.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+I cruscotti ti offrono visibilità in tempo reale sulle metriche della tua attività — stato della pipeline, prestazioni del team, trend dei ricavi e qualsiasi altra cosa tu voglia monitorare.
+
+<VimeoEmbed videoId="1185511768" title="Cruscotto" />
+
+## Widget
+
+Ogni cruscotto è composto da widget. Un widget è un singolo grafico o una singola metrica collegata ai tuoi dati del CRM. Puoi configurare:
+
+* **Tipo di grafico** — Barre, linee, torta, numero e altro ancora
+* **Fonte dati** — Qualsiasi oggetto nel tuo modello dati (standard o personalizzato)
+* **Filtri** — Restringi a record specifici, intervalli di date o segmenti
+* **Aggregazione** — Conteggio, somma, media, minimo, massimo su qualsiasi campo numerico
+* **Raggruppamento** — Suddividi per campi selezionati, date o relazioni
+
+## Cosa puoi monitorare
+
+* Valore della pipeline per fase
+* Opportunità chiuse nel tempo
+* Valore medio delle opportunità per fonte
+* Tassi di completamento delle attività
+* Metriche personalizzate su qualsiasi oggetto
+
+## Condivisione
+
+I cruscotti sono a livello di spazio di lavoro — tutti nel tuo team possono vederli. Disponi i widget in una griglia e ridimensionali per creare la visualizzazione che funziona per il tuo team.
+
+<Card title="Guida completa ai cruscotti" icon="arrow-right" href="/l/it/user-guide/dashboards/overview">
+  Riferimento dettagliato sulla creazione di cruscotti, sulla configurazione dei widget e sulle impostazioni dei grafici.
+</Card>

packages/twenty-docs/l/it/getting-started/core-concepts/data-model.mdx

@@ -0,0 +1,47 @@
+---
+title: Modello dati
+description: Comprendi come Twenty struttura i tuoi dati con oggetti, campi e relazioni.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Tutto in Twenty è costruito attorno a **oggetti** e **campi**, i mattoni fondamentali del tuo modello di dati.
+
+## Oggetti
+
+Gli oggetti sono le tabelle che contengono i tuoi dati. Twenty include oggetti standard pronti all’uso:
+
+* **Aziende** — Organizzazioni con cui fai affari
+* **Persone** — Contatti individuali
+* **Opportunità** — Trattative nella tua pipeline
+* **Attività** — Attività da svolgere per il tuo team
+* **Note** — Testo libero collegato ai record
+
+Puoi anche creare **oggetti personalizzati** per qualsiasi esigenza della tua azienda: progetti, ticket di supporto, prodotti, contratti o qualsiasi altra cosa.
+
+## Campi
+
+I campi sono le proprietà su ciascun oggetto. Twenty supporta un’ampia gamma di tipi di campo:
+
+| Categoria     | Tipi                                                                     |
+| ------------- | ------------------------------------------------------------------------ |
+| **Di base**   | Testo, Numero, Booleano, Data, Valuta, Valutazione, Selezione            |
+| **Compositi** | Indirizzo (via, città, stato, CAP), Nome completo, Link, Telefoni, Email |
+| **Speciale**  | Relazione, Allegato file, JSON, Utente (chi ha creato/modificato)        |
+
+Ogni oggetto ottiene anche campi di sistema automatici: `id`, `createdAt`, `updatedAt`, `createdBy` e `position`.
+
+## Relazioni
+
+Gli oggetti si collegano tra loro tramite relazioni. Un’Azienda ha molte Persone, un’Opportunità appartiene a un’Azienda e così via. Puoi creare relazioni personalizzate tra qualsiasi oggetto, incluse relazioni molti-a-molti.
+
+## Cosa rende tutto questo potente
+
+A differenza dei CRM tradizionali, in cui sei limitato a campi predefiniti su oggetti predefiniti, Twenty ti permette di modellare i tuoi dati esattamente come funziona la tua azienda. Gli oggetti personalizzati ricevono lo stesso trattamento di prima classe di quelli integrati, inclusi endpoint API, viste, autorizzazioni e trigger dei flussi di lavoro.
+
+<Card title="Approfondisci il modello di dati" icon="arrow-right" href="/l/it/user-guide/data-model/overview">
+  Riferimento completo su oggetti, campi, relazioni e su come configurarli.
+</Card>
+
+<VimeoEmbed videoId="1185511827" title="Modello dati" />

packages/twenty-docs/l/it/getting-started/core-concepts/glossary.mdx

@@ -0,0 +1,105 @@
+---
+title: Glossario
+icon: book
+description: Termini chiave utilizzati in tutto 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 indica un'istanza di un oggetto, come una specifica azienda o un contatto.
+
+## 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/getting-started/core-concepts/layout.mdx

@@ -0,0 +1,74 @@
+---
+title: Layout
+description: Come navigare, esplorare e visualizzare i record in Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Il layout principale
+
+Il centro dello schermo è dove vivono i tuoi record — persone, aziende, opportunità, attività, note, dashboard, flussi di lavoro ed eventuali oggetti personalizzati. Qui visualizzi, modifichi ed elimini i record e crei nuove viste.
+
+<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
+
+## Barra di navigazione
+
+La barra laterale sinistra ti offre:
+
+* **Selettore dello spazio di lavoro** — passa da uno spazio di lavoro all'altro o creane uno nuovo (menu a discesa in alto)
+* **Ricerca** — premi `/` per attivarla immediatamente, esegue ricerche su tutti gli oggetti
+* **Impostazioni** — accessibili dall'angolo in alto a sinistra
+* **Preferiti** — viste fissate, specifiche per ogni utente
+* **Scorciatoie agli oggetti** — accesso rapido a Persone, Aziende, Opportunità, ecc.
+* **Flussi di lavoro** — crea automazioni
+
+Trascina gli elementi per riordinarli, crea cartelle per raggruppare oggetti correlati, nascondi ciò che non usi.
+
+<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
+
+## Menu Comandi
+
+Premi `Cmd+K` (Mac) o `Ctrl+K` (Windows), oppure fai clic sui tre puntini in alto a destra. Da qui 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 navigare nel tuo spazio di lavoro
+
+<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
+
+## Cerca
+
+Accessibile tramite il Menu Comandi, la parte superiore della barra di navigazione o premendo `/`. La ricerca funziona su tutti gli oggetti.
+
+<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
+
+## Pannello laterale
+
+Fai clic su un record per aprire il pannello laterale a destra: una panoramica rapida delle informazioni chiave del record senza lasciare la pagina corrente. Fai clic su **Open** per andare alla pagina completa del record.
+
+<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
+
+## Viste
+
+Ogni oggetto supporta più viste — illimitate per oggetto. Usa il menu a discesa in alto a sinistra per passare da una vista all'altra.
+
+* **Tabella** — righe e colonne in stile foglio di calcolo, con raggruppamenti, modifica in linea e personalizzazione delle colonne
+* **Kanban** — schede drag-and-drop organizzate in base a un campo di tipo selezione, ideale per le pipeline
+* **Calendario** — record posizionati su una linea temporale in base a un campo data, per pianificazioni basate sul tempo
+
+Ogni vista salva i propri filtri, l'ordinamento e la visibilità dei campi. Condividi le viste con il tuo spazio di lavoro o mantienile private. Aggiungi le viste ai preferiti per un accesso rapido dalla barra laterale.
+
+<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
+
+## Pagine dei record
+
+Quando apri un record, la pagina dei dettagli è composta da **schede** e **widget** configurabili. Aggiungi, rimuovi, riordina e ridimensiona i widget in una griglia — campi, record correlati, email, timeline, attività, note, file, grafici, iframe e altro ancora. Ogni tipo di oggetto ha il proprio layout.
+
+<Card title="Guida completa al layout" icon="arrow-right" href="/l/it/user-guide/layout/overview">
+  Navigazione, viste, pagine dei record — guida di riferimento dettagliata e istruzioni pratiche.
+</Card>
+
+<VimeoEmbed videoId="1185511790" title="Layout" />

packages/twenty-docs/l/it/getting-started/core-concepts/workflows.mdx

@@ -0,0 +1,55 @@
+---
+title: Flussi di lavoro
+description: Automatizza i processi aziendali con il generatore visuale di workflow di Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+I workflow ti permettono di automatizzare attività ripetitive e collegare Twenty a strumenti esterni, senza scrivere codice (anche se puoi farlo se vuoi).
+
+<VimeoEmbed videoId="1185511711" title="Workflow" />
+
+## Come funzionano i workflow
+
+Ogni workflow è composto da tre parti:
+
+1. **Trigger** — Cosa avvia il workflow
+2. **Steps** — Cosa succede dopo (una o più azioni in sequenza)
+3. **Variables** — Dati che fluiscono tra gli step
+
+## Trigger
+
+| Trigger               | Quando viene attivato                                                                      |
+| --------------------- | ------------------------------------------------------------------------------------------ |
+| **Evento del record** | Un record viene creato, aggiornato, eliminato o sottoposto a upsert                        |
+| **Manuale**           | Un utente fa clic su un pulsante (su un singolo record, su più record o a livello globale) |
+| **Pianifica**         | A intervalli ricorrenti (sintassi cron)                                                    |
+| **Webhook**           | Un sistema esterno invia una richiesta HTTP POST                                           |
+
+## Azioni
+
+I workflow possono concatenare qualsiasi combinazione di:
+
+* **Record operations** — Crea, aggiorna, trova, elimina o esegui un upsert sui record
+* **Send email** — Invia o prepara bozze di email dagli account collegati
+* **HTTP request** — Chiama qualsiasi API esterna
+* **Code** — Esegui JavaScript personalizzato per logiche complesse
+* **Branches** — Condizioni if/else per dividere il percorso del workflow
+* **Iterator** — Itera sugli array di dati
+* **AI Agent** — Consenti a un agente AI di elaborare i dati in modo autonomo
+* **Delay** — Attendi prima di continuare
+* **Form** — Raccogli input dell’utente a metà workflow
+
+## Cosa puoi creare
+
+* Invia avvisi su Slack quando un’opportunità raggiunge una certa fase
+* Arricchisci automaticamente i nuovi contatti con dati provenienti da API esterne
+* Rileva le opportunità inattive e avvisa il proprietario
+* Sincronizza i dati tra Twenty e il tuo sistema di fatturazione
+* Genera PDF o fatture dai dati dei record
+* Invia risposte automatiche alle email in arrivo che corrispondono a determinati criteri
+
+<Card title="Guida completa ai workflow" icon="arrow-right" href="/l/it/user-guide/workflows/overview">
+  Riferimento dettagliato su trigger, azioni, variabili e casi d’uso reali di automazione.
+</Card>

packages/twenty-docs/l/it/getting-started/introduction.mdx

@@ -0,0 +1,72 @@
+---
+title: Perché Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Hai sempre dovuto scegliere tra software facili da iniziare a usare ma impossibili da modificare, e software flessibili ma che richiedono mesi per essere configurati. Twenty è la terza opzione: **un CRM pronto per la produzione che puoi rimodellare man mano che procedi.**
+
+## Cosa rende Twenty diverso
+
+Twenty è una piattaforma su cui puoi costruire, non un prodotto che configuri.
+
+<CardGroup cols={2}>
+  <Card img="/images/user-guide/halftone/ai.png">
+    <CardTitle>Creato per gli agenti</CardTitle>
+    Gli agenti operano all'interno del tuo modello di dati con permessi reali. Competenze, strumenti, MCP.
+  </Card>
+  <Card img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>Estendibilità sicura</CardTitle>
+    La flessibilità degli strumenti vibe-coded su fondamenta sicure.
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>Stack moderno</CardTitle>
+    React, TypeScript. Il tuo team sa già come estendere Twenty. Nessun linguaggio proprietario, nessun gatekeeping.
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>Nessun lock-in</CardTitle>
+    Core open source, self-hostable, puoi esportare i tuoi dati in qualsiasi momento.
+  </Card>
+</CardGroup>
+
+## Per chi è Twenty
+
+* **Grandi aziende che sostituiscono Salesforce** — il tuo team
+  passa più tempo a lottare contro lo strumento che a usarlo.
+  Ti senti bloccato e i costi continuano ad aumentare.
+* **Startup con fondatori tecnici** — hai superato i limiti di
+  fogli di calcolo e Notion. Hai grandi ambizioni e vuoi
+  un CRM che cresca con te.
+* **Team GTM in cerca di un vantaggio competitivo** — vuoi creare
+  il tuo lead scoring, il tuo arricchimento dati, i tuoi
+  flussi di lavoro in uscita.
+* **Organizzazioni attente alla privacy** — devi
+  effettuare il self-hosting e possedere i tuoi dati end-to-end. Per motivi normativi,
+  contrattuali o semplicemente di principio.
+* **Partner Salesforce** —
+  i tuoi sviluppatori sono stanchi di presentare aumenti dei costi di licenza ai tuoi clienti.
+  Vuoi una DX migliore e consegnare progetti più velocemente a un costo di licenza inferiore per i tuoi clienti.
+* **Agenzie di sviluppo web** — il tuo team conosce TypeScript, React,
+  e PostgreSQL. Twenty apre il mercato dei CRM
+  senza dover imparare APEX o ottenere certificazioni proprietarie.
+
+## Per chi non è Twenty
+
+* **Team che vogliono un CRM di cui non dover mai
+  preoccuparsi.** Twenty premia i team che vogliono restare vicini ai
+  propri strumenti e plasmarli nel tempo. Se vuoi
+  qualcosa di completamente gestito, Pipedrive o
+  HubSpot andranno benissimo.
+* **Aziende che oggi hanno bisogno di centinaia di integrazioni predefinite.** Il nostro ecosistema sta crescendo rapidamente, ma non è ancora
+  così ampio come Salesforce o HubSpot. Se ti senti a tuo agio
+  nel costruire ciò che manca, lo amerai. Altrimenti, concedici
+  un altro anno.
+* **Organizzazioni in cui gli strumenti vengono scelti nelle sale riunioni,
+  non da chi li utilizza.** Non facciamo cene di gala
+  e briefing esecutivi. Vinciamo con i team che hanno
+  l'autorità di scegliere i propri strumenti.
+
+<Card title="Pronto per iniziare?" icon="rocket" href="/l/it/getting-started/quickstart">
+  Configura Twenty in meno di 5 minuti — sul cloud o in modalità self-hosted.
+</Card>

packages/twenty-docs/l/it/getting-started/key-features.mdx

@@ -0,0 +1,70 @@
+---
+title: Caratteristiche principali
+description: Una panoramica di tutto ciò che Twenty può fare — dai modelli di dati personalizzati all’automazione basata sull’AI.
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty è una piattaforma CRM completa di tutte le funzionalità. Ecco cosa puoi creare con essa.
+
+<CardGroup cols={2}>
+  <Card href="/l/it/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
+    <CardTitle>Modello di dati personalizzato</CardTitle>
+    Definisci l’esatta struttura dei dati di cui la tua azienda ha bisogno.
+    <br />Crea oggetti personalizzati, aggiungi campi personalizzati con oltre 20 tipi di campo e crea relazioni tra qualsiasi oggetto.
+  </Card>
+
+  <Card href="/l/it/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
+    <CardTitle>Viste e pipeline</CardTitle>
+    Passa da viste tabellari, bacheche Kanban e viste calendario.
+    <br />Filtra con logica AND/OR, ordina per più campi, raggruppa i record e salva viste personalizzate.
+  </Card>
+
+  <Card href="/l/it/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
+    <CardTitle>Workflow e automazione</CardTitle>
+    Automatizza qualsiasi processo aziendale senza scrivere codice.
+    <br />Attiva i workflow in base alle modifiche ai record, alle pianificazioni, alle azioni manuali o ai webhooks in ingresso.
+  </Card>
+
+  <Card href="/l/it/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
+    <CardTitle>Sincronizzazione calendario ed email</CardTitle>
+    Collega il tuo account Google Workspace o Microsoft 365.
+    <br />Email e eventi di calendario compaiono automaticamente sui relativi record CRM.
+  </Card>
+
+  <Card href="/l/it/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
+    <CardTitle>AI</CardTitle>
+    Agenti AI che lavorano in modo autonomo all’interno del tuo CRM — rispondendo alle domande, arricchendo i record ed eseguendo attività multi-step all’interno del tuo modello di autorizzazioni.
+  </Card>
+
+  <Card href="/l/it/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
+    <CardTitle>Dashboard e reportistica</CardTitle>
+    Crea dashboard personalizzate con widget in tempo reale.
+    <br />Monitora le metriche della pipeline, le performance del team e i KPI aziendali con grafici e filtri configurabili.
+  </Card>
+
+  <Card href="/l/it/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>Permessi e controllo accessi</CardTitle>
+    Controllo degli accessi basato sui ruoli a ogni livello — oggetti, campi e singoli record.
+    <br />Configura SSO con SAML o OIDC. I log di audit tracciano chi ha fatto cosa.
+  </Card>
+
+  <Card href="/l/it/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>API ed estendibilità</CardTitle>
+    Un’API a misura di sviluppatore che si adatta al tuo modello di dati personalizzato.
+    <br />Endpoint sia GraphQL che REST, con documentazione generata automaticamente per ogni workspace.
+  </Card>
+
+  <Card href="/l/it/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
+    <CardTitle>Importazione ed esportazione dei dati</CardTitle>
+    Importa dati da file CSV o tramite API.
+    <br />Mapping dei campi, rilevamento dei duplicati e gestione degli errori integrati. Esporta i tuoi dati in qualsiasi momento — nessun vincolo.
+  </Card>
+
+  <Card href="/l/it/developers/self-host/self-host" img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>Self-hosting</CardTitle>
+    Esegui Twenty sulla tua infrastruttura con un singolo comando Docker Compose.
+    <br />Pieno controllo sui tuoi dati, aggiornamenti in base alla tua pianificazione.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/it/getting-started/quickstart.mdx

@@ -0,0 +1,73 @@
+---
+title: Guida rapida
+description: Metti Twenty in funzione in meno di 5 minuti — sul cloud o in modalità self-hosted.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Registrati
+
+<Steps>
+  <Step title="Crea il tuo account">
+    Vai su [app.twenty.com](https://app.twenty.com) e registrati con Google, Microsoft o email.
+  </Step>
+  <Step title="Scegli la tua prova">
+    Scegli **30 giorni** (con carta) o **7 giorni** (senza carta). Entrambe includono accesso completo — contatti illimitati, integrazione email, oggetti personalizzati, API. Puoi cambiare piano o intervallo di fatturazione in qualsiasi momento.
+  </Step>
+  <Step title="Crea il tuo spazio di lavoro">
+    Dopo la conferma del pagamento tramite Stripe, imposterai il nome del tuo spazio di lavoro e il profilo utente. Puoi annullare in qualsiasi momento.
+  </Step>
+</Steps>
+
+<VimeoEmbed videoId="1185227242" title="Creare uno spazio di lavoro" />
+
+## Configura il tuo spazio di lavoro
+
+Una volta dentro, tre passaggi per rendere Twenty tuo:
+
+### 1. Collega la tua casella di posta
+
+Vai a **Impostazioni → Account** e collega il tuo account Google o Microsoft. Twenty importerà le tue email e gli eventi del calendario e creerà automaticamente contatti dalle interazioni. Stai usando un altro provider? Puoi aggiungere caselle di posta tramite SMTP o calendari tramite CalDAV dalla stessa pagina.
+
+<Note>Inizia da qui — collegare una casella di posta offre al tuo team un valore immediato con dati reali prima che tu personalizzi qualsiasi altra cosa.</Note>
+
+<VimeoEmbed videoId="1185416821" title="Collega la tua casella di posta" />
+
+### 2. Definisci il tuo modello di dati
+
+Vai a **Settings → Data Model** per creare oggetti e campi personalizzati. Alcune cose da sapere:
+
+* Gli oggetti e i campi personalizzati sono **illimitati in tutti i piani** — nessun upsell.
+* **Persone, Aziende e Opportunità** sono gli oggetti che mostrano email e riunioni sincronizzate. Usali come base e aggiungi campi per categorizzare (ad esempio, un campo `Person Type`) invece di creare oggetti separati che non avranno la cronologia delle email.
+* Due Persone non possono avere la stessa email. Due Aziende non possono avere lo stesso dominio.
+* Puoi disattivare i campi/oggetti standard di cui non hai bisogno e nascondere i campi dalle viste senza eliminarli.
+
+[Riferimento al modello di dati →](/l/it/user-guide/data-model/overview)
+
+<VimeoEmbed videoId="1185416793" title="Definisci il tuo modello di dati" />
+
+### 3. Importa i tuoi dati
+
+Usa il menu Comando (`Cmd+K` / `Ctrl+K`) per importare Persone, Aziende, Opportunità o qualsiasi oggetto personalizzato tramite CSV. Scarica prima il file di esempio per vedere il formato previsto. Limita i file a 10.000 record e rimuovi i duplicati di email/domini prima di importarli.
+
+[Guida alla migrazione dei dati →](/l/it/user-guide/data-migration/overview)
+
+<VimeoEmbed videoId="1185416775" title="Importa i tuoi dati" />
+
+## Prossimi passaggi
+
+<CardGroup cols={2}>
+  <Card title="Scopri il layout" icon="table-columns" href="/l/it/getting-started/core-concepts/layout">
+    Navigazione, viste, menu comandi, pannello laterale.
+  </Card>
+  <Card title="Crea workflow" icon="bolt" href="/l/it/user-guide/workflows/overview">
+    Automatizza i tuoi processi aziendali.
+  </Card>
+  <Card title="Crea viste" icon="table" href="/l/it/user-guide/layout/overview">
+    Tabella, kanban, calendario — filtra e ordina i tuoi dati.
+  </Card>
+  <Card title="Esplora le API" icon="plug" href="/l/it/developers/extend/api">
+    Schema-per-tenant REST e GraphQL.
+  </Card>
+</CardGroup>