> ## 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: الأسماء والمتغيرات والحدود

> القواعد التي يتبعها كل قالب WhatsApp: الأسماء واللغات والمتغيرات المرقمة والمسماة والحالات وعدد القوالب المسموح به ومدة الصلاحية.

قالب WhatsApp هو رسالة وافقت عليها Meta مسبقًا. القوالب هي الرسائل الوحيدة التي يمكنك إرسالها إلى شخص خارج [نافذة خدمة العملاء البالغة 24 ساعة](https://knowledge.flowella.io/ar/whatsapp/messaging/customer-service-window.md)، لذا تستخدم كل حملة وكل تذكير وكل تواصل أول قالبًا. ينتمي كل قالب إلى WhatsApp Business Account واحد، وله فئة واحدة ولغة واحدة، ويجب أن يكون **Approved** قبل أن تتمكن من إرساله.

> [!NOTE]
>
> **في Flowella.** مدعوم. تنشئ القوالب في [محرر القوالب](https://knowledge.flowella.io/ar/app/templates.md)، أو تبدأ من مكتبة Meta أو من قالب بداية من Flowella. يرسل Flowella القوالب إلى Meta للمراجعة، ويعرض حالتها لدى Meta، ويرسل القوالب المعتمدة من Inbox والإرسال الجماعي وسير عمل HubSpot والـ API. تظهر القوالب التي تنشئها في WhatsApp Manager في Flowella أيضًا، لأن قائمة القوالب تقرأها من Meta.

## مكونات القالب

| الجزء | مطلوب | الحد |
| - | - | - |
| **الرأس** | لا | نص (60 حرفًا، متغير واحد) أو صورة أو فيديو أو مستند أو موقع |
| **المتن** | نعم | 1,024 حرفًا، مع متغيرات |
| **التذييل** | لا | 60 حرفًا |
| **الأزرار** | لا | حتى 10 إجمالًا، مع حدود لكل نوع زر |

تضيف بعض القوالب التسويقية أجزاءها الخاصة، مثل بطاقات العرض الدوّار أو العدّ التنازلي للعرض. لتفاصيل كل جزء والحدود التي يطبقها محرر Flowella، راجع [مرجع القوالب](https://knowledge.flowella.io/ar/app/template-reference.md). لملفات الوسائط، راجع [مواصفات الوسائط](https://knowledge.flowella.io/ar/whatsapp/messaging/media-specs.md).

## الأسماء

* استخدم الحروف الصغيرة والأرقام والشرطات السفلية فقط، على سبيل المثال `order_shipped_v2`. تسمح Meta بما يصل إلى 512 حرفًا.
* لا يلزم أن تكون الأسماء فريدة. يمكنك منح القوالب بلغات مختلفة الاسم نفسه، وهكذا تقدم رسالة واحدة بعدة لغات.
* يُرفض الاسم نفسه باللغة **نفسها**. تُرجع Meta الخطأ 2388024، الذي يعرضه Flowella بصيغة **Content in This Language Already Exists**. عدّل القالب الموجود بدلًا من ذلك، أو اختر اسمًا جديدًا.
* بعد حذف قالب معتمد، لا يمكنك إعادة استخدام اسمه لمدة 30 يومًا. راجع [تنظيم القوالب](https://knowledge.flowella.io/ar/whatsapp/templates/template-housekeeping.md#delete-a-template).

## اللغات

لكل قالب [رمز لغة](https://knowledge.flowella.io/ar/whatsapp/templates/supported-languages.md) واحد، مثل `en_GB` أو `pt_BR`. لا تترجم Meta أي شيء: تكتب أنت النص وقيم العينات بتلك اللغة. كل نسخة لغوية قالب منفصل، يُراجع على حدة ويُحتسب بشكل منفصل ضمن حدك.

## المتغيرات

المتغيرات عناصر نائبة تملؤها عند الإرسال، مثل اسم أو رقم طلب. تدعم Meta تنسيقين:

| التنسيق | الشكل | القواعد |
| - | - | - |
| **موضعي** (مرقم) | `{{1}}`، `{{2}}` | تبدأ الأرقام من 1 وتتوالى بالترتيب. تُرسل القيم بالترتيب نفسه. التنسيق الافتراضي لدى Meta. |
| **مسمى** | `{{first_name}}`، `{{order_number}}` | حروف صغيرة وشرطات سفلية، ويُستخدم كل اسم مرة واحدة. تُرسل القيم بالاسم، بأي ترتيب. |

يستخدم القالب تنسيقًا واحدًا في كل أجزائه. يحتاج كل متغير إلى قيمة عينة عند الإرسال للمراجعة، حتى يتمكن المراجع من رؤية رسالة واقعية. لا يمكن أن يبدأ المتن أو ينتهي بمتغير، ويُرفض القالب إذا كانت المتغيرات كثيرة جدًا بالنسبة إلى طول النص. راجع [مراجعة القوالب](https://knowledge.flowella.io/ar/whatsapp/templates/template-review.md#common-rejection-reasons).

> [!NOTE]
>
> **في Flowella.** ينشئ المحرر متغيرات موضعية ويطلب **Fallback value** لكل منها، تراجعها Meta كعينة. يمكن لـ Flowella أيضًا إرسال قوالب تستخدم متغيرات مسماة، مثل تلك المنشأة في WhatsApp Manager. راجع [متغيرات القوالب](https://knowledge.flowella.io/ar/app/template-variables.md).

## الحالات

تراجع Meta كل قالب جديد أو معدّل، عادةً خلال دقائق ودائمًا خلال 24 ساعة. ثم تتغير الحالة على مدار عمر القالب.

| الحالة لدى Meta | ما تعنيه | تظهر في Flowella بصيغة |
| - | - | - |
| قيد المراجعة (`PENDING`) | تراجعه Meta | **Pending** |
| معتمد (`APPROVED`) | جاهز للإرسال. يضيف WhatsApp Manager تسمية للجودة، مثل **Active - Quality pending**. | **Approved** |
| مرفوض (`REJECTED`) | رفضته Meta | **Rejected** |
| متوقف مؤقتًا (`PAUSED`) | متوقف حاليًا، بعد ملاحظات سلبية أو معدلات قراءة منخفضة | **Paused** |
| معطّل (`DISABLED`) | متوقف بعد ملاحظات سلبية متكررة | **Disabled** |
| طُلب الطعن فيه، أو مؤرشف، أو قيد الحذف، أو محذوف، أو مُبلّغ عنه، أو مقفل، أو تجاوز الحد | غير قابل للإرسال | **Disabled** |

تظهر القوالب المحفوظة في Flowella وغير المنشورة بعد بحالة **Draft**. لا تعرف Meta عنها شيئًا حتى تنشرها. للإيقاف المؤقت، راجع [تنظيم وتيرة القوالب وإيقافها مؤقتًا](https://knowledge.flowella.io/ar/whatsapp/limits/template-pacing-and-pausing.md). لإجراءات الحالة في المحرر، راجع [حالات القوالب](https://knowledge.flowella.io/ar/app/template-reference.md#template-statuses).

## عدد القوالب المسموح به

| محفظة أعمالك | القوالب لكل WhatsApp Business Account |
| - | - |
| غير موثقة | 250 |
| [موثقة](https://knowledge.flowella.io/ar/whatsapp/accounts/business-verification.md)، ولرقم واحد على الأقل [اسم عرض](https://knowledge.flowella.io/ar/whatsapp/accounts/display-names.md) معتمد | 6,000 |

تُحتسب كل نسخة لغوية قالبًا واحدًا. ولا يمكنك أيضًا إنشاء أكثر من 100 قالب في WhatsApp Business Account واحد خلال ساعة.

عندما تصل إلى الحد، ترفض Meta القوالب الجديدة بالخطأ 2388019. تذكر رسالة Flowella لهذا الخطأ الرقم 250، وهو حد المحافظ غير الموثقة. لإفساح المجال، احذف القوالب التي لم تعد تستخدمها، أو وثّق نشاطك التجاري لرفع الحد. راجع [تنظيم القوالب](https://knowledge.flowella.io/ar/whatsapp/templates/template-housekeeping.md).

## حدود أخرى على الإرسال

لا تعني الموافقة أن كل إرسال سيُسلَّم. تنطبق هذه الحدود إضافة إلى ذلك:

* [حدود المراسلة](https://knowledge.flowella.io/ar/whatsapp/limits/messaging-limits.md): عدد الأشخاص الذين يمكنك بدء محادثات معهم خلال 24 ساعة.
* [تنظيم وتيرة القوالب وإيقافها مؤقتًا](https://knowledge.flowella.io/ar/whatsapp/limits/template-pacing-and-pausing.md): تحتجز Meta القوالب التي تتلقى ملاحظات سلبية أو توقفها.
* [الحد التسويقي لكل مستخدم](https://knowledge.flowella.io/ar/whatsapp/limits/per-user-marketing-limit.md): يحدّ WhatsApp من عدد القوالب التسويقية التي يتلقاها كل شخص.
* [الأرشفة](https://knowledge.flowella.io/ar/whatsapp/templates/template-housekeeping.md#archival): تُؤرشف القوالب غير المستخدمة لمدة 12 شهرًا، ثم تُحذف.

## مدة الصلاحية

إذا لم يتمكن WhatsApp من تسليم قالب، على سبيل المثال لأن الهاتف مغلق، فإنه يواصل المحاولة لفترة تُسمى مدة الصلاحية (TTL). بعد ذلك يتخلى عن الرسالة، ولا تتلقى حالة التسليم.

| الفئة | القيمة الافتراضية لدى Meta | النطاق الذي تسمح به Meta |
| - | - | - |
| Authentication | 10 دقائق (30 يومًا للقوالب المنشأة قبل 23 أكتوبر 2024) | من 30 ثانية إلى 15 دقيقة |
| Utility | 30 يومًا | من 30 ثانية إلى 12 ساعة |
| Marketing | 30 يومًا | من 12 ساعة إلى 30 يومًا، عبر Marketing Messages API فقط |

> [!NOTE]
>
> **في Flowella.** لا يوفر Flowella إعدادًا لمدة الصلاحية، لذا تستخدم قوالبك القيم الافتراضية لدى Meta. إذا غيّرت Meta فئة قالب، فإنها تمسح أي مدة صلاحية مخصصة مضبوطة في WhatsApp Manager.

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

عندما ترسل عدة رسائل متتالية إلى شخص واحد، لا يضمن WhatsApp وصولها بالترتيب الذي أرسلتها به. إذا كان الترتيب مهمًا، فانتظر حالة **delivered** للرسالة الأولى قبل إرسال التالية. راجع [حالات الرسائل](https://knowledge.flowella.io/ar/whatsapp/messaging/message-statuses.md).

## ذو صلة

> [card] [فئات القوالب](https://knowledge.flowella.io/ar/whatsapp/templates/template-categories.md)
>
> Marketing أو Utility أو Authentication، ومتى تغيّرها Meta.

> [card] [مراجعة القوالب](https://knowledge.flowella.io/ar/whatsapp/templates/template-review.md)
>
> أسباب رفض القوالب وكيفية الطعن.

> [card] [القوالب في Flowella](https://knowledge.flowella.io/ar/app/templates.md)
>
> أنشئ القوالب واختبرها وأدِرها.

> [card] [أسعار WhatsApp](https://knowledge.flowella.io/ar/whatsapp/pricing/whatsapp-pricing.md)
>
> تكلفة كل فئة.

تمت المراجعة مقابل وثائق Meta في 18 نوفمبر 2026: [Template fundamentals](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview) و[Template management](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-management) و[Time-to-live](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/time-to-live).


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