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

# استيراد جهات الاتصال

> ارفع CSV لتصنيف عميل أو عميل محتمل أو للشركات، اربط الأعمدة، وأضف وسماً للدفعة لتصفيتها لاحقاً بسهولة دون شرائح.

عند الانتقال من جدول أو نظام سابق، الاستيراد يملأ جهات الاتصال دفعة واحدة — ويحدّث السجلات المكررة بدل إنشاء أسماء مزدوجة بلا داعٍ (لتصنيف **عميل** و**عميل محتمل**).

## قبل أن تبدأ

* ملف **CSV** فقط (يوجد تنزيل نموذج من نافذة الاستيراد)
* لكل صف (**عميل** أو **عميل محتمل**): **بريد و/أو هاتف** صالح بعد الربط — وإلا يفشل الصف
* نوع الاستيراد يتبع ما تفتحه الآن:
  * تبويب **العملاء** + تصنيف **عميل** → استيراد كـ **عميل**
  * تبويب **العملاء** + تصنيف **عميل محتمل** → استيراد كـ **عميل محتمل**
  * تبويب **الشركات** → استيراد شركات
* يُفضَّل عمود **وسم** موحّد لاسم الدفعة (انظر القسم التالي) حتى تعود لهذه القائمة بفلتر بسيط بعد الرفع

## كيف يعمل التكرار (مهم)

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

الإضافة اليدوية عكس ذلك: التكرار قد يُرفض برسالة حقول مكررة.

## وسم الدفعة أثناء الاستيراد (مهم)

كثير من الفرق تحتاج بعد الرفع أن ترجع بسرعة لمن استُوردوا اليوم أو في حملة معيّنة — **بدون بناء شريحة**. أسهل طريقة: أضف عمود وسم في ملف CSV، واربطه بحقل الوسوم عند الاستيراد، ثم فلتر القائمة بهذا الوسم.

### لماذا يفيد؟

* تصفية «من رفعناهم مؤخراً» بضغطة واحدة من فلتر **الوسوم** في [جهات الاتصال](/ar/help-center/guides/contacts/overview)
* تمييز دفعات مختلفة: معرض، شريك، قائمة مارس، نقل من نظام قديم…
* تجهيز جمهور لحملة أو متابعة يدوية دون شروط شريحة معقّدة
* عند تحديث سجل موجود بالتكرار، يُضاف الوسم إلى وسومه الحالية (لا يُمسح ما كان عليه سابقاً من هذا المسار)

### كيف تضيف الوسم في الملف

1. في CSV أنشئ عموداً (مثلاً باسم `tag` أو `وسم`).
2. ضع **نفس اسم الوسم** في كل صفوف هذه الدفعة، مثل: `استيراد-2026-03-15` أو `قائمة-المعرض`.
3. عند خطوة **ربط الأعمدة**، اربط هذا العمود بالحقل **Tags** (الوسوم).
4. أكمل الاستيراد كالمعتاد.

إذا لم يكن الوسم موجوداً من قبل، ينشئه كرزون تلقائياً عند الاستيراد ثم يطبّقه على الصفوف.

<Tip>
  اختر اسماً واضحاً ومؤرخاً للدفعة. بعد الرفع: جهات الاتصال → فلتر **الوسوم** → اختر وسم الدفعة. هذا يغني عن الشريحة عندما يكون هدفك فقط «من استُورد في هذه العملية».
</Tip>

<Info>
  **وسائط مطلوبة:** (١) صف في CSV فيه عمود وسم موحّد (٢) ربط العمود بـ Tags في نافذة الاستيراد (٣) فلتر الوسوم في القائمة بعد اكتمال الرفع.\
  `/images/help/contacts/import-tag-column.webp`\
  `/images/help/contacts/import-tag-mapping.webp`\
  `/images/help/contacts/import-tag-filter.webp`
</Info>

## خطوات الاستيراد

