Passer au contenu principal
La couche logique d’une application Twenty est le code qui s’exécute — des gestionnaires TypeScript côté serveur qui réagissent aux requêtes HTTP, aux planifications CRON et aux modifications d’enregistrements ; des compétences et des agents d’IA qui résident dans l’espace de travail ; et des connexions OAuth qui permettent à vos fonctions d’agir au nom d’un utilisateur dans des services tiers.
            ┌─ 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)   │
                                  └────────────────────────────┘

Dans cette section

Fonctions logiques

Le bloc de construction principal — types de déclencheurs, charges utiles et client API typé.

Compétences et agents

Instructions d’agent IA réutilisables et assistants avec invites système personnalisées.

Connexions

Identifiants OAuth détenus par votre application pour des services tiers — Linear, GitHub, Slack, et plus encore.

Aperçu des types de déclencheurs

Une fonction logique choisit un ou plusieurs déclencheurs — chaque entrée ci-dessous est un champ distinct sur defineLogicFunction():
DéclencheurMoment d’exécutionParamètre
Route HTTPUne requête atteint votre point de terminaison /s/\<path>httpRouteTriggerSettings
CronUne expression CRON correspondcronTriggerSettings
Événement de base de donnéesUn enregistrement de l’espace de travail est créé, mis à jour ou supprimédatabaseEventTriggerSettings
Outil IAUne fonctionnalité IA de Twenty décide d’appeler votre fonctiontoolTriggerSettings
Action de flux de travailUne étape de flux de travail invoque votre fonctionworkflowActionTriggerSettings
Les fonctions s’exécutent dans un environnement isolé dans des processus Node.js sandboxés et accèdent à l’espace de travail via un client API typé, limité au rôle déclaré sur defineApplication().
Les hooks au moment de l’installation — du code qui s’exécute avant ou après l’installation — partagent ce runtime mais utilisent leurs propres fonctions define et se trouvent sous Config → Install Hooks.