​

Gestionarea configurației

​

1. Configurare Panou Admin (Implicită)

IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # implicit

1. Accesați instanța dumneavoastră Twenty (de obicei http://localhost:3000)
2. Mergeți la Setări / Panou Admin / Variabile de Configurare
3. Configurați integrările, e-mailul, stocarea și multe altele
4. Schimbările intră în vigoare imediat (în termen de 15 secunde pentru implementări cu mai multe containere)

• Autentificare - OAuth Google/Microsoft, setări parole
• E-mail - setări SMTP, șabloane, verificare
• Stocare - configurație S3, căi stocare locală
• Integrări - Gmail, Google Calendar, servicii Microsoft
• Flux de lucru și limitarea ratei - limite de execuție, limitarea ratei pentru API
• Și multe altele…

​

2. Configurare Doar Mediu

IS_CONFIG_VARIABLES_IN_DB_ENABLED=false

1. Setați IS_CONFIG_VARIABLES_IN_DB_ENABLED=false în fișierul dvs. .env
2. Adăugați toate variabilele de configurare în fișierul dvs. .env
3. Reporniți containerele pentru ca schimbările să aibă efect
4. Panoul de administrare va afișa valorile curente, dar nu le poate modifica

​

Mod cu mai multe spații de lucru

​

Modul cu un singur spațiu de lucru (implicit)

IS_MULTIWORKSPACE_ENABLED=false  # default

• Un spațiu de lucru pentru fiecare instanță Twenty
• Primul utilizator devine automat administrator cu privilegii complete (canImpersonate și canAccessFullAdminPanel)
• Înregistrările noi sunt dezactivate după crearea primului spațiu de lucru
• Structură URL simplă: https://your-domain.com

​

Activarea modului cu mai multe spații de lucru

IS_MULTIWORKSPACE_ENABLED=true
DEFAULT_SUBDOMAIN=app  # default value

• Pe aceeași instanță pot fi create mai multe spații de lucru
• Fiecare spațiu de lucru primește propriul subdomeniu (de ex., sales.your-domain.com, marketing.your-domain.com)
• Utilizatorii se înregistrează și se autentifică la {DEFAULT_SUBDOMAIN}.your-domain.com (de ex., app.your-domain.com)
• Fără privilegii administrative automate — primul utilizator din fiecare spațiu de lucru este un utilizator obișnuit
• Setări specifice spațiului de lucru, precum subdomeniu și domeniu personalizat, devin disponibile în setările spațiului de lucru

​

Configurarea DNS pentru modul cu mai multe spații de lucru

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

​

Restricționarea creării de spații de lucru

IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true

​

Integrare Gmail & Google Calendar

​

Creați Proiect Google Cloud

1. Mergeți la Google Cloud Console
2. Creați un proiect nou sau selectați unul existent
3. Activați aceste API-uri:

• Gmail API
• Google Calendar API
• People API

​

Configurați OAuth

1. Mergeți la Credentials
2. Creați Client ID OAuth 2.0
3. Adăugați aceste URI-uri de redirecționare:
   • https://{your-domain}/auth/google/redirect (pentru SSO)
   • https://{your-domain}/auth/google-apis/get-access-token (pentru integrări)

​

Configurați în Twenty

1. Mergeți la Setări → Panou Admin → Variabile de Configurare
2. Găsiți secțiunea Autentificare Google
3. Setați aceste variabile:
   • 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

​

Dacă aplicația dvs. este în modul de test

​

Integrare Microsoft 365

​

Creați un proiect în Microsoft Azure

​

Activați API-urile

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

​

URIs de redirecționare autorizate

• https://{your-domain}/auth/microsoft/redirect dacă doriți să utilizați SSO Microsoft
• https://{your-domain}/auth/microsoft-apis/get-access-token

​

Configurați în Twenty

1. Mergeți la Setări → Panou Admin → Variabile de Configurare
2. Găsiți secțiunea Autentificare Microsoft
3. Setați aceste variabile:
   • 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

​

Configurați scopurile

• ‘openid’
• ‘email’
• ‘profil’
• ‘offline_access’
• ‘Mail.ReadWrite’
• ‘Mail.Send’
• ‘Calendars.Read’

​

Dacă aplicația dvs. este în modul de test

​

Procese în fundal pentru Calendar și Mesagerie

# 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

​

Configurare Email

1. Mergeți la Setări → Panou Admin → Variabile de Configurare
2. Găsiți secțiunea Email
3. Configurați setările dvs. SMTP:

​

Funcții logice

​

Drivere disponibile

​

Configurație recomandată

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