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

# المتغيرات الديناميكية

> استخدم متغيرات مثل {{firstName}} لتخصيص الرسائل في القوالب والحملات والردود السريعة والأتمتة — مع أمثلة وحدود حسب السطح.

عندما تُرسل الرسالة نفسها لكل عميل بلا اسم ولا رابط إلغاء اشتراك، تبدو الحملة عامة ويظهر المتغير حرفياً إن أُدرج في السطح الخطأ.

**المتغير الديناميكي** في كرزون قيمة تُدرج في النص كرمز مثل `{{firstName}}`، ثم تُستبدل عند الإرسال أو التنفيذ ببيانات العميل أو النظام أو المسار. نفس الفكرة تظهر في أكثر من سطح؛ الصيغة والأماكن تختلف قليلاً.

يشرح هذا الدليل أين تُدرج المتغيرات، وكيف تدرجها في قالب بريد، وما الأخطاء الشائعة حسب السطح.

<Frame caption="إدراج متغير من المنتقي أو بكتابة {{">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/karzoun-chat/images/help/getting-started/dynamic-variables-insert.webp" alt="إدراج متغير ديناميكي من المنتقي" />
</Frame>

## أين تستخدمها؟

| السطح | كيف تُدرج | أمثلة شائعة |
| - | - | - |
| [قوالب البريد](/ar/help-center/guides/broadcasts/email-templates) | **إدراج متغير** أو اكتب `{{` في الكتلة | `{{firstName}}` · `{{unsubscribeUrl}}` · `{{currentDate}}` |
| [حملات البريد](/ar/help-center/guides/broadcasts/email) | عبر القالب أو المحتوى المرتبط | نفس متغيرات جهة الاتصال + النظام |
| [حملات واتساب](/ar/help-center/guides/broadcasts/whatsapp) | حقول متغيرات القالب المعتمد | اربط كل خانة `{{1}}` في ميتا بحقل كرزون أو نص ثابت |
| [الردود السريعة](/ar/help-center/guides/inbox/quick-responses) | عند إنشاء القالب إن ظهر منتقي المتغيرات | اسم العميل أو حقول مناسبة ومختبرة |
| [الأتمتة](/ar/help-center/guides/automations/nodes/actions/overview) | حقول الإجراءات تدعم `{{...}}` | قيمة عميل، إجابة سؤال، مخرج إجراء سابق |

## الصيغة الأساسية

1. اكتب الاسم بين قوسين مزدوجين: `{{firstName}}`
2. أو اختر من القائمة — يُدرج الرمز في موضع المؤشر
3. عند الإرسال/التنفيذ: إن وُجدت القيمة تُستبدل؛ إن نقصت قد يظهر فراغ أو يفشل العرض حسب السطح (خصوصاً قوالب البريد وواتساب)

<Tip>
  اختبر دائماً برسالة تجريبية أو عميل داخلي قبل حملة كبيرة. متغير ناقص في بريد قد يظهر كـ **خطأ في القالب** في التسليم.
</Tip>

## أمثلة عملية

