Cosa copre lo strato logico
Il livello logico di un’app Twenty è il codice che viene eseguito — handler TypeScript lato server che reagiscono a richieste HTTP, pianificazioni cron e modifiche ai record; skill e agenti di AI che vivono all’interno dello spazio di lavoro; connessioni (OAuth o un flusso di accesso personalizzato) che permettono alle tue funzioni di agire per conto dell’utente in servizi di terze parti; e canali di messaggistica che portano una posta in arrivo esterna in Twenty.In questa sezione
Funzioni Logiche
Il blocco principale — tipi di attivazione, payload, e il client API digitato.
Skills & Agents
Istruzioni per l’agente IA riutilizzabile e assistenti con suggerimenti di sistema personalizzati.
Flussi di lavoro
Flussi di lavoro pronti installati con la tua app: inneschi, passaggi e come vengono eseguiti.
Connessioni
credenziali OAuth la tua app contiene per servizi di terze parti — Linear, GitHub, Slack e altro ancora.
Canali di messaggistica
Portare le conversazioni da qualsiasi provider nei record di thread di messaggi e messaggi di Twenty’s — threading e de-duplicazione inclusi.Posta in arrivo
Pubblica messaggi nella posta in arrivo dei membri da funzioni logiche e componenti front-end.
Key-Value Store
Mantenere lo stato tra le funzioni logiche gira: cache, cursori, e rivendicazioni cross-workspace.
Background Jobs
Accoda una funzione logica eseguita sui lavoratori per superare il timeout per-time.
Charging Credits
Dichiara ciò che le tue app fatturano e carica crediti workspace per esso.Tipi di trigger in sintesi
Una funzione logica sceglie uno o più trigger — ogni voce qui sotto è un campo separato sudefineLogicFunction():
Le funzioni vengono eseguite in sandbox in processi Node.js isolati e accedono allo spazio di lavoro tramite un client API tipizzato, limitato al ruolo dichiarato su
defineApplication().
Hook di installazione — codice che viene eseguito prima o dopo l’installazione — condividono questo runtime ma usano le proprie funzioni define e risiedono in Config → Install Hooks.Anche il controllo dello stato lo condivide. Un’app dichiara un controllo senza trigger. Per impostazione predefinita, Twenty chiama il proprio gestore senza argomenti quando si aprono le impostazioni dell’app dell’area di lavoro. Imposta
runOnUserPreferences: true per eseguirlo invece nella pagina delle preferenze App di un membro, con il relativo userWorkspaceId obbligatorio.