​

إدارة الإعدادات

​

1. إعداد لوحة الإدارة (افتراضي)

IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # افتراضي

1. الوصول إلى نسخة Twenty الخاصة بك (عادة http://localhost:3000)
2. اذهب إلى الإعدادات / لوحة الإدارة / متغيرات التكوين
3. اضبط التكاملات، والبريد الإلكتروني، والتخزين، والمزيد
4. تسري التغييرات على الفور (خلال 15 ثانية لعمليات النشر متعددة الحاويات)

• المصادقة - Google/Microsoft OAuth، إعدادات كلمة المرور
• البريد الإلكتروني - إعدادات SMTP، القوالب، التحقق
• التخزين - تكوين S3، مسارات التخزين المحلية
• التكاملات - Gmail، تقويم Google، خدمات Microsoft
• حدود التشغيل ومعدل التكنولوجيا - حدود التنفيذ، API الحد من السرعة
• والمزيد من الأمور…

​

2. إعداد بيئي فقط

IS_CONFIG_VARIABLES_IN_DB_ENABLED=false

1. قم بتعيين IS_CONFIG_VARIABLES_IN_DB_ENABLED=false في ملف .env الخاص بك
2. أضف جميع متغيرات الإعداد إلى ملف .env الخاص بك
3. أعد تشغيل الحاويات لتصبح التغييرات نافذة
4. ستظهر لوحة الإدارة القيم الحالية لكنها لن تتمكن من تعديلها

​

Multi-Workspace Mode

​

Single-Workspace Mode (Default)

IS_MULTIWORKSPACE_ENABLED=false  # default

• One workspace per Twenty instance
• First user automatically becomes admin with full privileges (canImpersonate and canAccessFullAdminPanel)
• New signups are disabled after the first workspace is created
• Simple URL structure: https://your-domain.com

​

Enabling Multi-Workspace Mode

IS_MULTIWORKSPACE_ENABLED=true
DEFAULT_SUBDOMAIN=app  # default value

• Multiple workspaces can be created on the same instance
• Each workspace gets its own subdomain (e.g., sales.your-domain.com, marketing.your-domain.com)
• Users sign up and log in at {DEFAULT_SUBDOMAIN}.your-domain.com (e.g., app.your-domain.com)
• No automatic admin privileges — first user in each workspace is a regular user
• Workspace-specific settings like subdomain and custom domain become available in workspace settings

​

DNS Configuration for Multi-Workspace

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

​

Restricting Workspace Creation

IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true

​

تكامل Gmail و Google Calendar

​

إنشاء مشروع Google Cloud

1. اذهب إلى وحدة تحكم السحابة من Google
2. أنشئ مشروعًا جديدًا أو اختر أحد المشاريع الموجودة
3. قم بتفعيل هذه الـ APIs:

• Gmail API
• Google Calendar API
• People API

​

تكوين OAuth

1. اذهب إلى بيانات اعتماد
2. قم بإنشاء معرف عميل OAuth 2.0
3. أضف هذه الـ URIs لإعادة التوجيه:
   • https://{your-domain}/auth/google/redirect (for SSO)
   • https://{your-domain}/auth/google-apis/get-access-token (for integrations)

​

الإعداد في 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

​

تمكين 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 لإعادة التوجيه المصرح بها

• https://{your-domain}/auth/microsoft/redirect if you want to use Microsoft SSO
• https://{your-domain}/auth/microsoft-apis/get-access-token

​

الإعداد في Twenty

1. اذهب إلى الإعدادات → لوحة الإدارة → متغيرات التكوين
2. Find the Microsoft Auth section
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

​

Configure scopes

• ‘openid’
• ‘البريد الإلكتروني’
• ‘profile’
• ‘offline_access’
• ‘Mail.ReadWrite’
• ‘Mail.Send’
• ‘Calendars.Read’

​

إذا كان تطبيقك في وضع الاختبار

​

Background Jobs for Calendar & Messaging

# 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

​

تكوين البريد الإلكتروني

1. اذهب إلى الإعدادات → لوحة الإدارة → متغيرات التكوين
2. Find the Email section
3. قم بضبط إعدادات SMTP الخاصة بك: