> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-clara.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating from Other CRMs

> دليل خطوة بخطوة لترحيل بياناتك من أي نظام لإدارة علاقات العملاء إلى Twenty.

## نظرة عامة

يرشدك هذا الدليل خلال عملية ترحيل بياناتك من أي نظام لإدارة علاقات العملاء إلى Twenty. تشمل العملية تدقيق بياناتك، وإعداد مساحة العمل في Twenty، والتصدير من نظامك الحالي، والاستيراد إلى Twenty.

<Note>يجب إعادة إنشاء العروض، وسير العمل، والأذونات يدويًا بعد الترحيل. خطط وقتًا لهذا العمل الخاص بالإعداد.</Note>

## الخطوة 1: تدقيق بياناتك الحالية

يُعد الترحيل فرصة لبداية جديدة. لا تنقل البيانات غير الضرورية.

**ما يجب الاحتفاظ به:**

* جهات الاتصال والشركات النشطة
* الفرص والصفقات المفتوحة
* الملاحظات والأنشطة المهمة
* الحقول المخصصة التي تستخدمها فعليًا

**ما يجب تركه:**

* جهات الاتصال القديمة (لا نشاط خلال سنتين أو أكثر)
* السجلات المكررة
* بيانات الاختبار
* الحقول المخصصة غير المستخدمة

## الخطوة 2: مطابقة نموذج البيانات الخاص بك

أنشئ مستند مطابقة بين نظام إدارة علاقات العملاء الحالي لديك وTwenty:

| نظام إدارة علاقات العملاء الخاص بك | Twenty                 |
| ---------------------------------- | ---------------------- |
| حساب / مؤسسة                       | **الشركة**             |
| جهة اتصال / شخص                    | **الأشخاص**            |
| صفقة / فرصة                        | **الفرصة**             |
| نشاط                               | **مهمة** أو **ملاحظة** |
| كائن مخصّص                         | **كائن مخصّص**         |

**لكل حقل، سجّل:**

* اسم الحقل المصدر
* الحقل الهدف في Twenty
* أي تحويلات في التنسيق مطلوبة (التواريخ، أرقام الهاتف، إلخ.)

<Note>احتفظ بمستند التعيين هذا في متناول اليد أثناء الاستيراد — سترجع إليه عند تعيين الأعمدة.</Note>

## الخطوة 3: إعداد مساحة العمل الخاصة بك في Twenty

قبل استيراد البيانات، حضّر مساحة العمل لديك في Twenty:

### أنشئ كائنات وحقولًا مخصّصة

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

<Warning>
  **يجب أن تكون الحقول موجودة قبل الاستيراد.**

  يُنشئ استيراد CSV سجلات، وليس حقولًا. أنشِئ جميع الحقول المخصّصة ضمن الإعدادات → نموذج البيانات قبل الاستيراد.
</Warning>

### ادعُ فريقك

<Warning>
  **ادعُ المستخدمين قبل استيراد البيانات.**

  إذا كانت بياناتك تتضمن مراجع للمستخدمين (مالك الحساب، المكلَّف، إلخ.)، فيجب أن يكون هؤلاء المستخدمون موجودين في Twenty قبل الاستيراد. وإلا فلن يمكن تعيين تلك العلاقات.
</Warning>

1. انتقل إلى **الإعدادات → الأعضاء**
2. ادعُ جميع أعضاء الفريق
3. **انتظر أن يقبل الجميع** دعوتهم
4. تحقّق من ظهور جميع المستخدمين في قائمة الأعضاء لديك

## الخطوة 4: التصدير من نظام إدارة علاقات العملاء الحالي لديك

صدّر بياناتك من نظام إدارة علاقات العملاء الحالي لديك:

1. ابحث عن وظيفة **Export** (عادةً ضمن الإعدادات، إدارة البيانات، أو المشرف)
2. صدّر إلى **تنسيق CSV** عند الإمكان
3. صدّر كل نوع من الكائنات على حدة (الشركات، جهات الاتصال، الصفقات، إلخ.)
4. ضمّن جميع الحقول التي تريد ترحيلها

**صدّر هذه الكائنات (بهذا الترتيب للرجوع إليه):**

1. الشركات / الحسابات / المؤسسات
2. جهات الاتصال / الأشخاص
3. الصفقات / الفرص
4. الملاحظات والأنشطة
5. كائنات مخصصة

## الخطوة 5: تنظيف بياناتك وتنسيقها

افتح كل ملف CSV مُصدَّر في تطبيق جداول بيانات وجهّزه لـ Twenty.

### أزل التكرارات

1. قم بالفرز حسب الحقل الفريد (البريد الإلكتروني للأشخاص، النطاق للشركات)
2. أزل الصفوف المكرّرة أو ادمجها
3. تحقّق من عدم وجود تكرارات مسبقًا في Twenty

### نسّق الحقول بشكل صحيح

