---
title: "متغيرات قوالب واتساب: {{1}} مقابل المعاملات المسماة"
description: "كيف تعمل متغيرات قوالب واتساب: الموضعية {{1}} مقابل المعاملات المسماة، وأماكن السماح بها، والقيم النموذجية، وأسباب رفض Meta، وحمولة إرسال جاهزة للنسخ."
canonical: "https://omnichannels.ai/ar/blog/whatsapp-template-variables-parameters/"
language: "ar"
updated: "2026-11-08"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
category: "whatsapp"
primaryQuery: "whatsapp template variables"
keywords: ["متغيرات قوالب واتساب", "معاملات قالب واتساب", "{{1}} في قالب واتساب", "المعاملات المسماة في واتساب", "parameter_format واتساب", "القيم النموذجية لقالب واتساب", "سبب رفض قالب واتساب بسبب المتغيرات", "تخصيص قالب واتساب من ملف CSV"]
published: "2026-11-08"
author: "OmniChannels.ai Editorial Team"
reviewer: "BroadNet Messaging Solutions Team"
readingMinutes: 9
answer: "متغير قالب واتساب عنصر نائب يُكتب {{1}} في القوالب الموضعية أو {{first_name}} في القوالب المسماة، وتملؤه عند كل إرسال. اختر الصيغة بالحقل parameter_format عند إنشاء القالب؛ والموضعية هي الافتراضية. يحتاج كل متغير إلى قيمة نموذجية للمراجعة. تُسمح المتغيرات في النص الأساسي وفي رأس نصي (واحد) وفي لاحقة زر الرابط (واحد)، وترفض Meta القوالب التي تبدأ بمتغير أو تنتهي به."
takeaways: ["تُرقَّم المتغيرات الموضعية {{1}} و{{2}} ويجب ملؤها بالترتيب؛ أما المسماة فتستخدم أسماء بأحرف صغيرة وشرطات سفلية ويمكن ملؤها بأي ترتيب.", "يجب أن يتضمن القالب قيمة نموذجية لكل متغير عند إنشائه؛ وتستخدم Meta القيم النموذجية أثناء المراجعة.", "يدعم الرأس النصي متغيرًا واحدًا، ويقبل النص الأساسي عدة متغيرات، ويدعم زر الرابط متغيرًا واحدًا يُلحق بنهاية الرابط.", "من أسباب الرفض الموثّقة لدى Meta: متغيرات مكتوبة بشكل خاطئ أو غير متسلسلة، وقالب يبدأ بمتغير أو ينتهي به، وكثرة المتغيرات قياسًا بطول النص، ورموز خاصة مثل # و$ و%.", "التخصيص من ملف CSV يعني صفًا لكل مستلم وقيمة نظيفة لكل متغير."]
faq: 
  - q: "ما الفرق بين المعاملات الموضعية والمسماة؟"
    a: "تستخدم القوالب الموضعية عناصر نائبة مرقّمة مثل {{1}} وتتطلب أن تأتي قيم الإرسال بالترتيب نفسه. وتستخدم القوالب المسماة أسماء بأحرف صغيرة وشرطات سفلية مثل {{order_number}}، ويمكن أن تظهر القيم بأي ترتيب في حمولة الإرسال. وإذا لم تضبط parameter_format عند إنشاء القالب فستعتمد Meta الصيغة الموضعية."
  - q: "أين يمكنني استخدام المتغيرات في قالب واتساب؟"
    a: "تذكر وثائق Meta النص الأساسي الذي يقبل عدة معاملات، والرأس النصي الذي يدعم معاملًا واحدًا، وزر الرابط الذي يدعم متغيرًا واحدًا يُلحق بنهاية الرابط. أما رأس الوسائط فيحمل ملفًا بدل المتغير. ولا تذكر الوثائق أن التذييل وأزرار الرد السريع وأزرار رقم الهاتف تدعم متغيرات."
  - q: "لماذا رُفض قالبي بسبب المتغيرات؟"
    a: "تذكر إرشادات المراجعة لدى Meta أسبابًا عدة مرتبطة بالمتغيرات: أقواس معقوفة ناقصة أو غير متطابقة، ومتغيرات غير متسلسلة، ورسالة تبدأ بمتغير أو تنتهي به، وكثرة المتغيرات قياسًا بطول الرسالة، ورموز خاصة مثل # و$ و%. عدّل النص وأضف قيمًا نموذجية واقعية ثم أعد الإرسال."
  - q: "هل أحتاج إلى قيم نموذجية؟"
    a: "نعم. تقول Meta إنه إذا كان القالب يستخدم متغيرات فيجب تضمين قيم نموذجية عند إنشائه، قيمة لكل معامل. استخدم قيمًا واقعية لا عناصر نائبة مثل test ليرى المراجعون كيف ستظهر الرسالة النهائية. تُستخدم القيم النموذجية للمراجعة فقط، أما القيم الفعلية فتُرسل وقت الإرسال."
  - q: "هل يمكن أن يحتوي المتغير على فاصل سطر أو رابط؟"
    a: "يغطي هذا الدليل ما تحققنا منه في وثائق Meta فقط، والصفحات التي راجعناها لا تذكر قاعدة لفواصل الأسطر داخل قيم المتغيرات. جرّب بإرسال فعلي إلى رقمك، واسأل فريقنا إذا كنت ستمرر قيمًا طويلة أو منسقة. وتُلحق قيمة زر الرابط بنهاية رابط الزر."
  - q: "كيف أخصص قالبًا من جدول بيانات؟"
    a: "احتفظ بصف لكل مستلم وعمود لكل متغير، بقيم نظيفة: أسماء بلا مسافات زائدة، وتواريخ بصيغة واحدة، وأرقام بالصيغة الدولية. ارفع الملف عند إرسال حملة مخصصة وتحقق من المعاينة. وأكّد تخطيط الأعمدة الدقيق مع فريقنا قبل حملتك الأولى."
