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

​
الصيغة

تستخدم قوالب WhatsApp متغيرات موضعية مع أقواس معقوفة مزدوجة وفهرس يبدأ من 1: 
Hi {{1}}, your booking on {{2}} is confirmed. Reference: {{3}}.
القواعد:
  • تبدأ الفهارس من{{1}} ويجب أن تكون متسلسلة — لا يمكنك التخطي من{{1}} إلى{{3}} .
  • يمكن إعادة استخدام نفس الفهرس داخل مكون واحد (النص الأساسي أو العنوان أو عنوان URL)، لكن Flowella سيرسل نفس القيمة إلى كل ظهور.
  • لا يُسمح بوجود مسافات داخل الأقواس:{{ 1 }} غير صالح.
  • المتغيرات هي نص فقط. يتم إرسال الأرقام والتواريخ والعملات كسلاسل — قم بتنسيقها مسبقًا في HubSpot قبل الإرسال.
Meta تقوم بطرح المتغيرات المسماة ({{first_name}} ) للقوالب الجديدة. Flowella تدعم كلا النوعين، ولكن الفهارس الموضعية تظل هي التنسيق الأكثر موثوقية عبر جميع أنواع القوالب وإصدارات Cloud API.

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

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

​
قيم العينة

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

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

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

اختر القالب

Flowella يعرض كل القوالب المعتمدة لقناتك. يتم الكشف عن المتغيرات تلقائيًا من نص القالب ورأسه وأزراره.
2

تعيين كل متغير إلى قيمة HubSpot

بالنسبة لكل{{n}} ، اختر خاصية جهة اتصال أو شركة أو صفقة أو تذكرة من HubSpot — أو اكتب قيمة ثابتة. يمكنك مزج رموز التخصيص والنص الحرفي في نفس التعيين.
3

تعيين احتياطي للقيم الفارغة

إذا لم يكن لجهة الاتصال أي قيمة للخاصية المعينة، فستفشل الرسالة ما لم توفر بديلاً. البدائل الشائعة:"there" للاسم الأول،"your account" لاسم الحساب.
4

الاختبار قبل بدء البث المباشر

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

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

الأسماء 
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 مع لاحقة متغير بدلاً من ذلك: 
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 عبر المتغيرات.
للاطلاع على دورة الحياة الكاملة لإرسال القوالب وتحريرها وإيقافها مؤقتًا، راجع القوالب ومرجع القوالب. للحصول على مساعدة خاصة بالرفض، راجع القوالب المرفوضة.