Saltar para o conteúdo principal
A camada de lógica de um app do Twenty é o código que é executado — manipuladores TypeScript do lado do servidor que reagem a solicitações HTTP, agendamentos CRON e alterações de registros; habilidades e agentes de IA que vivem dentro do workspace; e conexões OAuth que permitem que suas funções ajam em nome de um usuário em serviços de terceiros. 
            ┌─ 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)   │
                                  └────────────────────────────┘

​
Nesta seção

Funções lógicas

O bloco de construção principal — tipos de gatilho, payloads e o cliente de API tipado.

Habilidades e agentes

Instruções reutilizáveis para agentes de IA e assistentes com prompts de sistema personalizados.

Conexões

Credenciais OAuth que seu app mantém para serviços de terceiros — Linear, GitHub, Slack e outros.

​
Tipos de gatilho em resumo

Uma função de lógica escolhe um ou mais gatilhos — cada entrada abaixo é um campo separado em defineLogicFunction():
DisparadorQuando é executadoConfiguração
Rota HTTPUma solicitação atinge seu endpoint /s/\<path>httpRouteTriggerSettings
CronUma expressão CRON correspondecronTriggerSettings
Evento de banco de dadosUm registro do workspace é criado, atualizado ou excluídodatabaseEventTriggerSettings
Ferramenta de IAUm recurso de IA do Twenty decide chamar sua funçãotoolTriggerSettings
Ação de fluxo de trabalhoUma etapa de fluxo de trabalho invoca sua funçãoworkflowActionTriggerSettings
As funções são executadas em sandbox, em processos Node.js isolados, e acessam o workspace por meio de um cliente de API tipado, com escopo definido pelo papel declarado em defineApplication().
Ganchos de instalação — código que é executado antes ou depois da instalação — compartilham esse runtime, mas usam suas próprias funções define e ficam em Config → Install Hooks.