Vai al contenuto principale

Cosa costruirai

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

Un modello, generato per una persona specifica, aperto come pagina stampabile.

Cosa imparerai

Ogni capitolo aggiunge una funzionalità. Alla fine avrai esplorato gran parte dell’SDK.

Prerequisiti

Dovresti aver completato il Quick Start: un workspace Twenty (cloud o locale) e la CLI autenticata a esso. Se il server o l’autenticazione non sono pronti, completa prima il Quick Start. Quindi crea e installa l’app del tutorial:
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 twenty app 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.
schema
Inizia a costruire →
Capitolo 1: modelli di documenti e modelli.