نظرة عامة
يرشدك هذا الدليل خلال عملية استيراد جهات الاتصال (الأشخاص) إلى Twenty.قبل أن تبدأ
قائمة المتطلبات المسبقة
يجب أن يكون ملفك بتنسيق CSV أو XLSX أو XLS
يحتوي الملف على أقل من 10,000 سجل
لا توجد عناوين بريد إلكتروني مكررة في ملفك
استيراد الشركات أولًا (إذا كنت تربط الأشخاص بالشركات)
جميع الحقول المخصصة موجودة في Settings → Data Model
الخطوة 1: جهّز بيانات جهات الاتصال الخاصة بك
الحقول المطلوبة والمُوصى بها
تنسيق البريد الإلكتروني
- يجب أن يكون بتنسيق بريد إلكتروني صالح:
name@domain.com - يجب أن يكون فريدًا — لا تكرارات في ملفك أو في Twenty
- للعناوين الإضافية للبريد الإلكتروني، استخدم عمود Emails / Additional Emails:
تنسيق الهاتف
الهاتف هو حقل متداخل يتطلب أعمدة متعددة:الربط بالشركات
أضف عمودًا يضم المعرّف الفريد للشركة:استخدم تنسيق عنوان URL للنطاق (
https://acme.com)، وليس التسمية. هذا يطابق كيفية تخزين الشركات في Twenty.بنية CSV نموذجية
نصيحة احترافية: انقر Download sample file أثناء الاستيراد أو صدّر عددًا قليلًا من الأشخاص الموجودين للاطلاع على أسماء الأعمدة الدقيقة التي تتوقعها Twenty.
الخطوة 2: الوصول إلى ميزة الاستيراد
الخيار 1: من عرض People- انتقل إلى People في الشريط الجانبي الأيسر
- انقر على أيقونة ⋮ في أعلى اليمين
- اختر Import records
- اضغط
Cmd + K(Mac) أوCtrl + K(Windows) - اكتب “import”
- اختر Import records
- اختر People
الخطوة 3: حمّل ملفك
- انقر فوق Select file
- اختر ملف CSV أو XLSX أو XLS الخاص بك
- انتظر حتى يقوم Twenty بتحليل ملفك
الخطوة 4: طابق أعمدتك
يحاول Twenty تلقائيًا مطابقة أعمدتك مع الحقول. راجع وعدّل:- تحقق من المطابقات التلقائية — تأكد من أنها صحيحة
- أصلح المطابقات غير الصحيحة — انقر على القائمة المنسدلة لاختيار الحقل الصحيح
- تخطَّ الأعمدة — اختر Do not map للأعمدة التي لا تريد استيرادها
قواعد مطابقة مهمة

مطابقة علاقة الشركة
عند مطابقة عمود الشركة:- اعثر على عمود مرجع الشركة (مثلًا،
companyDomain) - طابقه مع حقل علاقة Company
- سيقوم Twenty بربط كل شخص بالشركة المطابقة
الخطوة 5: تعيين قيم حقل الاختيار
إذا كانت لديك حقول اختيار أو اختيار متعدد (مثل مصدر العميل المحتمل):- تعرض Twenty قيمك إلى جانب الخيارات الموجودة
- طابِق كل قيمة في ملفك مع خيار في Twenty
- أو أنشئ خيارات جديدة عند الحاجة
تستخدم خيارات الاختيار أسماء API، وليس تسميات العرض. تحقّق من الإعدادات → نموذج البيانات → فعِّل الوضع المتقدم لمشاهدة أسماء API.
الخطوة 6: مراجعة الأخطاء وإصلاحها
قبل إكمال الاستيراد، تقوم Twenty بالتحقق من صحة بياناتك:- انقر على الخطوات التالية
- يتم تمييز الصفوف التي تحتوي على أخطاء باللون الأصفر
- أصلِح الأخطاء مباشرةً — انقر على خلية وعدّل القيمة
- أزِل الصفوف التي بها مشكلات — انقر على X لتخطي ذلك الصف
أخطاء شائعة عند استيراد جهات الاتصال
الخطوة 7: إكمال الاستيراد
- راجِع ملخص الاستيراد
- انقر على تأكيد للاستيراد
- انتظر حتى يكتمل الاستيراد
- تحقَّق بفحص عدد قليل من السجلات وروابطها بالشركة
بعد استيراد جهات الاتصال
جهات الاتصال الخاصة بك موجودة الآن في Twenty! الخطوات التالية:- تحقَّق من روابط الشركة — افتح عددًا قليلًا من سجلات الأشخاص للتأكد من أنها مرتبطة بالشركة الصحيحة
- استورد الفرص — واربطها عند الحاجة بالأشخاص والشركات
- اضبط مزامنة البريد الإلكتروني — وصّل صندوق بريدك لعرض سجل البريد الإلكتروني في سجلات جهات الاتصال
تحديث جهات الاتصال الموجودة
لتحديث جهات الاتصال بدلًا من إنشاء جهات جديدة:- ضمّن عمود
emailأوidفي ملفك - تقوم Twenty بمطابقة السجلات باستخدام هذا المعرّف الفريد
- يتم تحديث جهات الاتصال الموجودة؛ ويتم إنشاء جهات جديدة
الأسئلة الشائعة
لماذا لا يمكن لشخصين أن يمتلكا البريد الإلكتروني نفسه؟
لماذا لا يمكن لشخصين أن يمتلكا البريد الإلكتروني نفسه؟
البريد الإلكتروني معرّف فريد في Twenty. هذا يمنع تكرار جهات الاتصال ويضمن أن مزامنة البريد الإلكتروني تربط الرسائل بالشخص الصحيح على نحوٍ صحيح.
ماذا لو كان لديّ أشخاص بلا بريد إلكتروني؟
ماذا لو كان لديّ أشخاص بلا بريد إلكتروني؟
يمكنك ترك البريد الإلكتروني فارغًا. مع ذلك، نوصي بإضافة عناوين البريد الإلكتروني عندما يكون ذلك ممكنًا لتحسين جودة البيانات ووظائف مزامنة البريد الإلكتروني.
كيف أربط الأشخاص بالشركات أثناء الاستيراد؟
كيف أربط الأشخاص بالشركات أثناء الاستيراد؟
أضِف عمودًا يحتوي على نطاق الشركة (مثلًا،
https://acme.com) أو المعرّف. أثناء عملية التعيين، اربط هذا العمود بحقل علاقة الشركة.ماذا لو لم تكن الشركة موجودة بعد؟
ماذا لو لم تكن الشركة موجودة بعد؟
استورد الشركات أولًا، ثم استورد الأشخاص. يجب أن تكون الشركة موجودة قبل أن تتمكّن من الإشارة إليها.
هل يمكنني استيراد المعرّف من نظام إدارة علاقات العملاء (CRM) السابق لديّ؟
هل يمكنني استيراد المعرّف من نظام إدارة علاقات العملاء (CRM) السابق لديّ؟
نعم! أنشئ حقلًا مخصصًا موسومًا بأنه “unique” في نموذج بياناتك لتخزين المعرّف الخارجي. ملاحظة: اسم الحقل
id محجوز للمعرّف الداخلي الخاص بـ Twenty.كيف أصلِح أخطاء 'العلاقة غير موجودة'؟
كيف أصلِح أخطاء 'العلاقة غير موجودة'؟
الشركة التي تشير إليها غير موجودة. إما أن تستورد الشركة أولًا، أو تأكّد من أن النطاق/المعرّف يطابق تمامًا شركةً موجودة.