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

​
الصيغة

تستخدم قوالب WhatsApp متغيرات موضعية: أقواس معقوفة مزدوجة مع رقم.
  • لإضافة متغير، انقر على + Variable في محرر النص الأساسي، أو Variable بجوار Header text. يُدرج Flowella الرقم التالي نيابةً عنك.
  • تبدأ الأرقام من {{1}} ويجب أن تكون متتالية. لا يمكنك القفز من {{1}} إلى {{3}}.
  • المتغيرات نصوص. تُرسل الأرقام والتواريخ والمبالغ كنص، لذا نسّقها قبل وصولها إلى القالب.
تدعم Meta أيضًا المتغيرات المسماة، مثل {{first_name}}. يمكن لـ Flowella إرسال قوالب بمتغيرات مسماة أُنشئت في WhatsApp Manager، لكن محرره ينشئ متغيرات موضعية فقط.

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

​
قيم العينة

عند نشر قالب، تحتاج Meta إلى عينة لكل متغير. تستخدم Meta العينات من أجل:
  1. التحقق من أن المحتوى يطابق الفئة التي اخترتها (Marketing أو Utility أو Authentication).
  2. تقييم الجودة وخطر الرسائل العشوائية.
  3. عرض معاينة للمراجعين.
في Flowella، عينة المتغير هي Fallback value الخاصة به. العينات الجيدة تساعد على الاعتماد:
  • استخدم قيمًا واقعية. John مقبولة، أما xxx فتؤدي غالبًا إلى الرفض.
  • اجعل العينات قصيرة. فقرة كاملة في متغير واحد مؤشر رفض كلاسيكي.
  • طابق النوع. إذا كان {{2}} تاريخًا، فاستخدم تاريخًا. وإذا كان رقم طلب، فاستخدم شيئًا يشبه رقم الطلب.

​
القيم الاحتياطية

لكل متغير في المحرر حقل Fallback value:
  • متغيرات النص الأساسي: في لوحة Body variables في محرر النص الأساسي.
  • متغير الرأس النصي: ضمن Header variables في بطاقة Variables.
  • متغير زر URL: أسفل عنوان الزر.
تؤدي القيمة الاحتياطية ثلاث وظائف:
  1. تظهر في المعاينة.
  2. تُرسل إلى Meta كعينة للمتغير عند النشر.
  3. يرسلها Flowella عندما تكون قيمة جهة الاتصال مفقودة أو فارغة، بعد تأكيد القيم الاحتياطية.
اختر قيمة تُقرأ بشكل طبيعي لأي شخص، مثل there في Hi there. لا يمكن أن تحتوي القيم الاحتياطية على فواصل أسطر. عند نشر قالب بنيته في Flowella، تُؤكد قيمه الاحتياطية تلقائيًا.

​
القوالب ذات القيم الاحتياطية غير المراجعة

تعرض بعض القوالب شارة Fallbacks not reviewed في قائمة القوالب. لم يؤكد أحد قيمها الاحتياطية بعد، مثلًا لأن القالب أُنشئ في WhatsApp Manager. يملأ Flowella قيمها الاحتياطية مسبقًا من عينات القالب. إلى أن تؤكدها:
  • يعرض المحرر شريط تنبيه: Review fallback values. These are used when a contact’s data is empty. Until you confirm them, sends with missing data will fail.
  • أي عملية إرسال بقيمة فارغة تفشل بدلًا من استخدام القيمة الاحتياطية.
للعثور على هذه القوالب، انقر على Fallbacks not reviewed أعلى قائمة القوالب. لتأكيد القيم:
1

افتح القالب

في صفحة Templates، افتح القالب في المحرر.
2

تحقق من كل قيمة احتياطية

اقرأ كل Fallback value وغيّر أي قيمة لن تُقرأ جيدًا لكل جهات الاتصال.
3

أكّد

انقر على Confirm fallback values في شريط التنبيه. إذا غيّرت قيمة، فانقر على Save Template بدلًا من ذلك. في الحالتين، لا يُرسل شيء إلى Meta ولا تتم مراجعة القالب مرة أخرى.
بعد النقر على Confirm fallback values، يعرض Flowella Fallback values confirmed وتختفي الشارة.

​
ما يحدث وقت الإرسال

ينطبق هذا على مسارات عمل HubSpot والإرسال الجماعي والواجهة البرمجية والإرسال التجريبي والإرسال من صندوق الوارد. لا يرسل Flowella أبدًا متغيرًا فارغًا إلى Meta. عندما يفشل الإرسال بسبب متغير فارغ، يذكر الخطأ اسم المتغير ويتضمن رابطًا إلى القالب. مثلًا: Variable {{2}} is empty and has no fallback value. في سير عمل HubSpot، يفشل الإجراء لتلك الجهة ويعرض سجل سير العمل الرسالة. إذا لم يكن للمتغير قيمة احتياطية، يكون مُخرج Error code للإجراء هو VARIABLE_EMPTY_NO_FALLBACK.

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

في سير عمل HubSpot، يحتوي الإجراء Send WhatsApp Template على خمس خانات للمتغيرات: من Template Variable 1 إلى Template Variable 5. راجع إجراءات سير العمل.
1

اختر القالب

اختر القالب في Template Name. تعرض القائمة كل قالب مرة واحدة، باسمه.
2

اربط المتغيرات بالترتيب

يملأ Flowella متغير الرأس النصي أولًا، ثم متغيرات النص الأساسي بالترتيب. مثلًا، قالب يحتوي على {{1}} في الرأس و{{1}} و{{2}} في النص الأساسي. اربط Template Variable 1 بقيمة الرأس، وTemplate Variables 2 و3 بقيم النص الأساسي. رؤوس الصور والفيديو والمستندات لا تستخدم أي خانة.
3

خطط للقيم الفارغة

إذا كانت خاصية مرتبطة فارغة لجهة اتصال، يرسل Flowella القيمة الاحتياطية المؤكدة. إذا لم تكن للقالب قيمة احتياطية مؤكدة لذلك المتغير، يفشل الإجراء لتلك الجهة. إذا ربطت خانات أقل من عدد متغيرات القالب، يعامل Flowella المتغيرات الناقصة على أنها فارغة.
4

اختبر قبل التشغيل الفعلي

سجّل جهة اتصال تجريبية أولًا وتحقق من الرسالة على هاتفك. ثم فعّل سير العمل للجميع.
يمكن أن يحتوي القالب على أكثر من خمسة متغيرات، لكن الإجراء يمكنه ربط خمسة فقط. لكل متغير بعد الخامس، يرسل Flowella القيمة الاحتياطية المؤكدة، أو يفشل الإرسال إذا لم توجد.

​
التواريخ من HubSpot

يرسل HubSpot خصائص التاريخ والتاريخ والوقت كطابع زمني. يحوّله Flowella إلى dd.MM.yyyy HH:mm بتوقيت UTC، مثل 27.06.2026 14:30. تعرض خاصية التاريخ فقط الوقت 00:00. لعرض تاريخ بالتوقيت المحلي لجهة الاتصال، أو بتنسيق آخر، خزّن التاريخ المنسّق في خاصية نصية في HubSpot واربط تلك الخاصية بدلًا من ذلك. يرسل Flowella الخصائص النصية كما هي تمامًا.

​
اللغة

تعرض قائمة Template Name اسم كل قالب مرة واحدة. إذا كان القالب معتمدًا بأكثر من لغة، يختار Flowella نسخة واحدة بهذا الترتيب:
  1. اللغة المُمرّرة مع إجراء سير العمل، إن وجدت.
  2. نسخة برمز اللغة en. النسخ بـ en_US أو en_GB لا تُحتسب هنا.
  3. أحدث نسخة معتمدة تم تحديثها.
لا يستخدم Flowella خاصية اللغة لجهة الاتصال في HubSpot. لإرسال لغات مختلفة إلى جهات اتصال مختلفة، امنح كل نسخة لغوية اسم قالب خاصًا بها وفرّع سير العمل حسب اللغة.

​
رؤوس الموقع

يحتاج القالب ذو رأس الموقع إلى خط عرض وخط طول في كل عملية إرسال. اسم المكان والعنوان اختياريان. في سير عمل HubSpot، اربط الموقع بخانات Template Variable التي تلي متغيرات النص الأساسي: خط العرض أولًا، ثم خط الطول، ثم اسم المكان. مثلًا، مع متغيرين في النص الأساسي، اربط خط العرض بـ Template Variable 3 وخط الطول بـ Template Variable 4.

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

