​

Konfigürasyon Yönetimi

​

1. Yönetici Paneli Konfigürasyonu (Varsayılan)

IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # varsayılan

1. Twenty örneğinize erişin (genellikle http://localhost:3000)
2. Ayarlar / Yönetici Paneli / Konfigürasyon Değişkenleri yoluna gidin
3. Entegrasyonları, e-postayı, depolamayı ve daha fazlasını yapılandırın
4. Değişiklikler hemen yürürlüğe girer (çok konteynerli dağıtımlarda 15 saniye içinde)

• Kimlik Doğrulama - Google/Microsoft OAuth, şifre ayarları
• E-posta - SMTP ayarları, şablonlar, doğrulama
• Depolama - S3 yapılandırması, yerel depolama yolları
• Entegrasyonlar - Gmail, Google Calendar, Microsoft hizmetleri
• İş Akışı ve Hız Limiti - Yürütme sınırları, API daraltma
• Ve daha fazlası…

​

2. Yalnızca Ortam Değişkenleriyle Yapılandırma

IS_CONFIG_VARIABLES_IN_DB_ENABLED=false

1. .env dosyanızda IS_CONFIG_VARIABLES_IN_DB_ENABLED=false değerini ayarlayın
2. Tüm konfigürasyon değişkenlerini .env dosyanıza ekleyin
3. Değişikliklerin etkin olması için kapları yeniden başlatın
4. Yönetici paneli mevcut değerleri gösterir ancak bunları değiştiremez

​

Çoklu Çalışma Alanı Modu

​

Tek Çalışma Alanı Modu (Varsayılan)

IS_MULTIWORKSPACE_ENABLED=false  # default

• Her Twenty örneği başına bir çalışma alanı
• İlk kullanıcı otomatik olarak tam ayrıcalıklara sahip yönetici olur (canImpersonate ve canAccessFullAdminPanel)
• İlk çalışma alanı oluşturulduktan sonra yeni kayıtlar devre dışı bırakılır
• Basit URL yapısı: https://your-domain.com

​

Çoklu Çalışma Alanı Modunu Etkinleştirme

IS_MULTIWORKSPACE_ENABLED=true
DEFAULT_SUBDOMAIN=app  # default value

• Aynı örnek üzerinde birden fazla çalışma alanı oluşturulabilir
• Her çalışma alanı kendi alt alan adını alır (ör. sales.your-domain.com, marketing.your-domain.com)
• Kullanıcılar {DEFAULT_SUBDOMAIN}.your-domain.com adresinde kaydolur ve oturum açar (ör. app.your-domain.com)
• Otomatik yönetici ayrıcalıkları yoktur — her çalışma alanındaki ilk kullanıcı normal bir kullanıcıdır
• Alt alan adı ve özel alan adı gibi çalışma alanına özgü ayarlar, çalışma alanı ayarlarında kullanılabilir hale gelir

​

Çoklu Çalışma Alanı için DNS Yapılandırması

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

​

Çalışma Alanı Oluşturmayı Kısıtlama

IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true

​

Gmail ve Google Takvim Entegrasyonu

​

Google Cloud Projesi Oluştur

1. Google Cloud Konsolu adresine gidin
2. Yeni bir proje oluşturun veya mevcut bir projeyi seçin
3. Bu API’leri etkinleştirin:

• Gmail API
• Google Calendar API
• Kişiler API

​

OAuth’u Yapılandır

1. Kimlik Bilgileri sayfasına gidin
2. OAuth 2.0 İstemci Kimliği Oluştur
3. Bu yönlendirme URI’lerini ekleyin:
   • https://{your-domain}/auth/google/redirect (SSO için)
   • https://{your-domain}/auth/google-apis/get-access-token (entegrasyonlar için)

​

Twenty’de Yapılandır

1. Ayarlar → Yönetici Paneli → Konfigürasyon Değişkenleri bölümüne gidin
2. Google Auth bölümünü bulun
3. Bu değişkenleri ayarlayın:
   • 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

​

Uygulamanız test modunda ise

​

Microsoft 365 Entegrasyonu

​

Microsoft Azure’da bir proje oluştur

​

API’leri etkinleştir

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

​

Yetkili yönlendirme URI’leri

• https://{your-domain}/auth/microsoft/redirect Microsoft SSO kullanmak istiyorsanız
• https://{your-domain}/auth/microsoft-apis/get-access-token

​

Twenty’de Yapılandır

1. Ayarlar → Yönetici Paneli → Konfigürasyon Değişkenleri bölümüne gidin
2. Microsoft Auth bölümünü bulun
3. Bu değişkenleri ayarlayın:
   • 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

​

Kapsamları yapılandır

• ‘openid’
• ‘e-posta’
• ‘profil’
• ‘offline_access’
• ‘Mail.ReadWrite’
• ‘Mail.Send’
• ‘Calendars.Read’

​

Uygulamanız test modunda ise

​

Takvim ve Mesajlaşma için Arka Plan İşleri

# 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

​

E-posta Yapılandırması

1. Ayarlar → Yönetici Paneli → Konfigürasyon Değişkenleri bölümüne gidin
2. E-posta bölümünü bulun
3. SMTP ayarlarınızı yapılandırın:

​

Mantıksal işlevler

​

Kullanılabilir Sürücüler

​

Önerilen Yapılandırma

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