Vai al contenuto principale
In questo tutorial creerai Document Generator, un’app che trasforma modelli riutilizzabili in documenti personalizzati usando i dati già presenti nel tuo CRM. Scrivi un modello una sola volta con {{placeholders}}, quindi genera un documento compilato per qualsiasi Persona o Azienda con un solo clic — dal menu dei comandi, da un agente IA o da un workflow.
Un documento di proposta di vendita generato

​
Cosa imparerai

Ogni capitolo aggiunge una funzionalità. Alla fine avrai esplorato gran parte dell’SDK.
CapitoloFunzionalitàRiferimento
1. Modello datiOggetti, campi e una relazioneDati
2. Generare documentiUna funzione logica (strumento IA + azione del workflow) che compila un modello Markdown e allega un PDF rifinitoFunzioni logiche
3. Rotte HTTPServire JSON e una pagina HTML condivisibile dalle rotteFunzioni logiche
4. Creare l’interfaccia utenteViste, navigazione, menu dei comandi e componenti front-end che mostrano l’anteprima di un documento e modificano un modelloLayout
5. Un agente IAAgente + abilitàAbilità e agenti
6. PubblicazionePubblicala nel marketplacePubblicazione

​
Prerequisiti

Dovresti aver completato il Quick Start: un server Twenty locale in esecuzione sulla porta 2020 e la CLI autenticata ad esso. In caso contrario, esegui ora lo scaffold e avvialo: 
npx create-twenty-app@latest document-generator
cd document-generator
yarn twenty dev
Preferisci leggere il codice finito? L’app completa si trova in packages/twenty-apps/examples/document-generator. Ogni snippet qui sotto è copiato da lì.

​
Come è strutturata l’app

Un modello con segnaposto viene trasformato in un documento rifinito con un PDF, attivato dal menu dei comandi, da un agente IA, da un workflow o da un link condivisibile
Scrivi un modello una sola volta in un editor rich text, con {{placeholders}}. Scegliendo un modello e un record del CRM si compilano i segnaposto e si salva un documento rifinito (con un file PDF). Tutto il resto — il menu dei comandi, l’agente IA, lo step del workflow, il link condivisibile — è solo un modo diverso di attivare quell’unico generatore.

​
Mantieni attivo questo ciclo

Lascia yarn twenty dev in esecuzione in un terminale per l’intero tutorial. Ogni volta che aggiungi o modifichi un file sotto src/, viene nuovamente sincronizzato con il tuo server entro pochi secondi, così puoi vedere ogni funzionalità comparire nell’interfaccia utente mentre la costruisci.

Inizia a sviluppare →

Capitolo 1: modella documenti e modelli.