Skip to main content

نظرة عامة

يرشدك هذا الدليل خلال عملية استيراد جهات الاتصال (الأشخاص) إلى 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
  1. انتقل إلى People في الشريط الجانبي الأيسر
  2. انقر على أيقونة في أعلى اليمين
  3. اختر Import records
الخيار 2: باستخدام قائمة الأوامر
  1. اضغط Cmd + K (Mac) أو Ctrl + K (Windows)
  2. اكتب “import”
  3. اختر Import records
  4. اختر People

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

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

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

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

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

مطابقة علاقة الشركة

عند مطابقة عمود الشركة:
  1. اعثر على عمود مرجع الشركة (مثلًا، companyDomain)
  2. طابقه مع حقل علاقة Company
  3. سيقوم Twenty بربط كل شخص بالشركة المطابقة
طابق معرّفًا فريدًا واحدًا فقط للعلاقات.لا تقم بتعيين كلٍّ من companyId وcompanyDomain معًا. اختر واحدًا — ويفضَّل استخدام النطاق لأنه مقروء للبشر.

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

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

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

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

أخطاء شائعة عند استيراد جهات الاتصال

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

  1. راجِع ملخص الاستيراد
  2. انقر على تأكيد للاستيراد
  3. انتظر حتى يكتمل الاستيراد
  4. تحقَّق بفحص عدد قليل من السجلات وروابطها بالشركة

بعد استيراد جهات الاتصال

جهات الاتصال الخاصة بك موجودة الآن في Twenty! الخطوات التالية:
  1. تحقَّق من روابط الشركة — افتح عددًا قليلًا من سجلات الأشخاص للتأكد من أنها مرتبطة بالشركة الصحيحة
  2. استورد الفرص — واربطها عند الحاجة بالأشخاص والشركات
  3. اضبط مزامنة البريد الإلكتروني — وصّل صندوق بريدك لعرض سجل البريد الإلكتروني في سجلات جهات الاتصال

تحديث جهات الاتصال الموجودة

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

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

البريد الإلكتروني معرّف فريد في Twenty. هذا يمنع تكرار جهات الاتصال ويضمن أن مزامنة البريد الإلكتروني تربط الرسائل بالشخص الصحيح على نحوٍ صحيح.
يمكنك ترك البريد الإلكتروني فارغًا. مع ذلك، نوصي بإضافة عناوين البريد الإلكتروني عندما يكون ذلك ممكنًا لتحسين جودة البيانات ووظائف مزامنة البريد الإلكتروني.
أضِف عمودًا يحتوي على نطاق الشركة (مثلًا، https://acme.com) أو المعرّف. أثناء عملية التعيين، اربط هذا العمود بحقل علاقة الشركة.
استورد الشركات أولًا، ثم استورد الأشخاص. يجب أن تكون الشركة موجودة قبل أن تتمكّن من الإشارة إليها.
نعم! أنشئ حقلًا مخصصًا موسومًا بأنه “unique” في نموذج بياناتك لتخزين المعرّف الخارجي. ملاحظة: اسم الحقل id محجوز للمعرّف الداخلي الخاص بـ Twenty.
الشركة التي تشير إليها غير موجودة. إما أن تستورد الشركة أولًا، أو تأكّد من أن النطاق/المعرّف يطابق تمامًا شركةً موجودة.

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

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