​

Управление конфигурацией

​

1. Конфигурация панели администратора (по умолчанию)

IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # по умолчанию

1. Получите доступ к вашему экземпляру Twenty (обычно http://localhost:3000)
2. Перейдите в Настройки / Панель администратора / Переменные конфигурации
3. Настройте интеграции, почту, хранилище и многое другое
4. Изменения вступают в силу немедленно (в течение 15 секунд для многоконтейнерных развертываний)

• Аутентификация - Google/Microsoft OAuth, настройки паролей
• Электронная почта - настройки SMTP, шаблоны, верификация
• Хранилище - конфигурация S3, пути локального хранения
• Интеграции - Gmail, Google Calendar, сервисы Microsoft
• Рабочий процесс и Ограничения скорости - лимиты выполнения, ограничение API
• И многое другое…

​

2. Конфигурация только для среды

IS_CONFIG_VARIABLES_IN_DB_ENABLED=false

1. Установите IS_CONFIG_VARIABLES_IN_DB_ENABLED=false в своем .env файле
2. Добавьте все переменные конфигурации в ваш файл .env
3. Перезапустите контейнеры, чтобы изменения вступили в силу
4. Панель администратора будет показывать текущие значения, но не сможет их изменить

​

Режим нескольких рабочих пространств

​

Режим одного рабочего пространства (по умолчанию)

IS_MULTIWORKSPACE_ENABLED=false  # default

• Одно рабочее пространство на один экземпляр Twenty
• Первый пользователь автоматически становится администратором с полными привилегиями (canImpersonate и canAccessFullAdminPanel)
• Новые регистрации отключаются после создания первого рабочего пространства
• Простая структура URL: https://your-domain.com

​

Включение режима нескольких рабочих пространств

IS_MULTIWORKSPACE_ENABLED=true
DEFAULT_SUBDOMAIN=app  # default value

• На одном экземпляре можно создать несколько рабочих пространств
• Каждое рабочее пространство получает собственный поддомен (например, sales.your-domain.com, marketing.your-domain.com)
• Пользователи регистрируются и входят на {DEFAULT_SUBDOMAIN}.your-domain.com (например, app.your-domain.com)
• Нет автоматических привилегий администратора — первый пользователь в каждом рабочем пространстве является обычным пользователем
• Параметры, специфичные для рабочего пространства, такие как поддомен и пользовательский домен, становятся доступны в настройках рабочего пространства

​

Настройка DNS для режима нескольких рабочих пространств

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

​

Ограничение создания рабочих пространств

IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true

​

Интеграция Gmail и Google Calendar

​

Создайте проект в Google Cloud

1. Перейдите в Google Cloud Console
2. Создайте новый проект или выберите существующий
3. Включите следующие API:

• Gmail API
• Google Calendar API
• People API

​

Настройте OAuth

1. Перейдите к Учётные данные
2. Создайте OAuth 2.0 Client ID
3. Добавьте эти URI перенаправления:
   • https://{your-domain}/auth/google/redirect (для SSO)
   • https://{your-domain}/auth/google-apis/get-access-token (для интеграций)

​

Настройка в Twenty

1. Перейдите в Настройки → Панель администратора → Переменные конфигурации
2. Найдите раздел Google Auth.
3. Установите эти переменные:
   • 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

​

Если ваше приложение находится в тестовом режиме

​

Интеграция Microsoft 365

​

Создайте проект в Microsoft Azure

​

Включите API

• 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

​

Авторизованные URI перенаправления

• https://{your-domain}/auth/microsoft/redirect если вы хотите использовать Microsoft SSO
• https://{your-domain}/auth/microsoft-apis/get-access-token

​

Настройка в Twenty

1. Перейдите в Настройки → Панель администратора → Переменные конфигурации
2. Найдите раздел Microsoft Auth.
3. Установите эти переменные:
   • 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

​

Настройка областей доступа

• ‘openid’
• ‘электронная почта’
• ‘профиль’
• ‘offline_access’
• ‘Mail.ReadWrite’
• ‘Mail.Send’
• ‘Calendars.Read’

​

Если ваше приложение находится в тестовом режиме

​

Фоновые задания для Календаря и Сообщений

# из вашего контейнера рабочего
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

​

Конфигурация электронной почты

1. Перейдите в Настройки → Панель администратора → Переменные конфигурации
2. Найдите раздел Электронной почты.
3. Настройте параметры вашего SMTP:

​

Логические функции

​

Доступные драйверы

​

Рекомендуемая конфигурация

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