الأسماء
اجعل الحرف الأول من الخاصية كبيرًا في HubSpot أولًا، أو استخدم خطوة في سير عمل HubSpot لنسخ firstname إلى خاصية “First name (formatted)”. التواريخ لا ينسّق WhatsApp التواريخ. اربط خاصية نصية تحتوي على التاريخ بالشكل الذي تريد أن يُقرأ به، مثل 24 May 2026. راجع التواريخ من HubSpot. العملة نسّق المبالغ قبل وصولها إلى القالب. ضع رمز العملة في نص القالب (Total: £{{1}}) حتى يحتوي المتغير على الرقم فقط. عناوين URL في النص الأساسي يمكنك وضع عنوان URL كامل في متغير بالنص الأساسي، لكن معاينة الرابط لن تظهر ويُحتسب العنوان ضمن حد أحرف النص الأساسي. استخدم بدلًا من ذلك زر URL بمتغير في نهايته:
تملأ عمليات الإرسال من مسارات عمل HubSpot متغيرات النص الأساسي والرأس والموقع فقط. لا يمكنها إعطاء زر URL قيمة مختلفة لكل جهة اتصال، لذا للروابط التي تتغير حسب جهة الاتصال في سير عمل HubSpot، ضع عنوان URL الكامل في متغير بالنص الأساسي بدلًا من ذلك.

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

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

​
أنماط متقدمة

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

تُرقّم متغيرات الرأس والنص الأساسي بشكل منفصل، لذا فإن {{1}} في الرأس و{{1}} في النص الأساسي متغيران مختلفان. إذا ظهر اسم العميل في كليهما، فاربط خاصية HubSpot نفسها بالخانتين: Template Variable 1 للرأس وTemplate Variable 2 للنص الأساسي.

​
المحتوى الشرطي

لا تدعم قوالب WhatsApp منطق if/else. لإرسال محتوى مختلف إلى مجموعات مختلفة من جهات الاتصال، أنشئ قوالب منفصلة وفرّع سير عمل HubSpot، مثل “VIP welcome” و”Standard welcome”.

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

تُرسل كل نسخة لغوية من القالب وتُعتمد وتُخزّن بشكل منفصل. أبقِ المتغيرات في المواضع نفسها في كل لغة. لمعرفة النسخة التي يرسلها سير عمل HubSpot، راجع اللغة.

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

كانت قيمة جهة الاتصال فارغة وليس للقالب قيمة احتياطية لذلك المتغير. في HubSpot، يكون Error code للإجراء هو VARIABLE_EMPTY_NO_FALLBACK. تأكد من أن الخاصية معبأة لكل جهة اتصال، أو أضف قيمة احتياطية إلى القالب وأكّدها.
للقالب قيمة احتياطية، لكن لم يؤكدها أحد. افتح القالب وانقر على Confirm fallback values. راجع القوالب ذات القيم الاحتياطية غير المراجعة.
كانت الخاصية المرتبطة فارغة لتلك الجهة، أو أن القالب يحتوي على أكثر من خمسة متغيرات. تحقق من سجل جهة الاتصال وربط المتغيرات في إجراء سير العمل.
لا. لا يرسل Flowella أبدًا متغيرًا فارغًا أو غير معبأ. تُستبدل القيمة الفارغة بالقيمة الاحتياطية المؤكدة، أو يفشل الإرسال.
يحتوي متغير على عنوان URL أو محتوى لا يطابق فئة القالب. لا يمكنك إضافة محتوى ذي طابع تسويقي إلى قالب Utility عبر متغيراته. للبحث عن رمز الخطأ الذي أعطاه WhatsApp، راجع رموز أخطاء WhatsApp في Flowella.
لإرسال القوالب وتعديلها وإيقافها مؤقتًا، راجع القوالب ومرجع القوالب. للمساعدة الخاصة بحالات الرفض، راجع رفض القالب.
آخر تعديل في ٢٤ أكتوبر ٢٠٢٦