> ## 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 المعتمدة من Meta مع رؤوس ومتن وأزرار، اختبرها على جهاز حقيقي، ثم أرسلها بشكل مجمّع مع استيراد CSV والجدولة والتقدم المباشر.

<Frame>
  <img src="https://mintcdn.com/flowella/QH2KmtfTITL7teRo/images/Screenshots/flowella-whatsapp-templates.png?fit=max&auto=format&n=QH2KmtfTITL7teRo&q=85&s=9b67e4775011f71dc80bc6f2f5baa18a" alt="Flowella WhatsApp templates list" width="2772" height="1686" data-path="images/Screenshots/flowella-whatsapp-templates.png" />
</Frame>

قوالب WhatsApp هي تنسيقات رسائل معتمدة مسبقًا تتيح لك إرسال رسائل منظمة إلى جهات اتصالك. وهي ضرورية للوصول إلى الأشخاص خارج نافذة خدمة العملاء التي تمتد 24 ساعة — للإشعارات والتحديثات والتذكيرات وغيرها. يمكن أن تتضمن القوالب وسائط غنية مثل الصور ومقاطع الفيديو ومتغيرات نصية ديناميكية وأزرار تفاعلية.

## ما هي القوالب ولماذا تحتاج إلى موافقة Meta

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

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

<Note>
  غالبًا ما تكون الموافقة فورية تقريبًا. تُجري Meta مراجعة آلية في المرحلة الأولى تمنح موافقة لمعظم القوالب خلال دقائق، لكن أي شيء يُحال إلى مراجعة بشرية قد يستغرق **حتى 48 ساعة**. قدّم القوالب مسبقًا حتى لا تعيق المراجعة الأبطأ أي إرسال إنتاج.
</Note>

<Tip>
  هل تبحث عن مرجع سريع للفئات وتنسيقات الرأس وأنواع الأزرار وصياغة المتغير `{{n}}` ودورة حياة التقديم؟ راجع [مرجع القوالب](/app/template-reference).
</Tip>

## إنشاء قالب

<Steps>
  <Step title="انتقل إلى القوالب">
    انقر على **القوالب** في الشريط الجانبي الأيسر.

    <Tip>
      هذا هو الموقع المركزي لجميع قوالب رسائل WhatsApp الخاصة بك. من هنا يمكنك عرض وتعديل وتتبع حالة الموافقة لكل قالب لدى حسابك.
    </Tip>
  </Step>

  <Step title="ابدأ قالبًا جديدًا">
    انقر على **قالب جديد** للبدء.

    <Tip>
      قبل البدء، احرص على وجود فكرة واضحة عن غرض قالبك — تأكيد طلب، تذكير بموعد، رسالة ترويجية، وما إلى ذلك. الهدف الواضح يجعل كتابة نص يجتاز مراجعة Meta أسهل.
    </Tip>
  </Step>

  <Step title="سمّ القالب">
    أدخل اسمًا وصفيًا يعكس غرض القالب.

    <Tip>
      استخدم الأحرف الصغيرة والأرقام والشرطات السفلية فقط — على سبيل المثال، `order_confirmation` أو `appointment_reminder`. لا تسمح Meta بالمسافات أو الأحرف الخاصة.
    </Tip>
  </Step>

  <Step title="أضف رأسًا مرئيًا">
    أضف اختياريًا صورة أو فيديو كرأس للقالب لجعل رسالتك أكثر جاذبية.

    <Note>
      وسائط الرأس اختيارية ولكن موصى بها. يجب أن تكون الصور أقل من 5 ميغابايت والفيديوهات أقل من 10 ميغابايت. يجب أن تكون مقاطع الفيديو أقل من 60 ثانية وتبدأ بإطار جذاب.
    </Note>
  </Step>

  <Step title="اكتب متن الرسالة">
    أدخل نص المتن الرئيسي للقالب. اجعله واضحًا وموجزًا وملائمًا لجمهورك.

    <Tip>
      استخدم الأقواس المجعدة المزدوجة لإضافة متغيرات ديناميكية — على سبيل المثال، `Hi {{1}}, your order {{2}} is ready for pickup!`. يتم استبدالها ببيانات جهة الاتصال الحقيقية عندما يرسل Flowella الرسالة.
    </Tip>

    <Note>
      تجنب اللغة الترويجية المفرطة. تبحث مراجعة Meta عن رسائل توفر قيمة واضحة للمستلم.
    </Note>
  </Step>

  <Step title="أضف زرًا">
    انقر على **إضافة زر إلى قالبك** لتضمين عنصر تفاعلي.

    <Tip>
      تمنح الأزرار جهات الاتصال خطوة تالية واضحة وتزيد من التفاعل. يمكنك إضافة ما يصل إلى ثلاثة أزرار لكل قالب.
    </Tip>
  </Step>

  <Step title="اختر نوع الزر">
    اختر نوع الزر الذي يناسب حالة استخدامك:

    * **زر دعوة للإجراء** — يوجه المستخدمين إلى موقع ويب أو رقم هاتف.
    * **زر رد سريع** — يتيح للمستخدمين الاستجابة بنص محدد مسبقًا.
    * **زر URL** — يرسل المستخدمين إلى صفحة ويب محددة.

    <Note>
      يمكنك مزج أنواع الأزرار في نفس القالب. على سبيل المثال، اجمع بين زر URL بعنوان "عرض الطلب" وزر رد سريع بعنوان "الاتصال بالدعم".
    </Note>
  </Step>

  <Step title="عيّن قيمة الزر">
    أدخل الإجراء أو الوجهة للزر — على سبيل المثال، رقم هاتف لزر اتصال أو URL لزر رابط.
  </Step>

  <Step title="أضف نص الزر">
    أدخل التسمية التي ستظهر على الزر. اجعلها موجهة نحو الإجراء وواضحة — على سبيل المثال، "تعرف على المزيد"، أو "اتصل بنا"، أو "ابدأ".

    <Note>
      الحد الأقصى لنص الزر هو 25 حرفًا. استخدم أفعال إجراء قصيرة واجعل من الواضح ما يحدث عند النقر على الزر.
    </Note>
  </Step>

  <Step title="أنشئ القالب">
    انقر على **إنشاء القالب** لحفظ قالبك وتقديمه.

    <Note>
      يؤدي تقديم القالب إلى إرساله إلى Meta للمراجعة. وغالبًا ما يكون ذلك فوريًا تقريبًا، حيث تجتاز معظم القوالب المراجعة الآلية لـ Meta خلال دقائق، رغم أن بعضها يُحال إلى مراجعة بشرية وقد يستغرق حتى 48 ساعة.
    </Note>

    <Tip>
      أثناء المراجعة، تتحقق Meta من الامتثال للسياسة. تأكد من أن قالبك يوفر قيمة واضحة للمستلمين ويتجنب اللغة الترويجية التي قد تؤدي إلى الرفض.
    </Tip>
  </Step>

  <Step title="انتظر الموافقة">
    تنتهي القوالب المقدمة في حالة **قيد الانتظار**. تجتاز معظمها المراجعة الآلية لـ Meta خلال دقائق؛ بعضها يُحال إلى مراجعة بشرية.

    <Note>
      تخبرك Meta أن الموافقة **قد تستغرق ما يصل إلى 12 ساعة** وسيرسل لك Flowella **بريدًا إلكترونيًا** بمجرد تغيير الحالة. لست بحاجة إلى الاستمرار في تحديث الصفحة.
    </Note>
  </Step>
</Steps>

بمجرد موافقة Meta على القالب، يمكنك استخدامه في سير عمل Flowella، والتدفقات الآلية، وصندوق الوارد، والإرسال المجمّع.

## سلوك المحرر

تم تصميم محرر القوالب بحيث لا يفقد العمل أبدًا.

* **الحفظ التلقائي** — كل تغيير في الاسم أو اللغة أو الفئة أو القناة أو المكونات يُحفظ بعد توقف قدره ثانية تقريبًا. يعرض شريط إجراءات سفلي ثابت حالة الحفظ الحالية (**جارٍ الحفظ…**، **محفوظ**، أو **تغييرات غير محفوظة**).
* **النشر مقيد بالحفظ** — يظل زر **نشر** معطلاً حتى يكتمل آخر حفظ تلقائي، حتى لا ترسل مسودة غير مكتملة الحفظ إلى Meta أبدًا.
* **فواصل أسطر المتن ومسافات التذييل** محفوظة عبر تبديل علامات التبويب والحفظ — ما تكتبه هو ما تتلقاه Meta.
* **تبدأ أزرار الرد السريع فارغة** مع نائب. يُمنع حفظ أو نشر قالب يحتوي على نص رد سريع فارغ بواسطة التحقق الداخلي (`BUTTON_TEXT_REQUIRED`).
* **القائمة المنسدلة للفئة** تعرض التسمية المحددة فقط عند الإغلاق؛ يكشف فتحها عن أوصاف متوافقة مع Meta، وملاحظة إعادة التصنيف، ورابط إلى [مرجع القوالب](/app/template-reference).

## اختبار قالب

لاختبار قالب قبل استخدامه مع جهات اتصال حقيقية، افتح القالب وانتقل إلى علامة تبويب **الإرسال**.

<Steps>
  <Step title="افتح علامة تبويب الإرسال">
    من **القوالب**، انقر على القالب الذي تريد اختباره، ثم حدد علامة التبويب **الإرسال**.
  </Step>

  <Step title="أدخل رقمك">
    تحت **اختبار القالب**، اختر **رمز الدولة** وأدخل رقم WhatsApp الذي يمكنك تلقي رسائل عليه.

    <Note>
      يجب أن يكون الرقم بالتنسيق الدولي مع رمز الدولة — على سبيل المثال، `+44123456789`.
    </Note>
  </Step>

  <Step title="املأ أي متغيرات مطلوبة">
    قدّم قيمة لكل متغير قالب. بالنسبة لقوالب **كود القسيمة**، أدخل الأكواد الحرفية التي تريد إرسالها — قيمة العينة للقالب هي **نائب فقط** ولا تُستخدم أبدًا في وقت الإرسال.
  </Step>

  <Step title="أرسل الاختبار">
    انقر على **إرسال اختبار**.

    <Tip>
      يمكنك إرسال اختبار حتى أثناء انتظار القالب موافقة Meta. يتيح لك الاختبار رؤية كيف ستظهر الرسالة بالضبط لجهات الاتصال قبل استخدامها في الإنتاج.
    </Tip>
  </Step>

  <Step title="تحقق على الجهاز">
    افتح الرسالة على جهازك وتأكد من عرض وسائط الرأس وتنسيق المتن والأزرار بشكل صحيح. تحقق على كل من iOS و Android إن أمكن.
  </Step>
</Steps>

## الإرسال المجمّع

تتيح لك علامة تبويب **الإرسال** أيضًا إرسال قالب **APPROVED** إلى العديد من المستلمين في مهمة واحدة — مفيدة للإعلانات التسويقية، أو التذكيرات الدفعية، أو أي إرسال صادر منظم لا يناسب صندوق الوارد.

### بناء قائمة المستلمين

يقع محرر قائمة المستلمين أسفل **اختبار القالب** في علامة تبويب الإرسال.

* **أضف صفوفًا يدويًا** — صف واحد لكل مستلم، مع عمود للهاتف وعمود واحد لكل متغير قالب.
* **استيراد من CSV** — انقر على **استيراد CSV** واختر ملفًا. استيراد ملف CSV هو الطريقة الوحيدة لاستيراد المستلمين بشكل مجمّع؛ لا يُدعم لصق الصفوف.
* **نزّل ملف CSV النموذجي** — يولّد Flowella ملف بداية برؤوس الأعمدة الصحيحة للقالب المحدد (الهاتف + كل متغير). استخدمه كأساس لقائمتك الخاصة.
* أزل الصفوف باستخدام إجراء الحذف على مستوى الصف.

<Tip>
  يجب أن تكون أرقام الهاتف بالتنسيق الدولي الكامل (`+447700900000`). راجع [تنسيق رقم الهاتف](/hubspot/phone-number-format).
</Tip>

### الجدولة والتقييد

* **الجدولة** — أرسل فورًا، أو اختر تاريخًا ووقتًا مستقبليين.
* **التقييد** — اختر عدد الرسائل في الثانية التي يرسلها Flowella إلى Meta. قيّد الإرسال أقل من **فئة حد المراسلة** لرقم هاتفك لتجنب الارتفاعات المفاجئة التي تضر بدرجة الجودة. راجع [حدود المراسلة](/meta/messaging-limits).

### مراقبة تشغيل المهمة

بمجرد النقر على **بدء الإرسال**، تعرض علامة التبويب **الإحصائيات** على نفس القالب **شريط تقدم مباشر** (يُسلَّم عبر دفق SSE) و**مربعات ملخص المهمة**: الإجمالي في قائمة الانتظار، المُرسل، المُسلَّم، المقروء، الفاشل، و**المُستبعَد**.

تُستخدم حالة **مُستبعَد** عندما يسقط Flowella صفًا لأن نفس الزوج `(template, phone)` قد أُرسل بالفعل داخل **نافذة إزالة التكرار**. هذا يمنع التكرارات العرضية إذا أعدت استيراد ملف CSV أو أعدت تشغيل جدول.

يمكنك مغادرة الصفحة — تستمر المهمة في التشغيل من جانب الخادم ويُطلَق إشعار عند اكتمالها.

### عمود التفاصيل لكل إرسال

يحتوي كل صف في **الإحصائيات ← سجل الإرسال** على عمود **التفاصيل** يشرح النتيجة باللغة الإنجليزية البسيطة بدلاً من كود خطأ Meta. يحل نص التفاصيل سبب الفشل من `meta_webhook_logs` وحمولة التسليم المحفوظة، بحيث تظهر إخفاقات Meta بعد الإرسال (على سبيل المثال، طريقة الدفع **131042**) تمامًا مثل إخفاقات المهمة قبل الإرسال.

| التفصيل                             | ما يعنيه                                                                                                     |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **تم التسليم**                      | أكدت Meta التسليم.                                                                                           |
| **هاتف غير صالح**                   | رقم هاتف المستلم ليس رقم WhatsApp صالحًا.                                                                    |
| **ألغى الاشتراك**                   | جهة الاتصال موجودة في قائمة إلغاء الاشتراك.                                                                  |
| **جهة الاتصال مفقودة**              | تعذّر تحويل الهاتف إلى جهة اتصال Flowella في وقت الإرسال.                                                    |
| **عنوان URL لوسائط الرأس غير صالح** | يحتوي القالب على رأس وسائط لا يمكن استخدام عنوان URL النموذجي الخاص به للإرسال. أعد تحميل الوسائط في المحرر. |
| **طريقة الدفع (131042)**            | رفضت Meta الإرسال لأن طريقة الدفع الخاصة بـ WABA غير صالحة أو ليس بها رصيد كافٍ.                             |
| **خطأ آخر في Meta API**             | فشل غير محدد من Meta — أعد الإرسال إذا كانت المشكلة عابرة.                                                   |
| **فشل تسليم غير معروف**             | قبلت Meta الإرسال ولكنها أبلغت لاحقًا أنه تعذر تسليمه.                                                       |

شارات الحالة مترجمة إلى لغة واجهة المستخدم في حسابك.

## ذات صلة

<CardGroup cols={2}>
  <Card title="مرجع القوالب" icon="file-text" href="/app/template-reference">
    الفئات والرؤوس والأزرار والمتغيرات ودورة حياة التقديم.
  </Card>

  <Card title="متغيرات القوالب" icon="curly-braces" href="/app/template-variables">
    الصياغة، وقيم العينة، وتعيين HubSpot، وفخاخ الرفض.
  </Card>

  <Card title="رؤوس الوسائط" icon="image" href="/app/media-in-template-headers">
    تنسيقات وأحجام الوسائط التي يقبلها WhatsApp في رؤوس القوالب.
  </Card>

  <Card title="القالب مرفوض" icon="bug" href="/troubleshooting/template-rejected">
    أسباب الرفض الشائعة من Meta وكيفية إصلاحها.
  </Card>

  <Card title="التسعير والفئات" icon="badge-dollar-sign" href="/account/pricing-and-conversation-categories">
    كيف تحدد فئة القالب تسعير Meta لكل محادثة.
  </Card>

  <Card title="إجراءات سير العمل" icon="git-branch" href="/hubspot/workflow-actions">
    أرسل قوالبك المعتمدة من سير عمل HubSpot.
  </Card>
</CardGroup>