<Steps>
  <Step title="افتح النوع الصحيح من القائمة">
    جهات الاتصال → العملاء أو الشركات (والتصنيف إن لزم)، ثم **استيراد**.
  </Step>

  <Step title="١. تحميل">
    ارفع CSV أو استخدم النموذج الجاهز.

    <Info>
      **وسائط مطلوبة:** خطوة التحميل مع زر تنزيل النموذج.\
      `/images/help/contacts/import-upload.webp`
    </Info>
  </Step>

  <Step title="٢. ربط الأعمدة">
    اربط كل عمود بحقل كرزون، أو **تخطي**. للحقول غير القياسية اختر خاصية مخصصة ثم الحقل المناسب.

    حقول شائعة لتبويب العملاء: الاسم الأول/الأخير، البريد والهاتف الأساسيان، إضافيان، الرمز، الجنس، تاريخ الميلاد، الوصف، حالة عميل محتمل، بريد المالك، **Tags (الوسوم)**، خاصية مخصصة.

    لا تنسَ ربط عمود الوسم إن أعددته لتمييز الدفعة.

    <Info>
      **وسائط مطلوبة:** شاشة الربط مع مثال عمود وسم → Tags وخاصية مخصصة.\
      `/images/help/contacts/import-mapping.webp`\
      **عرض تفاعلي (اختياري):** من الرفع حتى التأكيد مع وسم الدفعة.
    </Info>
  </Step>

  <Step title="٣. تأكيد">
    راجع عدد الصفوف والأعمدة المربوطة واسم عملية الاستيراد إن طلب، ثم ابدأ. العملية تعمل في الخلفية على دفعات.
  </Step>
</Steps>

## سجل الاستيراد

من رأس جهات الاتصال افتح **سجل الاستيراد** لمتابعة النجاح، التحديث، الفشل، وإلغاء عملية جارية عند الحاجة.

<Info>
  **وسائط مطلوبة:** ورقة سجل الاستيراد مع حالة تقدّم وصفوف فاشلة.\
  `/images/help/contacts/import-history.webp`
</Info>

## بعد اكتمال الاستيراد

1. قارن العدد التقريبي في القائمة
2. افتح عيّنة سجلات للتحقق من الهاتف والبريد
3. إن وسّمت الدفعة: فلتر **الوسوم** → وسم هذه العملية — هذه أسرع طريقة لمراجعة من رُفعوا للتو
4. ابنِ [شريحة](/ar/help-center/guides/contacts/segments/create) فقط إذا احتجت شروطاً أعمق من «هذه الدفعة» (طلبات، سلات، تكرار شراء…)

## أخطاء شائعة

| المشكلة                                | السبب المحتمل                                                                                  |
| -------------------------------------- | ---------------------------------------------------------------------------------------------- |
| صف فشل                                 | لا بريد ولا هاتف بعد التنظيف، أو صيغة هاتف/بريد غير مقبولة                                     |
| أعمدة فارغة                            | ربط خاطئ أو تخطي غير مقصود                                                                     |
| تكرار رغم التحديث                      | اختلاف بسيط في الرقم/البريد عن السجل القديم (مسافات، مفتاح دولة)                               |
| استوردت كـ **عميل** بدل **عميل محتمل** | التصنيف/التبويب وقت فتح الاستيراد                                                              |
| لا أجد الدفعة بعد الرفع                | لم يُربط عمود الوسم، أو اختلف اسم الوسم بين الصفوف، أو تنظر لتصنيف/تبويب غير الذي استوردت إليه |

## ذات صلة

* [جهات الاتصال](/ar/help-center/guides/contacts/overview)
* [الشركات](/ar/help-center/guides/contacts/companies)
* [ملف جهة الاتصال](/ar/help-center/guides/contacts/profile)
* [إضافة جهة اتصال](/ar/help-center/guides/contacts/add)
* [دمج جهات الاتصال](/ar/help-center/guides/contacts/merge)


## Related topics

- [دمج جهات الاتصال](/ar/help-center/guides/contacts/merge.md)
- [الشركات](/ar/help-center/guides/contacts/companies.md)
- [إضافة جهة اتصال](/ar/help-center/guides/contacts/add.md)
- [نظرة عامة](/ar/help-center/guides/contacts/overview.md)
- [ما هي الشرائح؟](/ar/help-center/guides/contacts/segments/overview.md)