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

# رفع جهات الاتصال

> تنسيق CSV، قواعد التحقق، وتعيين الوسوم لرفع جهات الاتصال

## ما الذي تساعدك هذه الصفحة على القيام به

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

## قبل أن تبدأ

* حساب Nudgen
* ملف CSV يحتوي على عمود `email` على الأقل.
* يجب أن يكون عدد جهات الاتصال ضمن حد باقتك (راجع [الفواتير](/ar/billing/overview))

## الخطوة 1: تجهيز ملف CSV الخاص بك

يجب أن يتضمن ملف CSV الخاص بك ما يلي:

| العمود  | مطلوب | الوصف                                         |
| ------- | ----- | --------------------------------------------- |
| `email` | نعم   | عنوان بريد إلكتروني صالح. يجب أن يكون فريداً. |
| `name`  | لا    | الاسم الذي يظهر للتخصيص.                      |

يمكنك إضافة أعمدة أخرى (مثلاً: `company` ، `segment`). يتم تخزينها مشفرة ويمكن استخدامها في الوسوم أو منطق التقسيم.

## الخطوة 2: التحقق من التنسيق

* **الترميز (Encoding):** يُنصح باستخدام UTF-8.
* **الفواصل (Delimiter):** الفاصلة (`,`).
* **صف الرأس (Header row):** يجب أن يحتوي الصف الأول على أسماء الأعمدة. يتم التعرف على `email` و `name` بغض النظر عن حالة الأحرف.
* **رسائل البريد المكررة:** يتم دمج التكرارات في نفس الملف. ويتم تحديث جهات الاتصال الموجودة مسبقاً التي تحمل نفس البريد الإلكتروني.

<Warning>
  يتم تجاوز رسائل البريد غير الصالحة (بسبب خطأ في التنسيق، نقص علامة `@` ، إلخ). تحقق من ملخص الرفع لمعرفة عدد الصفوف التي تم استيرادها مقابل التي تم تجاوزها.
</Warning>

## الخطوة 3: الرفع في Nudgen

1. اذهب إلى **جهات الاتصال (Contacts)** في الشريط الجانبي.
2. انقر على **رفع ملف CSV (Upload CSV)**.
3. اختر ملفك.
4. اختر الوسوم (Tags) التي تريد تطبيقها على جميع جهات الاتصال المرفوعة في هذا الملف (مثلاً: `inactive` ، `re-engage`).
5. راجع المعاينة ثم أكد الإرسال.

## حدود الحجم

* **حجم الملف:** اتبع الحد الموضح على الشاشة (عادةً ما يكون بضعة ميجابايت). قد تستغرق القوائم الضخمة وقتاً أطول في المعالجة.
* **جهات الاتصال لكل مساحة عمل:** يعتمد على باقتك. يفرض التطبيق الحد عند وقت الرفع؛ وإذا تجاوزته، فسيتم رفض عملية الرفع. راجع [الفواتير](/ar/billing/overview) و [صفحة الأسعار](https://nudgen.net/pricing) المباشرة للحدود الحالية.

## ماذا يحدث بعد ذلك؟

* تظهر جهات الاتصال في القائمة مع إخفاء رسائل البريد الإلكتروني (`j***@g***.com`).
* استخدم الوسوم لتقسيم الجمهور في [الحملات](/ar/campaigns/create).
* يمكنك [كشف (Reveal)](/ar/contacts/overview) جهات الاتصال الفردية بصفتك مالك الحساب.

## حل المشكلات

<AccordionGroup>
  <Accordion title="تم تجاوز بعض الصفوف">
    تأكد من أن كل صف يحتوي على بريد إلكتروني صالح في عمود `email`. يتم تجاوز الصفوف الفارغة أو العناوين غير الصحيحة.
  </Accordion>

  <Accordion title="فشل الرفع: تم تجاوز حد الباقة">
    سيؤدي عدد جهات الاتصال المرفوع لتجاوز حد باقتك. قم بترقية باقتك أو إزالة جهات اتصال موجودة.
  </Accordion>

  <Accordion title="لم يتم التعرف على العمود">
    تأكد من أن صف الرأس يتضمن `email` (أو `Email`). الأعمدة الأخرى اختيارية.
  </Accordion>
</AccordionGroup>

## مستندات ذات صلة

<CardGroup cols={2}>
  <Card title="نظرة عامة على جهات الاتصال" icon="users" href="/ar/contacts/overview">
    التشفير، الإخفاء، والتقسيم.
  </Card>

  <Card title="إنشاء الحملات" icon="paper-plane" href="/ar/campaigns/create">
    اختر جمهورك وأطلق حملة.
  </Card>
</CardGroup>
