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

# متغيرات القالب والمحتوى الديناميكي

> كيف تستخدم المتغيرات في رؤوس قوالب WhatsApp ونصوصها وأزرارها وروابطها، مع قواعد الصياغة، رموز تخصيص HubSpot، والأخطاء التي تؤدي إلى الرفض.

تتيح المتغيرات لإحدى القوالب المعتمدة إرسال رسائل مخصصة إلى آلاف جهات الاتصال دون الحاجة إلى إعادة إرسالها إلى Meta
. تتناول هذه الصفحة بالتفصيل كيفية عمل المتغيرات في Flowella
، والأماكن التي يمكن أن تظهر فيها، وكيفية ربطها ببيانات HubSpot
.

للحصول على نظرة عامة عالية المستوى على بنية القوالب، راجع [مرجع القوالب](/ar/app/template-reference). للحصول على إرشادات خطوة بخطوة لإنشاء القوالب، راجع [القوالب](/ar/app/templates).

## الصيغة

تستخدم قوالب WhatsApp
**متغيرات موضعية** مع أقواس معقوفة مزدوجة وفهرس يبدأ من 1:

```text theme={null}
Hi {{1}}, your booking on {{2}} is confirmed. Reference: {{3}}.
```

القواعد:

* تبدأ الفهارس من`{{1}}`
  ويجب أن تكون **متسلسلة** — لا يمكنك التخطي من`{{1}}`
  إلى`{{3}}`
  .
* يمكن إعادة استخدام نفس الفهرس داخل مكون واحد (النص الأساسي أو العنوان أو عنوان URL)، لكن Flowella
  سيرسل نفس القيمة إلى كل ظهور.
* لا يُسمح بوجود مسافات داخل الأقواس:`{{ 1 }}`
  غير صالح.
* المتغيرات هي **نص فقط**. يتم إرسال الأرقام والتواريخ والعملات كسلاسل — قم بتنسيقها مسبقًا في HubSpot
  قبل الإرسال.

<Note>
  Meta
  تقوم بطرح **المتغيرات المسماة** (`{{first_name}}`
  ) للقوالب الجديدة. Flowella
  تدعم كلا النوعين، ولكن الفهارس الموضعية تظل هي التنسيق الأكثر موثوقية عبر جميع أنواع القوالب وإصدارات Cloud API.
</Note>

## أين يمكن أن تظهر المتغيرات

| المكون                                          | المتغيرات المسموح بها                  | ملاحظات                                                              |
| ----------------------------------------------- | -------------------------------------- | -------------------------------------------------------------------- |
| **رأس الصفحة (نص)**                             | 1                                      | القيم القصيرة فقط — بدون فواصل أسطر.                                 |
| **رأس الصفحة (وسائط)**                          | 1 (معرف الوسائط أو عنوان URL)          | المتغير هو الوسائط نفسها، وليس النص.                                 |
| **رأس الصفحة (الموقع)**                         | 4 (خط العرض، خط الطول، الاسم، العنوان) | جميع العناصر الأربعة مطلوبة عندما يكون رأس الصفحة متغيرًا.           |
| **النص الأساسي**                                | حتى \~10 في الممارسة العملية           | يُحتسب كل متغير ضمن حد عدد الأحرف المسموح به في النص الأساسي لـ Meta |
| .                                               |                                        |                                                                      |
| **التذييل**                                     | لا شيء                                 | التذييل هو نص ثابت فقط.                                              |
| **زر URL**                                      | 1                                      | يُلحق بنهاية عنوان URL أساسي ثابت.                                   |
| **زر COPY\_CODE**                               | 1                                      | قيمة الكود الكاملة.                                                  |
| **أزرار الرد السريع، الهاتف، التدفق، الكتالوج** | لا شيء                                 | تكوين ثابت.                                                          |
| **بطاقات الكاروسيل**                            | ما يصل إلى 3 لكل نص بطاقة              | يتم ترقيم متغيرات كل بطاقة بشكل مستقل.                               |