### ترحيب بالاسم

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
مرحباً {{firstName}}، طلبك جاهز للشحن.
```

### بريد مع إلغاء اشتراك

في بنّاء قوالب البريد أدرج:

* نصاً مثل: لإيقاف الرسائل التسويقية: `{{unsubscribeUrl}}`
* أو استخدم حقل **نص إلغاء الاشتراك** في خصائص الكتلة إن وُجد

متغيرات نظام شائعة في قوالب البريد:

| المتغير | الغرض |
| - | - |
| `{{unsubscribeUrl}}` | رابط إلغاء الاشتراك |
| `{{previewText}}` | نص المعاينة في صندوق الوارد |
| `{{currentDate}}` / `{{currentYear}}` | التاريخ / السنة |
| `{{companyName}}` / `{{companyAddress}}` | بيانات الشركة عند توفرها |

حقول جهة الاتصال تأتي من حقول العميل المجمّعة في حسابك (الاسم، البريد، الهاتف، حقول مخصصة…). الأسماء الدقيقة كما في منتقي المتغيرات.

### واتساب — متغيرات القالب

قوالب ميتا تستخدم أرقاماً (`{{1}}`, `{{2}}`). في الحملة تربط كل خانة بقيمة ثابتة أو بحقل ديناميكي من كرزون. لا تترك خانة مطلوبة فارغة عند الإطلاق.

### أتمتة — متغيرات المسار

في عقد الإجراءات اكتب `{{...}}` للإشارة إلى حقل عميل أو مخرج خطوة سابقة. هذا يجعل نفس الإجراء يختلف لكل من يمر بالمسار — راجع [نظرة عامة على إجراءات الأتمتة](/ar/help-center/guides/automations/nodes/actions/overview).

## خطوات: إدراج متغير في قالب بريد

<Steps>
  <Step title="افتح البنّاء">
    من **قوالب البريد الإلكتروني** عدّل قالباً أو أنشئ جديداً.
  </Step>

  <Step title="اختر كتلة نص أو زر أو ترويسة">
    ضع المؤشر حيث تريد القيمة.
  </Step>

  <Step title="أدرج المتغير">
    من **إدراج متغير** اختر الحقل، أو اكتب `{{` للبحث. للمتغيرات من نوع JSON قد يُطلب مسار داخل الكائن.

    <Frame caption="إدراج {{firstName}} من المنتقي">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/karzoun-chat/images/help/getting-started/dynamic-variables-insert-gif.webp" alt="إدراج متغير الاسم من منتقي المتغيرات في بنّاء البريد" />
    </Frame>
  </Step>

  <Step title="عاين ثم اربط الحملة">
    أرسل بريداً تجريبياً من الحملة بعد اختيار القالب.

    <Frame caption="معاينة بعد الاستبدال لا الرمز حرفياً">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/karzoun-chat/images/help/getting-started/dynamic-variables-email-preview.webp" alt="معاينة بريد يظهر فيها الاسم بعد استبدال المتغير" />
    </Frame>
  </Step>
</Steps>

## حدود ونصائح

* لا تخترع أسماء متغيرات — استخدم ما يظهر في المنتقي لهذا السطح
* الحقول المخصصة تظهر عند إعدادها على جهات الاتصال
* إشعارات Push في منشئ الحملة الحالي تركّز على نص ثابت قصير؛ خصّص عبر الشريحة والجمهور أكثر من الرموز داخل العنوان
* في الأتمتة: فرّق بين متغير **عميل** ومتغير **تنفيذ مسار** (إجابة سؤال، استجابة HTTP…)

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

| المشكلة | السبب المحتمل |
| - | - |
| يظهر `{{firstName}}` حرفياً للمستلم | السطح لا يستبدل هذا الرمز، أو أُرسل كنص ثابت في قالب واتساب بلا ربط |
| بريد بفشل عرض | متغير مطلوب بلا قيمة عند الإرسال |
| اسم فارغ في الرسالة | حقل الاسم فارغ في ملف العميل — استخدم شريحة «لديه اسم» أو نصاً احتياطياً في المسار إن وُجد |
| خلط `{{1}}` مع `{{firstName}}` | الأول لقالب ميتا؛ الثاني لحقول كرزون في البريد/الأتمتة |

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

**هل المتغيرات نفسها في كل المنتج؟**\
الفكرة واحدة (`{{...}}`)، لكن قائمة المتغيرات تختلف: بريد (عميل + نظام)، واتساب (خانات القالب)، أتمتة (عميل + مخرجات المسار).

**هل أحتاج معرفة برمجة؟**\
لا. استخدم المنتقي من الواجهة. التخصيص المتقدم (مسارات JSON، مخرجات HTTP) يظهر داخل الأتمتة عند الحاجة.

**أين أبدأ إن أردت تخصيص حملة فقط؟**\
لقوالب البريد والبنّاء، ثم [حملة بريد](/ar/help-center/guides/broadcasts/email). لواتساب: صفحة [حملة واتساب](/ar/help-center/guides/broadcasts/whatsapp).

## الخطوة التالية

عرفت أين تُدرج المتغيرات وحدود كل سطح. بعد ذلك:

* لقوالب البريد: [قوالب البريد الإلكتروني](/ar/help-center/guides/broadcasts/email-templates).
* لواتساب: اربط خانات القالب من [حملة واتساب لمرة واحدة](/ar/help-center/guides/broadcasts/whatsapp).

## ذات صلة

* [قوالب البريد الإلكتروني](/ar/help-center/guides/broadcasts/email-templates)
* [حملة بريد إلكتروني](/ar/help-center/guides/broadcasts/email)
* [حملة واتساب لمرة واحدة](/ar/help-center/guides/broadcasts/whatsapp)
* [الردود السريعة](/ar/help-center/guides/inbox/quick-responses)
* [إجراءات الأتمتة](/ar/help-center/guides/automations/nodes/actions/overview)
* [مسرد المصطلحات](/ar/help-center/guides/getting-started/glossary)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.