> ## 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.
# الحقول المخصصة في كرزون
> الحقول المخصصة في كرزون
تتيح لك **الحقول المخصصة** (Custom Properties) في كرزون إضافة بيانات إضافية مخصصة تناسب احتياجات عملك. يمكنك استخدام هذه الحقول لجمع معلومات محددة عن العملاء، أو تنظيم المهام، أو إضافة تفاصيل إضافية للمحادثات، مما يسهل عملية الفلترة والأتمتة لاحقاً.
للوصول إلى الحقول المخصصة، اذهب إلى **الإعدادات > الحقول المخصصة**.
***
## 1. حقول جهات الاتصال (الأهم والأكثر استخداماً)
تُستخدم حقول جهات الاتصال لإضافة معلومات إضافية تظهر في بطاقة العميل (مثل: رقم الهوية، تاريخ الميلاد، نوع العميل).
### تكامل سلة الجاهز
إذا كنت تستخدم تطبيق "سلة"، ستلاحظ وجود مجموعات حقول جاهزة ومقفلة تم إنشاؤها تلقائياً لجلب بيانات المتجر وعرضها في بطاقة العميل، وتشمل:
* **بيانات الطلب** (14 حقلاً مثل: رقم الطلب، حالة الطلب، قيمة الطلب)
* **بيانات الشحن** (8 حقول)
* **بيانات المنتجات** (4 حقول)
* **بيانات السلة المتروكة** (4 حقول)
* **تقييم العميل**
***
## 2. حقول المهام
تُستخدم هذه الحقول لإضافة بيانات مخصصة تظهر داخل بطاقة المهمة في لوحة المهام.**ملاحظة هامة:** حقول المهام ليست عامة، بل ترتبط بلوحة ومسار محددين.
**كيفية عرض أو إضافة حقول المهام:**
1. اذهب إلى تبويب **المهام**
2. اختر **اللوحة** (مثلاً: لوحة الشكاوى)
3. اختر **المسار** (مثلاً: قيد المعالجة)
4. ستظهر لك الحقول المخصصة المرتبطة بهذا المسار لتتمكن من إدارتها.
***
## 3. حقول صندوق الوارد (المحادثة)
تُستخدم هذه الحقول لإضافة تفاصيل خاصة بالمحادثة نفسها (وليس العميل)، وتظهر في الشريط الجانبي الأيسر أثناء التحدث مع العميل. مفيدة جداً لتصنيف المحادثات (مثلاً: نوع الاستفسار، نتيجة المحادثة، رقم التذكرة).
***
## كيفية إنشاء حقل مخصص جديد
لإنشاء حقل مخصص جديد في أي من التبويبات السابقة، اتبع الخطوات التالية:
1. انقر على زر **+ إضافة مجموعة** (إذا لم تكن لديك مجموعة لجمع الحقول داخلها).
2. داخل المجموعة، انقر على **+ إضافة خاصية**.
3. قم بتعبئة بيانات الحقل:
* **الاسم:** اسم الحقل الذي سيظهر للمستخدمين.
* **الوصف:** (اختياري) شرح مبسط للحقل.
* **الرمز:** يتم إنشاؤه تلقائياً ويُستخدم برمجياً في الأتمتة والقوالب.
* **المجموعة:** اختر المجموعة التي ينتمي إليها الحقل.
* **النوع:** اختر نوع البيانات (انظر الجدول أدناه).
* **التحقق:** قيد إضافي على النوع Input (انظر الجدول أدناه).
* **إلزامي:** حدد ما إذا كان إدخال هذا الحقل إجبارياً.
* **مرئي عند الإنشاء:** حدد ما إذا كان سيظهر عند إنشاء عميل/مهمة جديدة.
1. انقر **حفظ**.
### أنواع الحقول المتاحة (النوع)
| النوع | الاستخدام |
| ------------------- | ----------------------------------- |
| **Input** | نص حر قصير (اسم، رقم هاتف، رقم طلب) |
| **String List** | قائمة نصوص متعددة |
| **Object List** | قائمة كائنات JSON معقدة |
| **Text area** | نص طويل متعدد الأسطر (ملاحظات، وصف) |
| **Select** | قائمة منسدلة باختيار واحد |
| **Multiple select** | قائمة منسدلة باختيار متعدد |
| **Label select** | اختيار من وسوم (Labels) موجودة |
| **Checkbox** | خانة اختيار (نعم/لا) |
| **Radio button** | اختيار واحد من مجموعة خيارات |
| **File** | رفع ملف مرفق |
| **Customer** | ربط بعميل آخر في كرزون |
| **Product** | ربط بمنتج من الكتالوج |
| **Team members** | ربط بعضو في الفريق |
| **Branch** | ربط بفرع من فروع الشركة |
| **Department** | ربط بقسم من أقسام الشركة |
| **Location/Map** | إحداثيات موقع جغرافي |
### خيارات التحقق (Validation)
تظهر خيارات التحقق فقط عند اختيار النوع **Input**، وتُضيف قيداً على صيغة البيانات المدخلة:
| التحقق | ما يفعله |
| ----------------- | ----------------------------------------- |
| **لا شيء** | نص حر بدون قيود (الافتراضي) |
| **بريد إلكتروني** | يتحقق أن القيمة بصيغة بريد إلكتروني صحيحة |
| **رقم** | يقبل الأرقام فقط |
| **تاريخ** | يقبل تاريخاً بصيغة محددة |
| **تاريخ ووقت** | يقبل تاريخاً وتوقيتاً |
| **تعبير نمطي** | يتحقق من تطابق القيمة مع نمط Regex مخصص |
| **JSON** | يقبل بيانات بصيغة JSON صحيحة |
***
## الاستفادة من الحقول المخصصة
الاستخدام الأقوى للحقول المخصصة هو **تخزين البيانات واسترجاعها داخل الأتمتة والمشغّلات**. فكر فيها كـ"ذاكرة" البوت التي تتراكم فيها المعلومات عبر محطات المحادثة.
***
### 1. تخزين البيانات في الأتمتة (Update Property)
في أي أتمتة، يمكنك إضافة إجراء **"تحديث خاصية"** لتخزين قيمة في حقل مخصص. مثلاً:
> عندما يرد العميل برسالة تحتوي على رقم طلبه → البوت يستخرج الرقم ويخزّنه في حقل مخصص اسمه "رقم الطلب" في بيانات العميل.
**الخطوات:**
1. في الأتمتة ، أضف إجراء من نوع **"تحديث خاصية"**
2. اختر **نوع الخاصية:** جهة اتصال / محادثة / مهمة
3. اختر **الحقل** المخصص الذي تريد تخزين البيانات فيه
4. حدد **القيمة:** إما قيمة ثابتة أو متغير ديناميكي من رد العميل أو مخرجات خطوة سابقة
***
### 2. استخدام الحقل كشرط في المشغّلات (Triggers)
يمكنك تشغيل أتمتة بناءً على تغيّر قيمة حقل مخصص. مثلاً:
> عندما يتغيّر حقل "حالة العميل" إلى "مهتم" → أرسل رسالة ترحيب خاصة وعيّن وكيلاً مختصاً.
**الخطوات:**
1. اذهب إلى **الأتمتة > المشغّلات**
2. أنشئ مشغّلاً جديداً
3. في قسم **الحدث:** اختر **"تغيير خاصية"**
4. حدد الحقل والقيمة التي تستخدمها كشرط للتشغيل
5. أضف الإجراءات المطلوبة
***
### 3. استخدام الحقل كشرط في الأتمتة (Conditions)
يمكنك إضافة شرط في أي أتمتة يتحقق من قيمة حقل مخصص قبل تنفيذ الإجراء. مثلاً:
> إذا كان حقل "نوع العميل" = "مميز" → وجّه المحادثة إلى فريق العناية المتميزة.
***
### 4. استخدام الحقل كمتغير في الرسائل والقوالب
بعد تخزين البيانات في الحقول المخصصة، يمكنك استدعاؤها في أي رسالة باستخدام الرمز الخاص بالحقل. مثلاً:
```
مرحباً {{contact.name}}، طلبك رقم {{contact.order_number}} جاهز للشحن!
```
حيث `order_number` هو الرمز الذي تم إنشاؤه تلقائياً عند إنشاء الحقل.
***
### 5. استخدام الحقل في الشرائح
فلترة العملاء بناءً على قيمة حقل مخصص. مثلاً:
> إنشاء شريحة ديناميكية لجميع العملاء الذين حقل "حالة الطلب" لديهم = "معلق" لإرسال حملة متابعة تلقائية.
## Related topics
- [المتغيرات و الحقول المخصصة](/ar/help-center/guides/automations/basics/doc-1890494.md)
- [الإجراءات](/ar/miniapps/guides/actions.md)
- [نظرة عامة](/ar/developers/index.md)
- [أقسام الشركة](/ar/help-center/guides/settings/doc-2203317.md)
- [ملف جهة الاتصال](/ar/help-center/guides/contacts/profile.md)