Saltar al contenido principal
La capa de lógica de una app de Twenty es el código que se ejecuta: controladores de TypeScript del lado del servidor que reaccionan a solicitudes HTTP, programaciones cron y cambios en registros; habilidades y agentes de IA que viven dentro del espacio de trabajo; y conexiones OAuth que permiten que tus funciones actúen en nombre de un usuario en servicios de terceros.
            ┌─ 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)   │
                                  └────────────────────────────┘

En esta sección

Funciones de lógica

El bloque de construcción principal: tipos de disparadores, cargas útiles y el cliente de API tipado.

Habilidades y agentes

Instrucciones reutilizables para agentes de IA y asistentes con mensajes de sistema personalizados.

Conexiones

Credenciales OAuth que tu app mantiene para servicios de terceros — Linear, GitHub, Slack y más.

Tipos de disparadores de un vistazo

Una función de lógica selecciona uno o más disparadores: cada entrada a continuación es un campo independiente en defineLogicFunction():
DisparadorCuándo se ejecutaConfiguración
Ruta HTTPUna solicitud llega a tu endpoint /s/\<path>httpRouteTriggerSettings
CronCoincide una expresión CRONcronTriggerSettings
Evento de base de datosSe crea, actualiza o elimina un registro del espacio de trabajodatabaseEventTriggerSettings
Herramienta de IAUna funcionalidad de IA de Twenty decide llamar a tu funcióntoolTriggerSettings
Acción del Flujo de TrabajoUn paso de flujo de trabajo invoca tu funciónworkflowActionTriggerSettings
Las funciones se ejecutan en un entorno aislado en procesos independientes de Node.js y acceden al espacio de trabajo a través de un cliente de API tipado con un ámbito limitado al rol declarado en defineApplication().
Hooks de instalación: el código que se ejecuta antes o después de la instalación comparte este entorno de ejecución pero usa sus propias funciones define y se encuentra en Config → Install Hooks.