sources: 
  - title: "Template fundamentals — WhatsApp Business Platform, Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview"
  - title: "Template components — WhatsApp Business Platform, Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components"
  - title: "Template review — WhatsApp Business Platform, Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review"
---

# متغيرات قوالب واتساب: {{1}} مقابل المعاملات المسماة

Canonical: https://omnichannels.ai/ar/blog/whatsapp-template-variables-parameters/
Language: ar
Publisher: OmniChannels.ai by BroadNet Technologies

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

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

المتغير عنصر نائب في نص القالب تستبدله بقيمة فعلية عند الإرسال. تسميه Meta معاملات (parameters)، ويسميه WhatsApp Manager متغيرات. يُراجَع نص القالب والقيم النموذجية مرة واحدة، أما القيم الفعلية فتُرسل مع كل رسالة.

مثلًا، يقرأ النص الأساسي للقالب `Hi {{1}}! Your order number is {{2}}. Thank you.` وترسل `Hi Layla! Your order number is OM-4821. Thank you.` إلى عميل، وزوجًا آخر من القيم إلى العميل التالي.

لا تترجم Meta نص القالب ولا قيم المتغيرات. أنت من يوفرها باللغة الصحيحة لكل نسخة لغوية من القالب.

## ما الفرق بين المعاملات الموضعية والمسماة؟

تختار الصيغة عند إنشاء القالب بالحقل `parameter_format`. وإذا أغفلته تعتمد Meta القيمة `positional`.

| | موضعية | مسماة |
|---|---|---|
| العنصر النائب | `{{1}}`، `{{2}}` | `{{first_name}}`، `{{order_number}}` |
| قاعدة التسمية | مرقّمة من 1 بالترتيب | أسماء فريدة بأحرف صغيرة وشرطات سفلية |
| قيم الإرسال | يجب أن تتبع ترتيب العناصر النائبة | يمكن أن تأتي بأي ترتيب |
| القيم النموذجية | المصفوفة `body_text` | `body_text_named_params` مع `param_name` |
| الأنسب لـ | قوالب قصيرة بمتغير أو اثنين | قوالب بعدة متغيرات يتولى صيانتها آخرون |

تُقرأ المعاملات المسماة بسهولة أكبر في مكتبة القوالب، ولا يمكن لتبديل الترتيب أن يضع رقم الطلب مكان الاسم دون أن يلاحظ أحد. أما القوالب الموضعية فأقصر كتابة وتبقى الافتراضية.

## أين تُسمح المتغيرات؟

تذكر وثائق Meta عن المكوّنات هذه الأماكن:

| المكوّن | المتغيرات |
|---|---|
| رأس نصي | معامل واحد |
| النص الأساسي | عدة معاملات |
| زر الرابط | متغير واحد يُلحق بنهاية الرابط |
| رأس وسائط (صورة أو فيديو أو مستند) | لا شيء؛ يُقدَّم الملف النموذجي عند الإنشاء والملف الفعلي عند الإرسال |
| التذييل وأزرار الرد السريع وأزرار رقم الهاتف | غير مذكورة ضمن ما يدعم المتغيرات |

حدود الطول الموثّقة: رأس نصي حتى 60 حرفًا، ونص أساسي حتى 1,024، وتذييل حتى 60، وتسمية زر حتى 25، ورابط زر حتى 2,000 حرف. وإذا كانت قيمة زر الرابط تحتوي رموزًا خاصة تقول Meta إن عليك ترميزها بالنسبة المئوية (percent-encode).

## كيف أقدّم القيم النموذجية؟

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

نص أساسي موضعي مع قيم نموذجية:

```json
{
  "type": "BODY",
  "text": "Hi {{1}}! Your order {{2}} ships on {{3}}.",
  "example": { "body_text": [["Layla", "OM-4821", "12 November"]] }
}
```

نص أساسي مسمى مع قيم نموذجية:

```json
{
  "type": "BODY",
  "text": "Hi {{first_name}}! Your order {{order_number}} ships on {{ship_date}}.",
  "example": {
    "body_text_named_params": [
      { "param_name": "first_name", "example": "Layla" },
      { "param_name": "order_number", "example": "OM-4821" },
      { "param_name": "ship_date", "example": "12 November" }
    ]
  }
}
```

يضبط القالب نفسه `"parameter_format": "named"` في الصيغة الثانية. استخدم قيمًا نموذجية واقعية ليرى المراجعون ما ستقوله الرسالة الفعلية.

## ماذا تقول Meta عن قواعد المتغيرات وأسباب الرفض؟

تذكر إرشادات مراجعة القوالب لدى Meta الأسباب التالية للرفض المتعلقة بالمتغيرات:

- متغيرات ناقصة أو أقواس معقوفة غير متطابقة. والصيغة الموضعية الصحيحة هي `{{1}}`.
- متغيرات غير متسلسلة، مثل `{{1}}` و`{{2}}` و`{{5}}` و`{{4}}`.
- قالب يبدأ بمتغير أو ينتهي به. تسمي Meta هذه المعاملات المعلّقة (dangling parameters).
- كثرة المتغيرات قياسًا بطول الرسالة. لا تعطي Meta نسبة محددة، لذا أضف نصًا ثابتًا حول كل متغير.
- متغيرات تحتوي رموزًا خاصة مثل `#` و`$` و`%`.

لم نجد بيانًا رسميًا عن متغيرين متجاورين مباشرة، لذلك لا نقدّم قاعدة في ذلك. افصل بينهما بكلمات، وهذا يحسّن القراءة أيضًا.

لقواعد الفئات وما يسبب الرفض أيضًا راجع [فئات قوالب واتساب والموافقة عليها](/ar/blog/whatsapp-template-categories-approval/). ولصياغات جاهزة راجع [أمثلة قوالب رسائل واتساب](/ar/blog/whatsapp-message-template-examples/).

## كيف أرسل المعاملات في استدعاء الـ API؟

ترسل اسم القالب واللغة ومصفوفة `components` بالقيم. هذا الشكل لقالب موضعي:

```json
{
  "messaging_product": "whatsapp",
  "to": "971500000000",
  "type": "template",
  "template": {
    "name": "order_shipped",
    "language": { "code": "en" },
    "components": [
      { "type": "body", "parameters": [
        { "type": "text", "text": "Layla" },
        { "type": "text", "text": "OM-4821" },
        { "type": "text", "text": "12 November" }
      ] }
    ]
  }
}
```

وفي القالب المسمى يحمل كل عنصر أيضًا `parameter_name` الذي يجب أن يطابق العنصر النائب:

```json
{ "type": "text", "parameter_name": "order_number", "text": "OM-4821" }
```

### كيف تعمل معاملات وسائط الرأس؟

لا يحتوي رأس الوسائط على متغير نصي. عند الإنشاء يحمل الرأس مقبض ملف نموذجي من مسار الرفع لدى Meta، ويُراجَع المثال مع القالب. وعند الإرسال تمرر الملف، مثلًا صورة بمعرّف الوسائط:

```json
{ "type": "header", "parameters": [ { "type": "image", "image": { "id": "1558081531584829" } } ] }
```

المعرّف أعلاه هو المثال من وثائق Meta وليس ملفًا حقيقيًا.

### كيف يبدو ذلك عبر OmniChannels.ai API؟

تأخذ نقطة النهاية `sendbulk` لدينا القالب كحقول نموذج، وفق [وثائق WhatsApp API](/developers/whatsapp/):

| ميزة القالب | الحقول |
|---|---|
| متغير النص الأساسي | `bodyTemplateVariables` |
| معامل مسمى | `bodyTemplateVariables={"parameter_name":"order_id","text":"ORD-12345"}` |
| متغير نص الرأس | `headerTemplateVariables` |
| صورة أو فيديو أو مستند في الرأس | `mediaUrl` (يتجاوز وسائط الرأس) |
| زر رابط ديناميكي | `buttonsTemplateVariable` |

## مثال تطبيقي: قالب شحن الطلب

يريد "Souq Rafiq" (مثال افتراضي)، وهو متجر تجزئة في الإمارات، إرسال تحديث شحن مع صورة منتج وزر تتبع.

1. **اكتب القالب** بحيث لا يبدأ بمتغير ولا ينتهي به: "Hi {{1}}, your order {{2}} has shipped and should arrive on {{3}}. Tap the button to follow it."
2. **أضف الرأس** صورةً، والتذييل نصًا عاديًا، وزر رابط `https://shop.example/track/{{1}}` بقيمة نموذجية مثل `OM-4821`.
3. **أرسل للمراجعة** بقيم نموذجية واقعية لكل متغير، ثم انتظر حالة الموافقة.
4. **أرسل** بقيم النص الأساسي الثلاث ولاحقة التتبع، وصورة الرأس إن أردت تجاوزها.

```bash
curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-shipped \
  -F destinationNo=971500000000 \
  -F messageType=TEMPLATE \
  -F templateName=order_shipped \
  -F templateLanguage=en \
  -F bodyTemplateVariables=Layla \
  -F buttonsTemplateVariable=OM-4821
```

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

## كيف أخصص قالبًا من ملف CSV؟

استخدم صفًا لكل مستلم وعمودًا لكل متغير، ثم ارفعه في إرسال مخصص.

1. ضع رقم المستلم بالصيغة الدولية في العمود الأول. راجع [صيغة E.164 لأرقام الهواتف](/ar/blog/e164-phone-number-format/).
2. أضف عمودًا لكل متغير، وأكّد تخطيط الأعمدة مع فريقنا قبل حملتك الأولى.
3. نظّف البيانات أولًا: احذف المسافات الزائدة، وصحّح حالة الأحرف، واستخدم صيغة تاريخ واحدة، وأزل القيم الفارغة، لأن المتغير الفارغ ينتج رسالة مشوهة أو إرسالًا فاشلًا.
4. عاين عدة صفوف وأرسل إلى رقمك أولًا.

وخطوات تنظيف البيانات مشروحة في [إرسال رسائل SMS جماعية من Excel أو CSV](/ar/blog/send-bulk-sms-from-excel-csv/)، وهي تنطبق على واتساب بالقدر نفسه.

## كيف أختار بين الموضعية والمسماة؟

اختر بحسب عدد من سيعدّلون القالب وعدد متغيراته.

1. متغير أو اثنان ومالك واحد: الموضعية مناسبة وهي الافتراضية.
2. ثلاثة متغيرات فأكثر، أو عدة فرق تحرر القوالب: استخدم المسماة ليشرح كل عنصر نائب نفسه.
3. الصياغة نفسها بلغات عدة: أبقِ الأسماء أو الأرقام نفسها عبر النسخ، ليملأ إجراء إرسال واحد كل اللغات.
4. احتفظ دائمًا بسجل يبيّن أي عمود مصدر يغذي أي متغير، حتى لا يزيح تعديل لاحق على القالب البيانات.

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

## ما الأخطاء الشائعة؟

- **البدء بمتغير أو الانتهاء به،** وهو سبب رفض تذكره Meta.
- **تخطي الأرقام** أو تكرار الرقم نفسه خارج الترتيب في قالب موضعي.
- **قيم نموذجية شكلية** مثل "test" لا تخبر المراجعين بشيء.
- **رموز خاصة** مثل `#` و`$` و`%` داخل المتغيرات.
- **ترتيب خاطئ وقت الإرسال** في قالب موضعي، فتوضع البيانات الصحيحة في المكان الخطأ.
- **عدم تطابق `parameter_name`** في قالب مسمى.
- **استخدام متغير لإخفاء الغرض الحقيقي** للرسالة. قد يُرفض القالب الذي لا تطابق فئته محتواه أو تُعاد تصنيفه؛ راجع [دليل الفئات](/ar/blog/whatsapp-template-categories-approval/).
- **الحدود:** يعرض هذا الدليل ما تذكره وثائق Meta وقت الكتابة. قرارات المراجعة تبقى لدى Meta والقواعد تتغير، فراجع الصفحات المرفقة.

## كيف تساعدك OmniChannels.ai

BroadNet مزوّد حلول أعمال رسمي لدى Meta (Business Solution Provider). في OmniChannels.ai يمكنك إنشاء قوالب واتساب بمتغيرات ووسائط وأزرار، ومعاينتها ومتابعة حالة الموافقة، ثم إرسالها بقيم مخصصة من الـ API أو من ملف Excel أو CSV في حملة. ويشمل ذلك تصفية التكرار وتقارير التسليم. راجع [صفحة WhatsApp Business API](/ar/channels/whatsapp-business-api/) و[منصة الحملات](/ar/platform/campaigns/).