## قيم العينة

عند إرسال قالب إلى Meta
، يحتاج كل متغير إلى **قيمة عينة**. يستخدم Meta
العينات من أجل:

1. تحديد ما إذا كان محتوى القالب يتطابق مع الفئة المختارة (التسويق، المرافق، المصادقة).
2. تقدير الجودة ومخاطر البريد العشوائي.
3. عرض معاينة للمراجعين.

لا تُستخدم القيم النموذجية عند الإرسال — فهي مخصصة للمراجعة فقط. لكنها مهمة:

* استخدم قيمًا **واقعية**.`{{1}} = "John"`
  جيد؛ بينما`{{1}} = "xxx"`
  غالبًا ما يؤدي إلى الرفض.
* اجعل العينات **قصيرة**. لصق فقرة في متغير واحد هو إشارة كلاسيكية للرفض.
* تأكد من أن العينة **مناسبة للنوع**. إذا كان`{{2}}`
  تاريخًا، فاستخدم تاريخًا. إذا كان رقم طلب، فاستخدم شيئًا يشبه رقم الطلب.

## ربط المتغيرات ببيانات HubSpot

في سير عمل HubSpot
الذي يستخدم إجراء \*\*إرسال قالب WhatsApp
\*\* في Flowella
:

<Steps>
  <Step title="اختر القالب">
    Flowella
    يعرض كل القوالب المعتمدة لقناتك. يتم الكشف عن المتغيرات تلقائيًا من نص القالب ورأسه وأزراره.
  </Step>

  <Step title="تعيين كل متغير إلى قيمة HubSpot">
    بالنسبة لكل`{{n}}`
    ، اختر خاصية جهة اتصال أو شركة أو صفقة أو تذكرة من HubSpot
    — أو اكتب قيمة ثابتة. يمكنك مزج رموز التخصيص والنص الحرفي في نفس التعيين.
  </Step>

  <Step title="تعيين احتياطي للقيم الفارغة">
    إذا لم يكن لجهة الاتصال أي قيمة للخاصية المعينة، فستفشل الرسالة ما لم توفر بديلاً. البدائل الشائعة:`"there"`
    للاسم الأول،`"your account"`
    لاسم الحساب.
  </Step>

  <Step title="الاختبار قبل بدء البث المباشر">
    أرسل سير العمل إلى جهة اتصال اختبارية واحدة أولاً. Meta
    يرفض عمليات الإرسال التي تحتوي على متغيرات فارغة أو تحتوي فقط على مسافات أو تحتوي على سطر جديد.
  </Step>
</Steps>

<Warning>
  تفشل المتغيرات الفارغة في وقت الإرسال، وليس عند الموافقة على القالب. يمكن إسقاط سير العمل الذي يتم تشغيله على آلاف جهات الاتصال بصمت في حالة فقدان خاصية مهمة. قم دائماً بتعيين البدائل.
</Warning>

## نصائح لتنسيق المتغيرات

**الأسماء**

```text theme={null}
Hi {{1}},
```

اكتب اسم الخاصية بأحرف كبيرة في HubSpot
في المرحلة السابقة، أو استخدم خطوة سير العمل HubSpot
لنسخ`firstname`
إلى خاصية "First name (formatted)".

**التواريخ**

لا تقوم قوالب WhatsApp
بتنسيق التواريخ. إذا كانت خاصية HubSpot
الخاصة بك هي`2026-05-24T00:00:00Z`
، فهذا هو ما سيظهر في الرسالة. استخدم خاصية محسوبة HubSpot
أو إجراء سير عمل لتنسيق التواريخ على النحو التالي`24 May 2026`
قبل تعيينها.

**العملة**

كما هو الحال مع التواريخ — قم بالتنسيق مسبقًا. قم بتضمين رمز العملة في النص الثابت (`Total: £{{1}}`
) بحيث تكون المتغير عبارة عن الرقم فقط.

**عناوين URL في نص الجسم**

