> ## 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.

# المتغيرات و الحقول المخصصة

> المتغيرات و الحقول المخصصة

# المتغيرات والحقول في منشئ الفلو

تعتبر المتغيرات والحقول (Fields & Variables) من أهم الأدوات في منشئ الفلو، حيث تسمح لك بتخصيص المحادثات، اتخاذ قرارات ذكية، وحفظ بيانات العملاء.

## ما هي المتغيرات؟

المتغيرات هي حاويات لتخزين المعلومات. يمكن أن تكون هذه المعلومات ثابتة أو متغيرة بناءً على تفاعل العميل مع البوت.

## متغيرات النظام (System Variables)

هي متغيرات مدمجة في النظام تجمع معلومات عن العميل بشكل تلقائي. يمكنك استخدامها في الشروط والإجراءات لعرض معلومات مخصصة أو اتخاذ قرارات ذكية.

**جدول متغيرات النظام:**

| المتغير                   |   النوع  | الوصف                                 |
| :------------------------ | :------: | :------------------------------------ |
| `Is online`               |  Boolean | هل العميل متصل حالياً؟                |
| `Pronoun`                 |  Number  | الضمير (غير مستخدم حالياً)            |
| `Session count`           |  Number  | عدد جلسات العميل                      |
| `State`                   |  String  | حالة العميل (visitor, lead, customer) |
| `First name`              |  String  | الاسم الأول للعميل                    |
| `Last name`               |  String  | الاسم الأخير للعميل                   |
| `Middle name`             |  String  | الاسم الأوسط للعميل                   |
| `Primary Email`           |  String  | البريد الإلكتروني الأساسي             |
| `Email validation status` |  String  | حالة التحقق من البريد الإلكتروني      |
| `Primary Phone`           |  String  | رقم الهاتف الأساسي                    |
| `Phone validation status` |  String  | حالة التحقق من رقم الهاتف             |
| `Position`                |  String  | منصب العميل                           |
| `Department`              |  String  | قسم العميل                            |
| `Lead Status`             |  String  | حالة العميل المحتمل                   |
| `Status`                  |  String  | حالة العميل                           |
| `Has authority`           |  Boolean | هل يملك صلاحية؟                       |
| `Description`             |  String  | وصف العميل                            |
| `Subscribed`              |  Boolean | هل العميل مشترك؟                      |
| `Integration`             |  String  | التكامل المستخدم                      |
| `Code`                    |  String  | كود العميل                            |
| `Remote address`          |  String  | عنوان IP للعميل                       |
| `Country`                 |  String  | بلد العميل                            |
| `Country code`            |  String  | كود بلد العميل                        |
| `City`                    |  String  | مدينة العميل                          |
| `Region`                  |  String  | منطقة العميل                          |
| `Host name`               |  String  | اسم المضيف                            |
| `Language`                |  String  | لغة العميل                            |
| `User agent`              |  String  | معلومات متصفح العميل                  |
| `Email`                   |  String  | البريد الإلكتروني (عام)               |
| `Phone`                   |  String  | رقم الهاتف (عام)                      |
| `Created at`              | Datetime | تاريخ إنشاء العميل                    |
| `Modified at`             | Datetime | تاريخ آخر تعديل للعميل                |
| `Date of birth`           | Datetime | تاريخ ميلاد العميل                    |
| `Last seen at`            | Datetime | آخر ظهور للعميل                       |

<img src="https://mintcdn.com/karzoun-chat/AujswqqXTZVMsnLS/images/help/doc-1890494/01-4414749dccea.jpg?fit=max&auto=format&n=AujswqqXTZVMsnLS&q=85&s=5fbcabbeab16b2a12e78a4bfa611680a" alt="متغيرات النظام" width="894" height="768" data-path="images/help/doc-1890494/01-4414749dccea.jpg" />

## الحقول المخصصة (Custom Fields)

بالإضافة إلى متغيرات النظام، يمكنك إنشاء حقول مخصصة لتخزين أي معلومات إضافية تحتاجها عن عملائك.

> 💡 **للمزيد من التفاصيل، راجع مقال "[إدارة الحقول المخصصة](/ar/help-center/guides/settings/doc-2279103)"**

## كيفية استخدام المتغيرات في الفلو

يمكن استخدام المتغيرات في أماكن متعددة داخل الفلو:

### 1. في خطوة "شرط" (Condition)

يمكنك إنشاء شروط بناءً على قيمة متغير معين. مثلاً:

* **إذا كان** `البلد` **يساوي** "السعودية"
* **إذا كان** `قيمة الطلب` **اعلى** "50"
* **إذا كان** `عدد الطلبات` **أكبر من** 5

### 2. في خطوة "إرسال رسالة" (Send Message)

يمكنك عرض قيمة المتغير داخل الرسالة باستخدام الأقواس المعقوفة `{{ }}`, او الضغط على \< >.
مثال:

* "مرحباً `{{First name}}`!"

### 3. في خطوة "إجراء" (Action)

يمكنك تعديل قيمة الحقول المخصصة باستخدام إجراء "Set Custom Field".


## Related topics

- [الحقول المخصصة في كرزون](/ar/help-center/guides/settings/doc-2279103.md)
- [الإجراءات](/ar/miniapps/guides/actions.md)
- [نظرة عامة](/ar/developers/index.md)
- [أنماط الوكلاء](/ar/mcp-server/guides/agent-patterns.md)
- [أقسام الشركة](/ar/help-center/guides/settings/doc-2203317.md)