snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -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.

View File

@@ -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>

View File

@@ -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).

View File

@@ -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).

View File

@@ -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).

View File

@@ -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>