يمكنك تضمين عنوان URL الكامل داخل متغير الجسم، ولكن لن يتم عرض معاينة الرابط وسيتم احتساب عنوان URL ضمن حد عدد الأحرف المسموح به في نص الجسم. استخدم **زر URL** مع لاحقة متغير بدلاً من ذلك:

```text theme={null}
Base URL: https://acme.com/orders/
Variable: {{1}}
At send time: https://acme.com/orders/AB-1234
```

## أسباب الرفض الشائعة المتعلقة بالمتغيرات

* **الفهارس المتخطاة** (`{{1}}`
  ثم`{{3}}`
  ). قم بإعادة الترقيم دائمًا.
* **المتغير في بداية أو نهاية** النص الأساسي بدون نص محيط (`{{1}}`
  وحده). أضف كلمة قبله أو بعده.
* **متغيران متجاوران** (`{{1}}{{2}}`
  ). افصل بينهما بمسافة أو علامة ترقيم على الأقل.
* **قيم نموذجية تشبه العناصر النائبة** —`"test"`
  ،`"xxx"`
  ،`"123"`
  — خاصة في قوالب التسويق.
* **المتغيرات في التذييل** — غير مسموح بها.
* **أكثر من متغير واحد في زر URL** — يُسمح بواحد فقط، ويجب أن يكون في **نهاية** عنوان URL.

## الأنماط المتقدمة

### إعادة استخدام قيمة عبر المكونات

إذا ظهر اسم العميل في كل من الرأس والنص، فحددها مرة واحدة في سير العمل الخاص بك وقم بتعيين كل من`{{1}}`
(الرأس) و`{{1}}`
(النص) إلى نفس الخاصية HubSpot
. يقوم Flowella
بإرسال قائمة المعلمات الخاصة بكل مكون، لذا فإن الفهارس مستقلة — تقوم بتعيين القيمة مرتين، ولكنك تخزنها مرة واحدة فقط في HubSpot
.

### المحتوى الشرطي لا تدعم قوالب

WhatsApp
منطق if/else داخل القالب. لإرسال محتوى مختلف إلى شرائح اتصال مختلفة، قم بإنشاء **قوالب منفصلة** وتفرع في سير عمل HubSpot
— على سبيل المثال، "ترحيب VIP" و"ترحيب قياسي".

### القوالب متعددة اللغات

يتم مشاركة اسم القالب وهيكله عبر اللغات، ولكن يتم **إرسال كل لغة والموافقة عليها وتخزينها بشكل منفصل**. يجب أن تكون المتغيرات في نفس المواضع في كل نسخة لغوية. يختار Flowella
اللغة الصحيحة بناءً على خاصية`hs_language`
الخاصة بالجهة (أو بديل تقوم بتكوينه).

## استكشاف الأخطاء وإصلاحها

* **القالب تمت الموافقة عليه ولكن الرسائل تفشل مع ظهور "عدم تطابق المعلمات"** — Meta
  و Flowella
  يختلفان حول عدد المتغيرات الموجودة في القالب. أعد استرداد القالب في Flowella
  (القوالب → تحديث) حتى تتم مزامنة عدد المتغيرات.
* **يظهر المتغير النصي`{{1}}`
  في الرسالة المرسلة** — لم يقم سير العمل بتعيين قيمة لهذا المؤشر. تحقق من قائمة معلمات إجراء سير العمل.
* **تم رفض الرسالة عند الإرسال مع ظهور رسالة "انتهاك السياسة"** — يحتوي المتغير على عنوان URL أو محتوى لا يتطابق مع فئة القالب. لا يمكن إدراج محتوى من نوع التسويق في قالب Utility عبر المتغيرات.

<Tip>
  للاطلاع على دورة الحياة الكاملة لإرسال القوالب وتحريرها وإيقافها مؤقتًا، راجع [القوالب](/ar/app/templates) و[مرجع القوالب](/ar/app/template-reference). للحصول على مساعدة خاصة بالرفض، راجع [القوالب المرفوضة](/ar/troubleshooting/template-rejected).
</Tip>