الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

يرشدك هذا الدليل خلال عملية استيراد شركاتك إلى Twenty. يجب استيراد الشركات أولًا لأن الأشخاص والفرص ترتبط بالشركات.

​
قبل أن تبدأ

​
قائمة المتطلبات المسبقة

يجب أن يكون ملفك بتنسيق CSV أو XLSX أو XLS
يحتوي الملف على أقل من 10,000 سجل
لا توجد نطاقات مكررة في ملفك
جميع الحقول المخصصة موجودة في Settings → Data Model
هل تحتاج إلى استيراد أكثر من 10,000 شركة؟ قسّم إلى ملفات متعددة أو استخدم استيراد عبر API.

​
الخطوة 1: جهّز بيانات شركتك

​
الحقول المطلوبة والمُوصى بها

الحقلهل هو مطلوب؟التنسيقالملاحظات
Nameمُوصى بهنصاسم العرض للشركة
النطاقمُوصى بهhttps://domain.comمعرّف فريد
العنواناختياريأعمدة متعددةانظر أدناه
الموظفوناختياريرقمعدد الموظفين
الحقول المخصصةاختيارييختلفيجب أن تكون موجودة في Data Model

​
تنسيق النطاق

استخدم التنسيق https://domain.com للنطاقات.هذا يطابق التنسيق المستخدم عند إنشاء الشركات تلقائيًا من مزامنة البريد الإلكتروني/التقويم، مما يمنع التكرارات لاحقًا.
أعمدة النطاق:
  • Domain / Domain Label: acme.com
  • Domain / Domain URL: https://acme.com

​
تنسيق العنوان

العنوان حقل متداخل يتضمن أعمدة متعددة: 
Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
123 Main Street,San Francisco,CA,USA,94105

​
بنية CSV نموذجية

name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
Widget Co,https://widgets.co,widgets.co,New York,USA,50
نصيحة احترافية: انقر Download sample file أثناء الاستيراد للاطلاع على أسماء الأعمدة الدقيقة التي تتوقعها Twenty.

​
الخطوة 2: الوصول إلى ميزة الاستيراد

الخيار 1: من عرض الشركات
  1. انتقل إلى Companies في الشريط الجانبي الأيسر
  2. انقر على أيقونة ⋮ في أعلى اليمين
  3. اختر Import records
الخيار 2: باستخدام قائمة الأوامر
  1. اضغط Cmd + K (Mac) أو Ctrl + K (Windows)
  2. اكتب “import”
  3. اختر Import records
  4. اختر Companies

​
الخطوة 3: حمّل ملفك

  1. انقر فوق Select file
  2. اختر ملف CSV أو XLSX أو XLS الخاص بك
  3. انتظر حتى تقوم Twenty بتحليل ملفك

​
الخطوة 4: طابق أعمدتك

يحاول Twenty تلقائيًا مطابقة أعمدتك مع الحقول. راجع وعدّل:
  1. تحقق من المطابقات التلقائية — تأكد من أنها صحيحة
  2. أصلح المطابقات غير الصحيحة — انقر على القائمة المنسدلة لاختيار الحقل الصحيح
  3. تخطَّ الأعمدة — اختر Do not map للأعمدة التي لا تريد استيرادها

​
قواعد مطابقة مهمة

  • النطاق: طابق مع Domain / Domain URL (وليس Domain Label)
  • العنوان: طابق كل جزء مع العمود المحدد له (المدينة، الولاية، إلخ.)
  • حقول الاختيار: يجب أن تطابق القيم الخيارات الموجودة (أو ستقوم بمطابقتها في الخطوة التالية)

​
الخطوة 5: تعيين قيم حقل الاختيار

إذا كانت لديك حقول اختيار أو اختيار متعدد:
  1. تعرض Twenty قيمك إلى جانب الخيارات الموجودة
  2. طابِق كل قيمة في ملفك مع خيار في Twenty
  3. أو أنشئ خيارات جديدة عند الحاجة
تستخدم خيارات الاختيار أسماء API، وليس تسميات العرض. تحقّق من Settings → Data Model → فعِّل Advanced mode لمشاهدة أسماء API.

​
الخطوة 6: مراجعة الأخطاء وإصلاحها

قبل إكمال الاستيراد، تقوم Twenty بالتحقق من صحة بياناتك:
  1. انقر على الخطوات التالية
  2. يتم تمييز الصفوف التي تحتوي على أخطاء باللون الأصفر
  3. أصلِح الأخطاء مباشرةً — انقر على خلية وعدّل القيمة
  4. أزِل الصفوف التي بها مشكلات — انقر على X لتخطي ذلك الصف

​
أخطاء شائعة عند استيراد الشركات

خطأالسببالحل
نطاق مكررالنطاق موجود مسبقًا في Twentyأزِل من الملف أو حدِّث السجل الموجود
تنسيق نطاق غير صالحتنسيق غير صحيحاستخدم https://domain.com
حقل مطلوب مفقودالحقل المطلوب فارغاملأ القيمة أو أزِل الصف

​
الخطوة 7: إكمال الاستيراد

  1. راجِع ملخص الاستيراد
  2. انقر على تأكيد للاستيراد
  3. انتظر حتى يكتمل الاستيراد
  4. تحقق بمراجعة عدد قليل من السجلات

​
بعد استيراد الشركات

يمكنك الآن استيراد السجلات التي ترتبط بالشركات:
  1. استيراد الأشخاص — اربطهم بالشركات باستخدام النطاق
  2. استورد الفرص — اربطها بالشركات
  3. تحقق من الاستيراد — افحص عينة من السجلات للتأكد من أن البيانات صحيحة

​
تحديث الشركات الموجودة

لتحديث الشركات بدلًا من إنشاء شركات جديدة:
  1. ضمّن عمود domain أو id في ملفك
  2. تقوم Twenty بمطابقة السجلات باستخدام هذا المعرّف الفريد
  3. يتم تحديث الشركات الموجودة؛ ويتم إنشاء شركات جديدة
راجع كيفية تحديث السجلات الموجودة للتفاصيل.

​
الأسئلة الشائعة

النطاق معرّف فريد في Twenty. هذا يمنع تكرار الشركات ويضمن أن مزامنة البريد الإلكتروني تربط الرسائل بالشركة الصحيحة على نحو صحيح.
يمكنك ترك النطاق فارغًا. ومع ذلك، نوصي بإضافة النطاقات عندما يكون ذلك ممكنًا لتحسين جودة البيانات والربط التلقائي للبريد الإلكتروني.
نعم! يمكنك استيراد الشركات أولاً، ثم استيراد الأشخاص لاحقًا وربطهم باستخدام نطاق الشركة.
إذا تضمّنت معرّفًا فريدًا (نطاقًا أو id) يطابق شركةً موجودة، يقوم Twenty بتحديث تلك الشركة بدلاً من إنشاء نسخة مكررة.
إمّا أن تزيل النسخة المكررة من ملفك، أو تُدرج id الخاصة بالشركة لتحديث السجل الموجود بدلًا من ذلك.

​
استكشاف الأخطاء وإصلاحها

هل تواجه مشكلات؟ اطّلع على: