> ## 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 — الفئات والرؤوس والنص والأزرار والمتغيرات وأنواع القوالب المتقدمة ودورة حياة الإرسال. للحصول على خطوات إنشاء قالب واختباره، راجع [القوالب](/ar/app/templates). لحدود تنسيقات الوسائط، راجع [رؤوس الوسائط](/ar/app/media-in-template-headers).

## الفئات

يحتوي كل قالب على فئة واحدة بالضبط، يتم تعيينها عند إرسالها إلى Meta. الفئة تحدد **التسعير** و **ما هو المحتوى المسموح به**.

| الفئة | استخدمها لـ | ملاحظات |
| - | - | - |
| **تسويق (Marketing)** | العروض الترويجية والدعوات إلى الفعاليات وإعادة التفاعل | أغلى فئة؛ تخضع لقواعد الاشتراك |
| **مرافق (Utility)** | تحديثات الطلبات وتنبيهات الحساب والتذكيرات والمتابعات لتدفق يبدأه المستخدم | أرخص من التسويق؛ يجب أن يرتبط المحتوى بمعاملة أو طلب معين |
| **مصادقة (Authentication)** | كلمات المرور لمرة واحدة ورموز التحقق من الحساب | تنسيق صارم؛ لا يُسمح بمحتوى تسويقي؛ الفئة الأرخص |

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

## تنسيقات الرأس

رأس القالب اختياري. عندما يكون موجودًا، يمكن أن يكون واحدًا مما يلي:

* **TEXT** — سلسلة قصيرة، قد تتضمن متغيرًا واحدًا.
* **IMAGE** — JPEG أو PNG، بحد أقصى 5 ميغابايت. راجع [رؤوس الوسائط](/ar/app/media-in-template-headers).
* **VIDEO** — MP4 أو 3GPP مع H.264/AAC، بحد أقصى 16 ميغابايت.
* **DOCUMENT** — PDF (الأكثر موثوقية)، تنسيقات Office، أو نص عادي. بحد أقصى 100 ميغابايت. يحتوي المحرر على حقل **اسم ملف المستند** الذي يُعبَّأ افتراضيًا من الملف المُحمَّل؛ القيمة التي تعيّنها هناك هي ما يراه المستلم على فقاعة مستند WhatsApp، لذا اختر شيئًا وصفيًا مثل `Acme-Order-12345-Receipt.pdf`.
* **LOCATION** — خط العرض وخط الطول والاسم والعنوان. مفيد لزيارات المتجر أو تأكيدات التسليم.

يمكن إرفاق رؤوس الوسائط إما كـ **مقبض وسائط** (مُحمَّل مرة واحدة إلى Meta) أو كـ **عنوان URL عام HTTPS** يتم جلبه لكل إرسال. راجع [رؤوس الوسائط](/ar/app/media-in-template-headers) للاطلاع على المقايضات.

## النص والمتغيرات

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

```text theme={null}
Hi {{1}}, your order {{2}} has shipped. Track it here: {{3}}
```

القواعد:

* يجب أن تكون الأرقام متتالية بدءًا من `{{1}}` — لا يمكنك تخطي الفهارس.
* قدّم قيمة عينة لكل متغير عند الإرسال. تستخدم Meta العينات لتقييم القالب.
* احتفظ بالمتغيرات كقيم قصيرة ومتوقعة. الكتل الطويلة الملصقة هي سبب رفض شائع.

يتم استخدام نفس صيغة `{{n}}` في **رؤوس TEXT** و **أزرار URL** (انظر أدناه).

### التنسيق في النص

يدعم WhatsApp مجموعة محدودة من التنسيق المضمّن في نصوص القوالب:

* **غامق** بـ `*asterisks*`
* **مائل** بـ `_underscores_`
* **يتوسطه خط** بـ `~tildes~`
* **أحادي المسافة** بثلاث علامات backtick

استخدم التنسيق باعتدال. القوالب ذات التنسيق الثقيل غالبًا ما تُرفض لكونها تبدو مثل البريد المزعج.

## التذييل

نص عادي اختياري يظهر بعد النص. بدون متغيرات، بدون تنسيق.

## الأزرار

يمكن أن يتضمن القالب ما يصل إلى **10 أزرار إجماليًا**، مجمّعة إما كردود سريعة أو دعوة إلى إجراء. تحوّلت التركيبات التي تسمح بها Meta عبر إصدارات Cloud API؛ الأنماط الأكثر موثوقية:

| نوع الزر | ما يفعله | مثال | متغير؟ |
| - | - | - | - |
| **QUICK\_REPLY** | يرسل ردًا نصيًا محدّدًا مسبقًا إلى عملك | `Yes, that's me` | لا |
| **URL** | يفتح صفحة ويب | `https://acme.com/orders/{{1}}` | واحد في عنوان URL |
| **PHONE** | يتصل برقم هاتف | `+44 20 7946 0000` | لا |
| **COPY\_CODE** | ينسخ رمزًا إلى الحافظة | `SAVE20` | واحد للرمز |
| **FLOW** | يفتح WhatsApp Flow | (معرّف التدفق المرتبط) | متغيرات عبر التدفق نفسه |
| **CATALOG** | يفتح كتالوج WhatsApp الخاص بك | (معرّف الكتالوج المرتبط) | لا |
| **MPM** | مشغّل رسالة متعدد المنتجات | (منتجات الكتالوج) | لا |
| **VOICE\_CALL** | يبدأ مكالمة صوتية WhatsApp (حيث يكون مدعومًا) | (رقم عملك) | لا |

تُعد أزرار الرد السريع مفيدة عندما تريد ردًا منظمًا (مفيد للتحليلات). أزرار URL والهاتف مفيدة لتوجيه المستلمين خارج WhatsApp إلى مجموعتك التقنية. أزرار FLOW هي البوابة إلى التدفقات المدفوعة بنموذج HubSpot التي يتخصّص فيها Flowella.

## أنواع القوالب المتخصصة

لدى Meta العديد من أنواع قوالب التسويق المتخصصة التي تجمع وظائف إضافية فوق البنية الأساسية.

### قوالب العرض الدوار (Carousel)

يرسل قالب العرض الدوار (تسميه Meta العرض الدوار لبطاقات الوسائط) فقاعة رسالة تليها ما يصل إلى 10 بطاقات في تمرير أفقي. لكل بطاقة وسائطها الخاصة، ونص اختياري، وأزرار. استخدم العروض الدوارة لعرض الكتالوج، والعروض متعددة المنتجات، أو مقارنات الميزات.

* **للتسويق فقط.** لا يمكن لقوالب العرض الدوار استخدام سوى فئة **التسويق**.
* **من 2 إلى 10 بطاقات** لكل قالب.
* **لا رأس ولا تذييل للرسالة.** تحتوي الرسالة على نص فقط. بدلاً من ذلك، تحمل كل بطاقة رأس الوسائط الخاص بها، ولا يمكن أن تحتوي الرسالة نفسها على أزرار.
* **نوع وسائط واحد لكل قالب.** تستخدم كل البطاقات رأس صورة، أو تستخدم كل البطاقات رأس فيديو. لا يمكنك الخلط بينهما.
* **نص البطاقة اختياري، حتى 160 حرفًا.** إذا كان لبطاقة واحدة نص، فإن كل البطاقات تحتاج إلى نص.
* **ما يصل إلى زرين لكل بطاقة** (رد سريع، URL، أو رقم هاتف).
* **نفس بنية الأزرار في كل بطاقة.** تحتوي كل بطاقة على نفس عدد الأزرار، بنفس الأنواع وبنفس الترتيب. يمكن أن تختلف تسميات الأزرار وعناوين URL وأرقام الهواتف من بطاقة لأخرى.

الموافقة لكل قالب (وليس لكل بطاقة)، لذا يجب أن تلتزم جميع البطاقات بفئة التسويق. راجع وثائق Meta حول [قوالب العرض الدوار لبطاقات الوسائط](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/media-card-carousel-templates) للاطلاع على المواصفات الكاملة. لإنشاء واحد في Flowella، راجع [إنشاء قالب عرض دوار](/ar/app/templates#build-a-carousel-template).

### قوالب العرض المحدود المدة (LTO)

تعرض قوالب LTO عدّاد تنازلي أسفل النص. بمجرد انتهاء المؤقت، يظهر العرض كمنتهي الصلاحية والنقر على CTA لا يفعل شيئًا.

* مطلوب معلمة **رمز الصفقة** ويتم عرضها للمستخدم.
* مطلوب **حقبة انتهاء الصلاحية (بالثواني)**.
* عادة ما يكون زر CTA هو نسخ الرمز أو URL.

الأفضل للعروض الحقيقية محدودة الوقت — استخدام LTO للعروض التي لا تنتهي فعليًا يسبب شكاوى المستخدمين وإعادة تصنيف الفئة بعيدًا عن التسويق.

### قوالب رمز الكوبون

مثل LTO ولكن بدون العد التنازلي — فقط رمز يمكن للمستخدم نسخه بنقرة واحدة.

* يمكن أن يكون الرمز **حتى 20 حرفًا** (زيد مؤخرًا من 15).
* ينسخ زر نسخ الرمز القيمة المُقدَّمة في **وقت الإرسال** — حقل `example` الخاص بالقالب هو عنصر نائب فقط ولا يتم إرساله أبدًا.
* في **القوالب → علامة تبويب الإرسال** و **مربع حوار قالب صندوق الوارد**، تعرض قوالب رمز الكوبون إدخال **أزرار رمز الكوبون** المخصص حيث تكتب الرموز التي تريد إرسالها فعليًا (واحد لكل صف مستلم للإرسالات المجمّعة). تم استبدال التسميات القديمة "نسخ الرمز" / "أزرار نسخ رمز الكوبون" بهذا المصطلح الفردي المتسق.

### قوالب المصادقة

قوالب متخصصة لتسليم OTP. ثلاثة أنواع فرعية:

* **الملء التلقائي بنقرة واحدة** — يستخدم Android's autofill API لملء OTP تلقائيًا عند نقر المستخدم على الزر. أفضل تجربة مستخدم حيثما يكون مدعومًا.
* **نسخ الرمز** — يعرض زر نسخ؛ يلصق المستخدم الرمز في تطبيقك. يعمل في كل مكان.
* **بدون نقرة (Zero-tap)** — للمرسلين الموثوق بهم، يمكن تسليم OTP دون أي نقرة (استدعاء API تلقائي من عميل WhatsApp إلى تطبيقك). أهلية صارمة.

قوالب المصادقة لديها أرخص سعر لكل رسالة ولكن أشد قواعد المحتوى: لا محتوى تسويقي، لا نص جسم إضافي بخلاف الرمز نفسه.

### قوالب الموقع

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

**رأس الموقع كمتغيرات**

يحمل رأس LOCATION ما يصل إلى أربعة حقول — **خط العرض** و **خط الطول** و **الاسم** و **العنوان** — ويتعامل Flowella مع الأربعة كمتغيرات قالب عادية.

* تصبح القيم التي كتبتها في المحرر (تحت `_flowellaEditor.headerLocationPreview`) هي **الافتراضية** التي يتم إرسالها إذا لم يتم توفير تجاوز.
* تعرض مربعات حوار **اختبار القالب** وإرسال صندوق الوارد الحقول الأربعة كمدخلات متغيرة عادية.
* يمرر إجراء [إرسال قالب WhatsApp](/ar/hubspot/workflow-actions#send-whatsapp-template) في HubSpot القيم الأربع عبر `headerLocation` بحيث يمكن لسير العمل تخصيص الدبوس لكل مستلم.

إذا حذفت أيًا من الأربعة في وقت الإرسال، فإن Flowella يعود إلى قيمة معاينة المحرر لهذا الحقل.

## دورة حياة الإرسال

عند إرسال قالب من Flowella، فإنه يمر عبر هذه الحالات:

<Steps>
  <Step title="DRAFT">
    محفوظ في Flowella ولكن لم يتم إرساله بعد إلى Meta.
  </Step>

  <Step title="PENDING">
    تم إرساله إلى Meta وقيد المراجعة. تجتاز معظم القوالب المراجعة الآلية من Meta في غضون دقائق، ولكن بعضها يُوجَّه للمراجعة البشرية. يخبرك محرر Flowella أن الموافقة **قد تستغرق ما يصل إلى 12 ساعة** ويرسل لك **بريدًا إلكترونيًا** في اللحظة التي تتغير فيها الحالة — لا تحتاج إلى الاستمرار في التحديث.
  </Step>

  <Step title="APPROVED">
    نشط وقابل للاستخدام. يمكنك إرساله من صندوق الوارد و API وسير عمل HubSpot.
  </Step>

  <Step title="REJECTED">
    رفضت Meta القالب. يظهر سبب الرفض في صفحة القالب. حرّر وأعد الإرسال.
  </Step>

  <Step title="FLAGGED">
    راجعت Meta تعليقات الجودة وميّزت القالب بعلامة. عادة ما تكون مقدمة لـ PAUSED.
  </Step>

  <Step title="PAUSED">
    قامت Meta بتقييد إرسال القالب مؤقتًا، عادةً بسبب تعليقات المستلمين أو الجودة المنخفضة. يعود تلقائيًا إذا تعافت الجودة.
  </Step>

  <Step title="DISABLED">
    قامت Meta بتقييد القالب بشكل دائم. يجب إعادة إرساله كقالب جديد (غالبًا معاد تصنيفه) إذا كنت تريد استخدام المحتوى مرة أخرى.
  </Step>
</Steps>

## تصنيف الجودة

بمجرد الموافقة، يبني كل قالب تصنيف جودة خاص به — منفصل عن [تصنيف جودة رقم الهاتف](/ar/meta/quality-score). يستخدم التصنيف على مستوى القالب نفس مقياس الأخضر/الأصفر/الأحمر ويعتمد في الغالب على:

* معدل الحظر بين المستلمين
* تكرار إجراءات "الإبلاغ" في WhatsApp
* انخفاض التفاعل المستمر (لا ردود، لا نقرات على الروابط)

يمكن أن تتسبب التصنيفات الصفراء والحمراء للقوالب في إيقاف Meta مؤقتًا للقالب حتى لو كان تصنيف رقم الهاتف نفسه أخضر. راقب جودة القالب في **Flowella → القوالب** جنبًا إلى جنب مع التصنيف على مستوى الرقم.

## وقت البقاء (TTL)

يمكن أن تحتوي القوالب على **وقت بقاء** يتحكم في المدة التي ستحاول فيها Meta التسليم قبل الاستسلام. مفيد للإرسالات الحساسة للوقت مثل دعوات البيع السريع.

* **الافتراضي:** 30 يومًا لمعظم القوالب.
* **قوالب OTP / المصادقة:** أقصر بكثير (بضع دقائق افتراضيًا)، لأن الرموز ليس لها قيمة بمجرد أن تصبح قديمة.
* **TTL مخصص:** يمكن تعيينه لكل إرسال لبعض أنواع القوالب.

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

## أسباب الرفض الشائعة

* **محتوى ترويجي مُرسَل كمرافق.** أعد الإرسال كتسويق.
* **عينات متغيرات لا تطابق النص** — على سبيل المثال، عينات تحتوي على روابط لا يبررها النص.
* **نص جسم أو رأس يبدو مثل البريد المزعج** — استخدام مفرط للأحرف الكبيرة، "انقر هنا"، "مجاني!!!"، علامات تعجب متعددة.
* **عناوين URL معطلة أو غير قابلة للوصول لرؤوس الوسائط.**
* **نص تذييل يتناقض مع النص الأساسي.**
* **قوالب عامة** يمكن لأي شخص إرسالها — `Hi {{1}}, special offer for you` بدون تفاصيل عام جدًا للموافقة على التسويق.
* **متغيرات في السياق الخاطئ** — استخدام متغير في مكان لا تسمح به Meta (على سبيل المثال، بعض أنواع الأزرار).
* **الاسم المعروض لا يطابق العلامة التجارية** لمحتوى القالب. إذا كان الاسم المعروض لـ WABA هو "Acme" والقالب يروّج لـ "Beta Co"، فسيتم رفضه.

<Tip>
  حرّر نسخة من قالب APPROVED بدلاً من الأصل، حتى تحتفظ بإصدار عمل بينما تراجع Meta التغييرات. **القوالب → تكرار** في Flowella يفعل هذا نيابةً عنك، وينسخ وسائط الرأس (IMAGE أو VIDEO أو DOCUMENT) و **اسم ملف المستند** إلى المسودة الجديدة حتى لا تضطر إلى إعادة التحميل قبل النشر. إذا لم يستطع Flowella نسخ الوسائط (على سبيل المثال عندما يكون عنوان URL الأصلي للعينة غير قابل للوصول)، يعرض المحرر تحذيرًا ويمنع النشر حتى تعيد تحميل الملف.
</Tip>

## أدلة ذات صلة

* [القوالب](/ar/app/templates) — بناء قالب خطوة بخطوة
* [رؤوس الوسائط](/ar/app/media-in-template-headers) — مرجع تنسيق الوسائط
* [قالب مرفوض](/ar/troubleshooting/template-rejected) — تشخيص حالات الرفض
* [نقاط الجودة](/ar/meta/quality-score) — كيف تتفاعل جودة رقم الهاتف مع جودة القالب
* [حدود المراسلة](/ar/meta/messaging-limits) — نظام المستويات الذي يحدد عدد القوالب التي يمكنك إرسالها


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