​

Správa konfigurace

​

1. Konfigurace Admin panelu (výchozí)

IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # výchozí

1. Přistupte ke své instanci Twenty (obvykle http://localhost:3000)
2. Jděte na Nastavení / Admin panel / Konfigurační proměnné
3. Nakonfigurujte integrace, e-mail, úložiště a další
4. Změny se projeví okamžitě (u nasazení s více kontejnery do 15 sekund)

• Autentizace - Google/Microsoft OAuth, nastavení hesla
• E-mail - nastavení SMTP, šablony, ověření
• Úložiště - konfigurace S3, místní cesty k úložišti
• Integrace - Gmail, Google Kalendář, služby Microsoft
• Pracovní postup & Omezení rychlosti - limity provádění, škrcení API
• A ještě mnohem více…

​

2. Konfigurace pouze přes prostředí

IS_CONFIG_VARIABLES_IN_DB_ENABLED=false

1. Nastavte IS_CONFIG_VARIABLES_IN_DB_ENABLED=false ve vašem souboru .env
2. Přidejte všechny konfigurační proměnné do souboru .env
3. Restartujte kontejnery, aby se změny projevily
4. Administrační panel zobrazí aktuální hodnoty, ale nemůže je upravovat

​

Režim více pracovních prostorů

​

Režim jednoho pracovního prostoru (výchozí)

IS_MULTIWORKSPACE_ENABLED=false  # default

• Jeden pracovní prostor na instanci Twenty
• První uživatel se automaticky stává administrátorem s plnými oprávněními (canImpersonate a canAccessFullAdminPanel)
• Po vytvoření prvního pracovního prostoru jsou nové registrace zakázány.
• Jednoduchá struktura URL: https://your-domain.com

​

Povolení režimu více pracovních prostorů

IS_MULTIWORKSPACE_ENABLED=true
DEFAULT_SUBDOMAIN=app  # default value

• Na téže instanci lze vytvářet více pracovních prostorů
• Každý pracovní prostor získá vlastní subdoménu (např. sales.your-domain.com, marketing.your-domain.com)
• Uživatelé se registrují a přihlašují na {DEFAULT_SUBDOMAIN}.your-domain.com (např. app.your-domain.com)
• Žádná automatická administrátorská oprávnění — první uživatel v každém pracovním prostoru je běžný uživatel
• Nastavení specifická pro pracovní prostor, jako je subdoména a vlastní doména, se zpřístupní v nastavení pracovního prostoru

​

Konfigurace DNS pro více pracovních prostorů

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

​

Omezení vytváření pracovních prostorů

IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true

​

Integrace Gmail & Google Kalendář

​

Vytvořte projekt Google Cloud

1. Přejděte na Google Cloud Console
2. Vytvořte nový projekt nebo vyberte existující
3. Povolte tyto API:

• Gmail API
• Google Calendar API
• People API

​

Konfigurace OAuth

1. Přejděte na Pověření
2. Vytvořte OAuth 2.0 Client ID
3. Přidejte tyto URI přesměrování:
   • https://{your-domain}/auth/google/redirect (pro SSO)
   • https://{your-domain}/auth/google-apis/get-access-token (pro integrace)

​

Konfigurace v Twenty

1. Jděte na Nastavení → Admin panel → Konfigurační proměnné
2. Najděte sekci Google Auth
3. Nastavte tyto proměnné:
   • 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

​

Pokud je vaše aplikace v testovacím režimu

​

Integrace Microsoft 365

​

Vytvořte projekt v Microsoft Azure

​

Povoleňte 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

​

Autorizované URI přesměrování

• https://{your-domain}/auth/microsoft/redirect, pokud chcete použít Microsoft SSO
• https://{your-domain}/auth/microsoft-apis/get-access-token

​

Konfigurace v Twenty

1. Jděte na Nastavení → Admin panel → Konfigurační proměnné
2. Najděte sekci Microsoft Auth
3. Nastavte tyto proměnné:
   • 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

​

Konfigurace rozsahů

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

​

Pokud je vaše aplikace v testovacím režimu

​

Pracovní úkoly pro Kalendář & Zprávy

# z vašeho pracovního kontejneru
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

​

Konfigurace Emailu

1. Jděte na Nastavení → Admin panel → Konfigurační proměnné
2. Najděte sekci E-mail
3. Nakonfigurujte své nastavení SMTP:

​

Logické funkce

​

Dostupné ovladače

​

Doporučená konfigurace

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