Salt la conținutul principal
Stratul de logică al unei aplicații Twenty este codul care rulează — handler-e TypeScript pe server care reacționează la cereri HTTP, programări cron și modificări ale înregistrărilor; abilități și agenți IA care trăiesc în workspace; și conexiuni OAuth care permit funcțiilor tale să acționeze în numele utilizatorului în servicii terțe.
            ┌─ HTTP route      ──┐
            │  Cron schedule     │
            │  Database event    │      ┌────────────────────┐
  triggers ─┤  AI tool call      ├─────▶│ Logic function     │
            │  Workflow action   │      │ (your handler)     │
            │  Manual exec       │      └────────────────────┘
            └────────────────────┘                │

                                  ┌────────────────────────────┐
                                  │ Twenty API (records)       │
                                  │ Third-party API            │
                                  │   (via Connection token)   │
                                  └────────────────────────────┘

În această secțiune

Funcții logice

Blocul de bază — tipuri de declanșatoare, payload-uri și clientul API cu tipuri.

Abilități și agenți

Instrucțiuni reutilizabile pentru agenți IA și asistenți cu prompturi de sistem personalizate.

Conexiuni

Credențiale OAuth pe care aplicația ta le deține pentru servicii terțe — Linear, GitHub, Slack și altele.

Tipuri de declanșatoare, dintr-o privire

O funcție de logică alege unul sau mai multe declanșatoare — fiecare intrare de mai jos este un câmp separat pe defineLogicFunction():
DeclanșatorCând ruleazăSetare
Rută HTTPO cerere ajunge la endpointul tău /s/\<path>httpRouteTriggerSettings
CronO expresie CRON se potriveștecronTriggerSettings
Eveniment de bază de dateO înregistrare din workspace este creată, actualizată sau ștearsădatabaseEventTriggerSettings
Instrument IAO funcționalitate IA din Twenty decide să apeleze funcția tatoolTriggerSettings
Acțiune WorkflowUn pas din workflow îți invocă funcțiaworkflowActionTriggerSettings
Funcțiile rulează în sandbox, în procese Node.js izolate și accesează workspace-ul printr-un client API cu tipuri, limitat la rolul declarat în defineApplication().
Hook-uri de instalare — cod care rulează înainte sau după instalare — folosesc același runtime, dar au propriile lor funcții define și se află sub Config → Install Hooks.