| نوع الحقل             | التنسيق المطلوب                             |
| --------------------- | ------------------------------------------- |
| **النطاق**            | `https://domain.com`                        |
| **البريد الإلكتروني** | `name@domain.com` (يجب أن يكون فريدًا)      |
| **تاريخ**             | `YYYY-MM-DD`                                |
| **هاتف**              | ثلاثة أعمدة: الرقم، رمز الدولة، رمز الاتصال |
| **قيمة منطقية**       | `TRUE` أو `FALSE` (أحرف كبيرة)              |
| **حقول الاختيار**     | استخدم أسماء API، وليس تسميات العرض         |

<Warning>
  **تنسيق النطاق مهم.**

  استخدم `https://domain.com` (وليس `domain.com` أو `www.domain.com`). هذا يتوافق مع تنسيق Twenty ويمنع التكرارات عند توصيل مزامنة البريد الإلكتروني/التقويم.
</Warning>

اطّلع على [كيفية إعداد ملفات CSV](/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files) لمعرفة متطلبات التنسيق الكاملة لجميع أنواع الحقول.

### أضِف أعمدة العلاقات

لربط السجلات (مثل ربط الأشخاص بالشركات)، أضِف عمودًا يحتوي على المعرّف الفريد للسجل الأصل.

**مثال: ملف CSV للأشخاص مع رابط الشركة**

```csv theme={null}
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```

اطّلع على [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) للحصول على إرشادات مفصّلة حول ربط السجلات.

### تحديث مراجع المستخدم

إذا كانت بياناتك تتضمن تعيينات للمستخدمين (المالك، المكلَّف):

1. أضِف عمودًا يحتوي على بريد المستخدم الإلكتروني (وليس فقط مُعرّفه من النظام القديم)
2. استخدم عناوين البريد الإلكتروني نفسها التي استخدمها المستخدمون للانضمام إلى مساحة العمل الخاصة بك في Twenty

اطّلع على [كيفية إعداد ملفات CSV](/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files) للحصول على دليل كامل للتنسيق.

## الخطوة 6: الاستيراد إلى Twenty

<Warning>
  **ترتيب الاستيراد مهم!**

  استورد دائمًا بهذا الترتيب:

  1. **الشركات** أولًا (من دون تبعيات)
  2. **الأشخاص** ثانيًا (مرتبطون بالشركات)
  3. **الفرص** ثالثًا (مرتبطة بالشركات/الأشخاص)
  4. **الملاحظات والمهام** (مرتبطة بالسجلات)
  5. **الكائنات المخصّصة** وفقًا لتبعياتها

  يجب أن يكون السجل الأصل موجودًا قبل أن تتمكّن من الإشارة إليه.
</Warning>

### استيراد كل كائن

لكل ملف CSV، بالتسلسل:

1. انتقل إلى الكائن في Twenty
2. انقر **⋮ → Import records**
3. ارفع ملف CSV
4. طابِق الأعمدة مع الحقول:
   * طابِق أعمدة بريد المستخدم الإلكتروني مع حقول العلاقات المناسبة
   * طابِق أعمدة العلاقات (مثل `companyDomain`) مع حقول العلاقات
5. راجِع وأصلِح أي أخطاء في واجهة المستخدم
6. أكِّد عملية الاستيراد
7. تحقّق من عدد قليل من السجلات قبل المتابعة إلى الملف التالي

**أدلة تفصيلية:**

* [كيفية استيراد الشركات](/l/ar/user-guide/data-migration/how-tos/import-companies-via-csv)
* [كيفية استيراد جهات الاتصال](/l/ar/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)

## الخطوة 7: عمليات ترحيل كبيرة (أكثر من 50,000 سجل)

لعمليات الترحيل الكبيرة:

| الحجم               | النهج الموصى به                    |
| ------------------- | ---------------------------------- |
| أقل من 10,000 سجل   | استيراد CSV واحد                   |
| 10,000 - 50,000 سجل | قسّم إلى عدة ملفات CSV             |
| أكثر من 50,000 سجل  | استخدم واجهة برمجة التطبيقات (API) |

**بالنسبة لعمليات الاستيراد عبر واجهة برمجة التطبيقات (API):**

* أسرع وأكثر موثوقية لمجموعات البيانات الكبيرة
* يدعم العمليات الدفعية (حتى 60 سجلًا لكل استدعاء)
* راجع [كيفية استيراد البيانات عبر واجهة برمجة التطبيقات (API)](/l/ar/user-guide/data-migration/how-tos/import-data-via-api)

## الخطوة 8: الإعداد بعد الترحيل

بعد استيراد البيانات، أكمل تهيئة مساحة العمل الخاصة بك:

### أعد إنشاء العروض

* أعد إعداد العروض المحفوظة مع عوامل التصفية والترتيب وتكوينات الأعمدة
* أنشئ أي عروض كانبان أو تقويم تحتاجها

### إعادة إنشاء سير العمل

* أعد إنشاء الأتمتة في **الإعدادات → سير العمل**
* ابدأ بسير العمل الأكثر أهمية
* اختبر كل واحد منها قبل الاعتماد عليه

### تكوين الأدوار والصلاحيات

