​

Gestión de Configuración

​

1. Configuración del Panel de Administración (Predeterminado)

IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # default

1. Acceda a su instancia de Twenty (normalmente http://localhost:3000)
2. Vaya a Configuración / Panel de Administración / Variables de Configuración
3. Configure integraciones, correo electrónico, almacenamiento y más
4. Los cambios se aplican inmediatamente (dentro de 15 segundos para implementaciones multicontenedor)

• Autenticación - OAuth de Google/Microsoft, configuración de contraseñas
• Correo Electrónico - Configuración de SMTP, plantillas, verificación
• Almacenamiento - Configuración S3, rutas de almacenamiento local
• Integraciones - Gmail, Google Calendar, servicios de Microsoft
• Flujo de Trabajo y Limitación de Tasas - Límites de ejecución, restricción de API
• Y mucho más…

​

2. Configuración Solo de Entorno

IS_CONFIG_VARIABLES_IN_DB_ENABLED=false

1. Establezca IS_CONFIG_VARIABLES_IN_DB_ENABLED=false en su archivo .env
2. Agregue todas las variables de configuración a su archivo .env
3. Reinicie los contenedores para que los cambios tengan efecto
4. El panel de administración mostrará los valores actuales pero no podrá modificarlos

​

Modo de múltiples espacios de trabajo

​

Modo de un solo espacio de trabajo (predeterminado)

IS_MULTIWORKSPACE_ENABLED=false  # default

• Un espacio de trabajo por instancia de Twenty
• El primer usuario se convierte automáticamente en administrador con privilegios completos (canImpersonate y canAccessFullAdminPanel)
• Los nuevos registros se deshabilitan después de crear el primer espacio de trabajo
• Estructura de URL simple: https://your-domain.com

​

Habilitar el modo de múltiples espacios de trabajo

IS_MULTIWORKSPACE_ENABLED=true
DEFAULT_SUBDOMAIN=app  # default value

• Se pueden crear varios espacios de trabajo en la misma instancia
• Cada espacio de trabajo obtiene su propio subdominio (p. ej., sales.your-domain.com, marketing.your-domain.com)
• Los usuarios se registran e inician sesión en {DEFAULT_SUBDOMAIN}.your-domain.com (p. ej., app.your-domain.com)
• Sin privilegios de administrador automáticos — el primer usuario de cada espacio de trabajo es un usuario normal
• Configuraciones específicas del espacio de trabajo, como subdominio y dominio personalizado, están disponibles en la configuración del espacio de trabajo

​

Configuración de DNS para múltiples espacios de trabajo

*.your-domain.com -> your-server-ip

​

Restricción de la creación de espacios de trabajo

IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true

​

Integración con Gmail y Google Calendar

​

Crear Proyecto en Google Cloud

1. Vaya a Google Cloud Console
2. Cree un nuevo proyecto o seleccione uno existente
3. Habilite estas APIs:

• Gmail API
• Google Calendar API
• People API

​

Configurar OAuth

1. Vaya a Credenciales
2. Cree un ID de Cliente OAuth 2.0
3. Agregue estas URIs de redirección:
   • https://{your-domain}/auth/google/redirect (para SSO)
   • https://{your-domain}/auth/google-apis/get-access-token (para integraciones)

​

Configurar en Twenty

1. Vaya a Configuración → Panel de Administración → Variables de Configuración
2. Encuentre la sección Google Auth
3. Establezca estas variables:
   • MESSAGING_PROVIDER_GMAIL_ENABLED=true
   • CALENDAR_PROVIDER_GOOGLE_ENABLED=true
   • AUTH_GOOGLE_CLIENT_ID={client-id}
   • AUTH_GOOGLE_CLIENT_SECRET={client-secret}
   • AUTH_GOOGLE_CALLBACK_URL=https://{your-domain}/auth/google/redirect
   • AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token

• https://www.googleapis.com/auth/calendar.events
• https://www.googleapis.com/auth/gmail.readonly
• https://www.googleapis.com/auth/profile.emails.read

​

Si su aplicación está en modo de prueba

​

Integración con Microsoft 365

​

Cree un proyecto en Microsoft Azure

​

Habilitar APIs

• Microsoft Graph: Mail.ReadWrite
• Microsoft Graph: Mail.Send
• Microsoft Graph: Calendars.Read
• Microsoft Graph: User.Read
• Microsoft Graph: openid
• Microsoft Graph: email
• Microsoft Graph: profile
• Microsoft Graph: offline_access

​

URIs de redirección autorizadas

• https://{your-domain}/auth/microsoft/redirect si quieres usar el inicio de sesión único de Microsoft
• https://{your-domain}/auth/microsoft-apis/get-access-token

​

Configurar en Twenty

1. Vaya a Configuración → Panel de Administración → Variables de Configuración
2. Encuentre la sección Microsoft Auth
3. Establezca estas variables:
   • MESSAGING_PROVIDER_MICROSOFT_ENABLED=true
   • CALENDAR_PROVIDER_MICROSOFT_ENABLED=true
   • AUTH_MICROSOFT_ENABLED=true
   • AUTH_MICROSOFT_CLIENT_ID={client-id}
   • AUTH_MICROSOFT_CLIENT_SECRET={client-secret}
   • AUTH_MICROSOFT_CALLBACK_URL=https://{your-domain}/auth/microsoft/redirect
   • AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token

​

Configurar ámbitos

• ‘openid’
• ‘correo Electrónico’
• ‘perfil’
• ‘offline_access’
• ‘Mail.ReadWrite’
• ‘Mail.Send’
• ‘Calendars.Read’

​

Si su aplicación está en modo de prueba

​

Trabajos en segundo plano para Calendarios y Mensajes

# from your worker container
yarn command:prod cron:messaging:messages-import
yarn command:prod cron:messaging:message-list-fetch
yarn command:prod cron:calendar:calendar-event-list-fetch
yarn command:prod cron:calendar:calendar-events-import
yarn command:prod cron:messaging:ongoing-stale
yarn command:prod cron:calendar:ongoing-stale
yarn command:prod cron:workflow:automated-cron-trigger

​

Configuración de Correo Electrónico

1. Vaya a Configuración → Panel de Administración → Variables de Configuración
2. Encuentre la sección Correo Electrónico
3. Configure su configuración SMTP:

​

Funciones de lógica

​

Controladores disponibles

​

Configuración recomendada

SERVERLESS_TYPE=LOCAL  # default

SERVERLESS_TYPE=LAMBDA
SERVERLESS_LAMBDA_REGION=us-east-1
SERVERLESS_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
SERVERLESS_LAMBDA_ACCESS_KEY_ID=your-access-key
SERVERLESS_LAMBDA_SECRET_ACCESS_KEY=your-secret-key

SERVERLESS_TYPE=DISABLED