github-actions[bot]
001c2097a3
Created by Github action <!-- mintlify-editor-comments:start --> Mintlify --- 0 threads from 0 users in Mintlify - No unresolved comments <!-- mintlify-editor-comments:end --> <!-- mintlify-comment--> <a href="https://dashboard.mintlify.com/twenty/twenty/editor/i18n-docs?source=pr_comment" target="_blank" rel="noopener noreferrer"><picture><source media="(prefers-color-scheme: dark)" srcset="https://d3gk2c5xim1je2.cloudfront.net/assets/open-mintlify-editor-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://d3gk2c5xim1je2.cloudfront.net/assets/open-mintlify-editor-light.svg"><img src="https://d3gk2c5xim1je2.cloudfront.net/assets/open-mintlify-editor-light.svg" alt="Open in Mintlify Editor"></picture></a> <!-- /mintlify-comment --> Co-authored-by: github-actions <github-actions@twenty.com>
243 lines
14 KiB
Plaintext
243 lines
14 KiB
Plaintext
---
|
|
title: استيراد جهات الاتصال عبر CSV
|
|
description: دليل كامل خطوة بخطوة لاستيراد الأشخاص/جهات الاتصال إلى Twenty.
|
|
---
|
|
|
|
## نظرة عامة
|
|
|
|
يرشدك هذا الدليل خلال عملية استيراد جهات الاتصال (الأشخاص) إلى Twenty. **استورد الشركات أولًا** إذا كنت تريد ربط الأشخاص بالشركات.
|
|
|
|
## قبل أن تبدأ
|
|
|
|
### قائمة المتطلبات المسبقة
|
|
|
|
<Check>
|
|
يجب أن يكون ملفك بتنسيق CSV أو XLSX أو XLS
|
|
</Check>
|
|
|
|
<Check>
|
|
يحتوي الملف على أقل من 10,000 سجل
|
|
</Check>
|
|
|
|
<Check>
|
|
لا توجد عناوين بريد إلكتروني مكررة في ملفك
|
|
</Check>
|
|
|
|
<Check>
|
|
**استيراد الشركات أولًا** (إذا كنت تربط الأشخاص بالشركات)
|
|
</Check>
|
|
|
|
<Check>
|
|
جميع الحقول المخصصة موجودة في **Settings → Data Model**
|
|
</Check>
|
|
|
|
<Warning>
|
|
**استيراد الشركات قبل الأشخاص**
|
|
|
|
إذا كنت تريد ربط الأشخاص بالشركات، فاستورد الشركات أولًا. يجب أن تكون الشركة موجودة قبل أن تتمكن من الإشارة إليها.
|
|
</Warning>
|
|
|
|
## الخطوة 1: جهّز بيانات جهات الاتصال الخاصة بك
|
|
|
|
### الحقول المطلوبة والمُوصى بها
|
|
|
|
| الحقل | هل هو مطلوب؟ | التنسيق | الملاحظات |
|
|
| --------------------- | ------------ | ----------------- | -------------------------------- |
|
|
| **البريد الإلكتروني** | مُوصى به | `name@domain.com` | يجب أن يكون فريدًا |
|
|
| **الاسم الأول** | مُوصى به | نص | |
|
|
| **الاسم الأخير** | مُوصى به | نص | |
|
|
| **الشركة** | اختياري | النطاق أو المعرّف | يرتبط بشركة موجودة |
|
|
| **هاتف** | اختياري | أعمدة متعددة | انظر أدناه |
|
|
| **المسمى الوظيفي** | اختياري | نص | |
|
|
| **الحقول المخصصة** | اختياري | يختلف | يجب أن تكون موجودة في Data Model |
|
|
|
|
### تنسيق البريد الإلكتروني
|
|
|
|
* يجب أن يكون بتنسيق بريد إلكتروني صالح: `name@domain.com`
|
|
* **يجب أن يكون فريدًا** — لا تكرارات في ملفك أو في Twenty
|
|
* للعناوين الإضافية للبريد الإلكتروني، استخدم عمود **Emails / Additional Emails**:
|
|
|
|
```
|
|
["jane@twenty.com","jane.doe@twenty.com"]
|
|
```
|
|
|
|
### تنسيق الهاتف
|
|
|
|
الهاتف هو **حقل متداخل** يتطلب أعمدة متعددة:
|
|
|
|
| العمود | مثال |
|
|
| --------------------------------------- | ------------ |
|
|
| **Phones / Primary Phone Number** | `4159095555` |
|
|
| **Phones / Primary Phone Country Code** | `US` |
|
|
| **Phones / Primary Phone Calling Code** | `+1` |
|
|
|
|
### الربط بالشركات
|
|
|
|
أضف عمودًا يضم المعرّف الفريد للشركة:
|
|
|
|
| اسم العمود | التنسيق | مثال |
|
|
| --------------- | --------------- | -------------------------------------- |
|
|
| `companyDomain` | تنسيق عنوان URL | `https://acme.com` |
|
|
| `companyId` | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
|
|
|
|
<Note>
|
|
**استخدم تنسيق عنوان URL للنطاق** (`https://acme.com`)، وليس التسمية. هذا يطابق كيفية تخزين الشركات في Twenty.
|
|
</Note>
|
|
|
|
### بنية CSV نموذجية
|
|
|
|
```csv
|
|
firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
|
|
John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
|
|
Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
|
|
```
|
|
|
|
<Note>
|
|
**نصيحة احترافية:** انقر **Download sample file** أثناء الاستيراد أو صدّر عددًا قليلًا من الأشخاص الموجودين للاطلاع على أسماء الأعمدة الدقيقة التي تتوقعها Twenty.
|
|
</Note>
|
|
|
|
## الخطوة 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** للأعمدة التي لا تريد استيرادها
|
|
|
|
### قواعد مطابقة مهمة
|
|
|
|
| نوع العمود | التعيين إلى | الملاحظات |
|
|
| --------------------------- | ------------------------------ | ------------------------------------- |
|
|
| مرجع الشركة | حقل علاقة **Company** | استخدم النطاق أو المعرّف، وليس كليهما |
|
|
| البريد الإلكتروني | **البريد الإلكتروني** | عنوان البريد الإلكتروني الأساسي |
|
|
| عناوين بريد إلكتروني إضافية | **Emails / Additional Emails** | تنسيق المصفوفة |
|
|
| هاتف | أعمدة منفصلة | الرقم، رمز الدولة، رمز الاتصال |
|
|
|
|
<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
|
|
|
|
### مطابقة علاقة الشركة
|
|
|
|
عند مطابقة عمود الشركة:
|
|
|
|
1. اعثر على عمود مرجع الشركة (مثلًا، `companyDomain`)
|
|
2. طابقه مع حقل علاقة **Company**
|
|
3. سيقوم Twenty بربط كل شخص بالشركة المطابقة
|
|
|
|
<Warning>
|
|
**طابق معرّفًا فريدًا واحدًا فقط للعلاقات.**
|
|
|
|
لا تقم بتعيين كلٍّ من `companyId` و`companyDomain` معًا. اختر واحدًا — ويفضَّل استخدام النطاق لأنه مقروء للبشر.
|
|
</Warning>
|
|
|
|
## الخطوة 5: تعيين قيم حقل الاختيار
|
|
|
|
إذا كانت لديك حقول اختيار أو اختيار متعدد (مثل مصدر العميل المحتمل):
|
|
|
|
1. تعرض Twenty قيمك إلى جانب الخيارات الموجودة
|
|
2. طابِق كل قيمة في ملفك مع خيار في Twenty
|
|
3. أو أنشئ خيارات جديدة عند الحاجة
|
|
|
|
<Note>
|
|
تستخدم خيارات الاختيار **أسماء API**، وليس تسميات العرض. تحقّق من **الإعدادات → نموذج البيانات** → فعِّل **الوضع المتقدم** لمشاهدة أسماء API.
|
|
</Note>
|
|
|
|
## الخطوة 6: مراجعة الأخطاء وإصلاحها
|
|
|
|
قبل إكمال الاستيراد، تقوم Twenty بالتحقق من صحة بياناتك:
|
|
|
|
1. انقر على **الخطوات التالية**
|
|
2. يتم تمييز الصفوف التي تحتوي على أخطاء باللون **الأصفر**
|
|
3. **أصلِح الأخطاء مباشرةً** — انقر على خلية وعدّل القيمة
|
|
4. **أزِل الصفوف التي بها مشكلات** — انقر على X لتخطي ذلك الصف
|
|
|
|
### أخطاء شائعة عند استيراد جهات الاتصال
|
|
|
|
| خطأ | السبب | الحل |
|
|
| -------------------------------- | ---------------------------------------------------- | ------------------------------------ |
|
|
| **بريد إلكتروني مكرر** | البريد الإلكتروني موجود مسبقًا في Twenty أو في الملف | أزِل التكرار أو حدِّث السجل الموجود |
|
|
| **تنسيق بريد إلكتروني غير صالح** | تنسيق البريد الإلكتروني غير صحيح | صحّحه إلى `name@domain.com` |
|
|
| **العلاقة غير موجودة** | الشركة غير موجودة | استورد الشركات أولًا أو أصلِح المرجع |
|
|
| **حقل مطلوب مفقود** | الحقل المطلوب فارغ | املأ القيمة أو أزِل الصف |
|
|
|
|
## الخطوة 7: إكمال الاستيراد
|
|
|
|
1. راجِع ملخص الاستيراد
|
|
2. انقر على **تأكيد** للاستيراد
|
|
3. انتظر حتى يكتمل الاستيراد
|
|
4. تحقَّق بفحص عدد قليل من السجلات وروابطها بالشركة
|
|
|
|
## بعد استيراد جهات الاتصال
|
|
|
|
جهات الاتصال الخاصة بك موجودة الآن في Twenty! الخطوات التالية:
|
|
|
|
1. **تحقَّق من روابط الشركة** — افتح عددًا قليلًا من سجلات الأشخاص للتأكد من أنها مرتبطة بالشركة الصحيحة
|
|
2. **استورد الفرص** — واربطها عند الحاجة بالأشخاص والشركات
|
|
3. **اضبط مزامنة البريد الإلكتروني** — وصّل صندوق بريدك لعرض سجل البريد الإلكتروني في سجلات جهات الاتصال
|
|
|
|
## تحديث جهات الاتصال الموجودة
|
|
|
|
لتحديث جهات الاتصال بدلًا من إنشاء جهات جديدة:
|
|
|
|
1. ضمّن عمود `email` أو `id` في ملفك
|
|
2. تقوم Twenty بمطابقة السجلات باستخدام هذا المعرّف الفريد
|
|
3. يتم تحديث جهات الاتصال الموجودة؛ ويتم إنشاء جهات جديدة
|
|
|
|
راجع [كيفية تحديث السجلات الموجودة](/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import) للتفاصيل.
|
|
|
|
## الأسئلة الشائعة
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="لماذا لا يمكن لشخصين أن يمتلكا البريد الإلكتروني نفسه؟">
|
|
البريد الإلكتروني معرّف فريد في Twenty. هذا يمنع تكرار جهات الاتصال ويضمن أن مزامنة البريد الإلكتروني تربط الرسائل بالشخص الصحيح على نحوٍ صحيح.
|
|
</Accordion>
|
|
|
|
<Accordion title="ماذا لو كان لديّ أشخاص بلا بريد إلكتروني؟">
|
|
يمكنك ترك البريد الإلكتروني فارغًا. مع ذلك، نوصي بإضافة عناوين البريد الإلكتروني عندما يكون ذلك ممكنًا لتحسين جودة البيانات ووظائف مزامنة البريد الإلكتروني.
|
|
</Accordion>
|
|
|
|
<Accordion title="كيف أربط الأشخاص بالشركات أثناء الاستيراد؟">
|
|
أضِف عمودًا يحتوي على نطاق الشركة (مثلًا، `https://acme.com`) أو المعرّف. أثناء عملية التعيين، اربط هذا العمود بحقل علاقة الشركة.
|
|
</Accordion>
|
|
|
|
<Accordion title="ماذا لو لم تكن الشركة موجودة بعد؟">
|
|
استورد الشركات أولًا، ثم استورد الأشخاص. يجب أن تكون الشركة موجودة قبل أن تتمكّن من الإشارة إليها.
|
|
</Accordion>
|
|
|
|
<Accordion title="هل يمكنني استيراد المعرّف من نظام إدارة علاقات العملاء (CRM) السابق لديّ؟">
|
|
نعم! أنشئ حقلًا مخصصًا موسومًا بأنه "unique" في نموذج بياناتك لتخزين المعرّف الخارجي. ملاحظة: اسم الحقل `id` محجوز للمعرّف الداخلي الخاص بـ Twenty.
|
|
</Accordion>
|
|
|
|
<Accordion title="كيف أصلِح أخطاء 'العلاقة غير موجودة'؟">
|
|
الشركة التي تشير إليها غير موجودة. إما أن تستورد الشركة أولًا، أو تأكّد من أن النطاق/المعرّف يطابق تمامًا شركةً موجودة.
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
## استكشاف الأخطاء وإصلاحها
|
|
|
|
هل تواجه مشكلات؟ اطّلع على:
|
|
|
|
* [كيفية إصلاح أخطاء الاستيراد](/l/ar/user-guide/data-migration/how-tos/fix-import-errors)
|
|
* [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
|
|
* [مرجع تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping)
|