* قم بإعداد الأدوار في **الإعدادات → الأدوار**
* عيّن المستخدمين إلى الأدوار المناسبة

### اربط البريد الإلكتروني والتقويم

* يقوم كل مستخدم بربط حسابه الخاص ضمن **الإعدادات → الحسابات**
* سيبدأ Twenty بمزامنة رسائل البريد الإلكتروني مع سجلات جهات الاتصال
* اطّلع على [البريد الإلكتروني والتقويم](/l/ar/user-guide/calendar-emails/overview)

### درّب فريقك

* استعرضوا الواجهة الجديدة معًا
* قم بتوثيق أي عمليات خاصة بالفريق

## المشاكل الشائعة والحلول

| المشكلة                  | السبب                                 | الحل                                                                                    |
| ------------------------ | ------------------------------------- | --------------------------------------------------------------------------------------- |
| **أخطاء التكرار**        | البريد الإلكتروني/النطاق موجود بالفعل | أزل التكرارات من الملف، أو أدرج معرّفًا فريدًا لتحديث السجلات الموجودة                  |
| **العلاقة غير موجودة**   | السجل الأصل غير موجود                 | استورد الكائنات الأصلية أولًا (الشركات قبل الأشخاص)                                     |
| **حقول مفقودة**          | الحقل المخصّص غير موجود               | أنشئ الحقل ضمن الإعدادات → نموذج البيانات قبل الاستيراد                                 |
| **أخطاء حقول الاختيار**  | استخدام تسميات العرض                  | استخدم أسماء واجهة برمجة التطبيقات (API) (فعّل الوضع المتقدم في الإعدادات للعثور عليها) |
| **علاقة المستخدم فارغة** | لم يقبل المستخدم الدعوة               | تأكّد من قبول جميع المستخدمين للدعوات قبل الاستيراد                                     |

اطّلع على [كيفية إصلاح أخطاء الاستيراد](/l/ar/user-guide/data-migration/how-tos/fix-import-errors) للحصول على خطوات استكشاف الأخطاء وإصلاحها بالتفصيل.

## قائمة التحقق بعد التحويل

### سلامة البيانات

<Check>تم استيراد جميع السجلات (قارن الأعداد مع النظام المصدر)</Check>
<Check>العلاقات تعمل بشكل صحيح (الأشخاص مرتبطون بالشركات)</Check>
<Check>تعيينات المستخدمين تمت مطابقتها بشكل صحيح (المالك، المكلَّف)</Check>
<Check>تم ملء الحقول المخصّصة</Check>
<Check>لا توجد تكرارات غير متوقعة</Check>

### التكوين

<Check>تمت إعادة إنشاء العروض</Check>
<Check>تمت إعادة إنشاء سير العمل واختبارها</Check>
<Check>تم تكوين الأدوار والصلاحيات</Check>
<Check>تم ربط مزامنة البريد الإلكتروني/التقويم</Check>

### جاهزية الفريق

<Check>تم تدريب الفريق على النظام الجديد</Check>
<Check>تم تحديد خطة الوصول إلى نظام CRM القديم (الاحتفاظ به للرجوع إليه؟ متى يتم تعطيله؟)</Check>

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

<AccordionGroup>
  <Accordion title="هل يمكنني ترحيل سير العمل تلقائيًا؟">
    ليس في الوقت الحالي. يجب إعادة إنشاء سير العمل يدويًا في Twenty.
  </Accordion>

  <Accordion title="ماذا عن مرفقات الملفات؟">
    مرفقات الملفات غير متضمنة في صادرات CSV. ستحتاج إلى إعادة رفعها يدويًا، أو ترحيلها عبر واجهة برمجة التطبيقات (API)، أو التواصل مع فريقنا للحصول على المساعدة.
  </Accordion>

  <Accordion title="هل يمكنني إبقاء كلا النظامين يعملان أثناء الترحيل؟">
    نعم، نوصي بإبقاء نظام CRM القديم يعمل حتى تتحقق من اكتمال عملية الترحيل. فقط احرص على عدم إنشاء بيانات جديدة في كلا المكانين.
  </Accordion>

  <Accordion title="كم يستغرق الترحيل عادةً؟">
    يعتمد ذلك على حجم البيانات وتعقيدها. يمكن إنجاز عمليات الترحيل الصغيرة (أقل من 10,000 سجل) خلال بضع ساعات. قد تستغرق عمليات الترحيل الكبيرة عدة أيام بما في ذلك تنظيف البيانات والاختبار.
  </Accordion>
</AccordionGroup>

## هل تحتاج إلى مساعدة؟

لعمليات الترحيل المعقّدة أو مجموعات البيانات الكبيرة:

* **إعداد موجّه:** احجز باقة تعريف لمدة 4 ساعات
* **خدمة ترحيل كاملة:** يمكن لشركائنا التعامل مع عملية الترحيل بالكامل

تواصل عبر [contact@twenty.com](mailto:contact@twenty.com) أو استكشف [خدمات التنفيذ](/l/ar/user-guide/getting-started/capabilities/implementation-services).