> ## 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>

## إنشاء قالب

### اختيار نقطة البداية

يؤدي النقر على **New Template** (أو الانتقال إلى `/{org}/templates/new`) إلى فتح أداة اختيار تتيح لك ثلاث طرق للبدء:

* **Build your own** — اكتب الرسالة بنفسك. اختر أحد خيارين:
  * **Standard message** — افتح المحرر الفارغ لقالب يحتوي على رأس اختياري ومتن وتذييل وأزرار.
  * **Carousel** (مُعلَّم بـ **NEW**) — افتح محرر العرض الدوار لبناء مجموعة قابلة للتمرير من بطاقات الصور أو الفيديو. راجع [إنشاء قالب عرض دوار](#build-a-carousel-template).
* **Meta Library** — تصفّح كتالوج Meta الخاص بقوالب الأدوات المُعدّة مسبقًا. هذه القوالب مُدقّقة مسبقًا من Meta وعادةً ما تُعتمد بسرعة.
* **Flowella Templates** — كتالوج مُنسَّق من قوالب البداية التي تعرض إمكانيات Flowella (أزرار Flow، والقسائم، وإعادة التفاعل، وما إلى ذلك).

<Note>
  يبقى **Carousel** معطّلًا حتى تربط رقم WhatsApp. تحتاج كل بطاقة إلى صورة أو فيديو خاص بها، ويحمّل Flowella هذه الوسائط إلى Meta عبر رقمك المتصل. مرّر المؤشر فوق الخيار المعطّل لرؤية تلميح يشرح ذلك.
</Note>

<Tip>
  يمكنك الانتقال المباشر إلى خيار محدد باستخدام معلمة الاستعلام `entry`: `?entry=meta`، أو `?entry=flowella`، أو `?entry=scratch` (رسالة قياسية)، أو `?entry=carousel`. تستخدم خطوة **Create your first template** في دليل الإعداد التوجيهي `?entry=meta` للوصول مباشرة إلى Meta Library.
</Tip>

يعرض كلا المعرضين **بطاقات معاينة WhatsApp مشتركة** بحيث يتطابق ما تراه أثناء التصفح مع طريقة عرض القوالب في كتالوج القوالب — نفس معاينة الرأس والمتن والأزرار.

#### معرض Meta Library

يتيح لك معرض Meta Library البحث في كتالوج قوالب الأدوات الخاص بـ Meta وإضافة القوالب دون إعادة كتابتها.

* **Search** — اكتب للتصفية حسب الاسم؛ النتائج ذات تأخير مضاد للاهتزاز ومُخزَّنة مؤقتًا لحوالي ساعة لكل WABA.
* **Language filter** — بشكل افتراضي، تتم تصفية المعرض إلى لغة WhatsApp المشتقة من **content locale** لمؤسستك (المعيَّنة ضمن **Settings → Organization**). بدّل إلى **All languages** لتصفّح كل لغات Meta.
* **Open one as draft** — انقر على **Open as draft** في بطاقة لإنشاء نسخة من هذا القالب كمسودة محلية والانتقال مباشرة إلى المحرر. لا يُقدَّم أي شيء إلى Meta حتى تنقر على **Publish**.
* **Multi-select add** — حدّد مربع الاختيار على عدة بطاقات، ثم انقر على **Create drafts (**{count}**)** لإنشاء نسخ من كل القوالب المحددة دفعة واحدة. عند النجاح، يعيدك Flowella إلى قائمة القوالب.

<Note>
  تُفتح تحديدات المكتبة دائمًا كـ **مسودات محلية** في WABA الخاص بك. يمكنك إعادة التسمية أو تعديل المتغيرات أو إضافة الأزرار أو تغيير الفئات قبل النشر — فإدخال Meta Library مجرد نقطة بداية.
</Note>

#### معرض Flowella Templates

يسرد معرض Flowella Templates قوالب البداية المُنسَّقة التي تصونها Flowella (تدفقات حالة الطلب، والعروض الترويجية بالقسائم، وتذكيرات المواعيد، وما إلى ذلك). اختر قالب بداية لتعبئة المحرر بمسودة جاهزة للتخصيص، ثم انشرها إلى Meta عندما تكون راضيًا عنها. خلف الكواليس، يُدخِلك المعرض إلى المحرر عبر `?starter=<slug>`.

### تعبئة المحرر

<Steps>
  <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، والتدفقات الآلية، وصندوق الوارد، والإرسال المجمّع.

### إنشاء قالب عرض دوار

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

**المتطلبات المسبقة:** رقم WhatsApp متصل، وملف صورة أو فيديو لكل بطاقة.

<Steps>
  <Step title="افتح محرر العرض الدوار">
    انقر على **New Template**، ثم انقر على **Carousel** في بطاقة **Build your own**. يُفتح المحرر مع شارة **Carousel · {count} cards** بجوار اسم القالب.
  </Step>

  <Step title="اكتب متن الرسالة">
    أدخل نص المتن الذي يظهر في فقاعة الرسالة فوق البطاقات. الفئة مقفلة على **Marketing**. لا تحتوي العروض الدوارة على رأس أو تذييل أو أزرار على مستوى الرسالة. بدلاً من ذلك، توجد الأزرار على كل بطاقة.
  </Step>

  <Step title="اضبط بنية البطاقات">
    ضمن **Card structure**، اختر **Media type** لجميع البطاقات: **Image** أو **Video**. تستخدم كل البطاقات نفس نوع الوسائط. فعّل **Card body** إذا كنت تريد نصًا على كل بطاقة. عند تفعيله، تحتاج كل بطاقة إلى نص متن، حتى **160 حرفًا** لكل بطاقة.
  </Step>

  <Step title="أضف أزرار البطاقات">
    ضمن **Card buttons**، أضف ما يصل إلى **زرين**. كل زر إما **Quick reply** أو **Link** أو **Phone number**. تحصل كل بطاقة على نفس أنواع الأزرار بنفس الترتيب. تضبط تسمية كل زر أو رابطه أو رقم هاتفه على البطاقة نفسها، لذا يمكن لكل بطاقة أن تشير إلى وجهة مختلفة.
  </Step>

  <Step title="املأ كل بطاقة">
    يبدأ العرض الدوار الجديد ببطاقتين. انقر على **Add card** لإضافة المزيد، حتى **10 بطاقات**. على كل بطاقة، حمّل الصورة أو الفيديو، واكتب نص البطاقة، واضبط تسميات الأزرار وقيمها.
  </Step>

  <Step title="تحقق من المعاينة وانشر">
    تعرض المعاينة البطاقات كشريط أفقي، بالطريقة التي يعرضها بها WhatsApp. انقر على **Publish** لإرسال العرض الدوار إلى Meta.
  </Step>
</Steps>

#### إدارة البطاقات

* **إعادة الترتيب** — اسحب بطاقة من مقبضها. لاستخدام لوحة المفاتيح، ركّز على مقبض السحب واضغط على مفتاح السهم لأعلى أو لأسفل. يمكنك أيضًا استخدام **Move up** و**Move down**.
* **التكرار** — انقر على **Duplicate** لنسخ بطاقة. ينسخ Flowella النص والأزرار وعينات المتغيرات، لكنه يمسح الوسائط. حمّل صورة أو فيديو جديدًا على النسخة.
* **الحذف** — انقر على **Delete** لإزالة بطاقة. يحتاج العرض الدوار إلى بطاقتين على الأقل.

إذا غيّرت عدد البطاقات في قالب سبق أن أرسلته، يحذّرك Flowella من أن القالب سيعود إلى WhatsApp للمراجعة. انقر على **Change card count** للمتابعة أو **Cancel** للاحتفاظ بالبطاقات الحالية.

#### وسائط البطاقات

| نوع الوسائط | التنسيقات | الحد الأقصى للحجم |
| - | - | - |
| صورة | JPEG أو PNG | 5 MB |
| فيديو | MP4 | 16 MB |

يتحقق Flowella من كل ملف قبل تحميله. إذا كان الملف من النوع الخاطئ أو كبيرًا جدًا، تعرض البطاقة الخطأ على الفور، على سبيل المثال **This image is over 5 MB. JPEG and PNG card images must be 5 MB or smaller.** إذا فشل التحميل، انقر على **Retry** على تلك البطاقة.

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

#### القواعد التي يتحقق منها Flowella قبل الإرسال

يتحقق Flowella من العرض الدوار وفق قواعد WhatsApp ويبرز البطاقة التي تحتاج إلى إصلاح. على سبيل المثال، إذا لم تكن لبطاقة وسائط، يبرز Flowella تلك البطاقة ويعرض **Card 3: has no image. Every card needs its own uploaded image before you can submit.**

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

<Note>
  تختار بين رسالة قياسية وعرض دوار عند إنشاء القالب. لا يمكنك تحويل عرض دوار إلى قالب قياسي، أو قالب قياسي إلى عرض دوار. للتبديل، أنشئ قالبًا جديدًا.
</Note>

للاطلاع على القائمة الكاملة لقواعد العرض الدوار في WhatsApp، راجع [قوالب العرض الدوار](/ar/app/template-reference#carousel-templates).

## شارات صحة التسليم في قائمة القوالب

يمكن أن يعرض كل صف في قائمة القوالب **شارة صحة تسليم** بالإضافة إلى شارة الحالة المعتادة. تُشير هذه الشارة إلى القوالب التي توقّف WhatsApp عن تسليمها، بحيث يمكنك اكتشافها دون فتح كل محرر على حدة.

| الشارة | متى تظهر | ما الذي تعنيه |
| - | - | - |
| **Paused by WhatsApp** | حالة Meta هي `PAUSED`. | أوقف WhatsApp هذا القالب مؤقتًا. عمليات الإرسال من الرحلات والحملات وإجراءات سير عمل HubSpot التي تستخدمه لن تُرسَل حتى تُعيد Meta تشغيله. |
| **Disabled by WhatsApp** | حالة Meta هي `DISABLED`. | عطّل WhatsApp هذا القالب. حدّثه أو استبدله قبل الإرسال مرة أخرى. |
| **Quality: Red** | درجة الجودة من Meta هي `RED` والقالب ليس موقوفًا أو معطّلًا بالفعل. | صنّف WhatsApp هذا القالب باللون الأحمر. راجع عمليات الإرسال الأخيرة وملاحظات العملاء في Meta Business Manager. |

تحلّ شارتا الإيقاف والتعطيل محلّ شارة الحالة العادية؛ بينما تظهر شارة Quality: Red إلى جانبها. عندما ترفع Meta الإيقاف أو تعيد تشغيل القالب أو تعيد الجودة إلى Yellow/Green، تختفي الشارة تلقائيًا في المزامنة التالية.

كما تُطلق عمليات الانتقال إلى الإيقاف والتعطيل والجودة `RED` **إشعارات** (`TEMPLATE_PAUSED` و`TEMPLATE_DISABLED` و`TEMPLATE_QUALITY`) لتعرف بذلك حتى إن لم تكن على صفحة القوالب. يمكنك الاشتراك في هذه الإشعارات أو إلغاء الاشتراك منها ضمن [تفضيلات الإشعارات](/settings/notification-preferences)؛ والقائمة الكاملة للأحداث موجودة في [أحداث الإشعارات](/app/notification-events).

## سجل حالات Meta

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

استخدم هذا كسجل تدقيق عند التحقيق في شارة صحة التسليم أو عند الإجابة عن سؤال "متى تغيّر هذا القالب؟" خلال محادثة دعم.

<Note>
  يظهر سجل الحالات فقط للقوالب المدعومة من Meta (وليس للمسودات المحلية)، وهو متداخل داخل علامة التبويب الإحصائيات. كانت الإصدارات السابقة تعرضه أسفل شريط إجراءات المحرر — أما الآن فقد أصبح مع بقية تحليلات التسليم لديك.
</Note>

## قوالب إعادة الفتح المُدارة من النظام

تُشغّل قوالب `flowella_reopen_*` من Flowella (خدمة، تحديث، عرض) [علامة تبويب الرد](/app/inbox#reply-tab-smart-reply) في صندوق الوارد ودعوة الإجراء [إعادة التفاعل](/app/inbox#one-tap-re-engage-on-a-closed-window) بنقرة واحدة. أصبحت هذه القوالب المُدارة من النظام في كتالوج القوالب تحمل الآن شارة **نظام** في كل من عرض البطاقة وعرض القائمة حتى تتمكن من تمييزها بلمحة واحدة.

لا يزال بإمكانك تعديل النص الإطاري ضمن [الإعدادات ← قوالب الرد](/settings/reply-templates)، لكن قوالب إعادة الفتح النظامية **لا يمكن حذفها** — يُزال إجراء الحذف من صف الكتالوج ويُعطَّل زر الحذف داخل محرر القالب مع تلميح يشرح السبب. لإيقاف استخدام نوع ما، فعّل مفتاح تبديله في قوالب الرد بدلاً من ذلك.

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

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

* **الحفظ التلقائي** — كل تغيير في الاسم أو اللغة أو الفئة أو القناة أو المكونات يُحفظ بعد توقف قدره ثانية تقريبًا. يعرض شريط إجراءات سفلي ثابت حالة الحفظ الحالية (**جارٍ الحفظ…**، **محفوظ**، أو **تغييرات غير محفوظة**).
* **النشر مقيد بالحفظ** — يظل زر **نشر** معطلاً حتى يكتمل آخر حفظ تلقائي، حتى لا ترسل مسودة غير مكتملة الحفظ إلى 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>

### إرسال قوالب العرض الدوار

يمكنك إرسال عرض دوار معتمد من إرسال اختباري، أو إرسال مجمّع، أو [صندوق الوارد](/ar/app/inbox)، أو [Flowella API](/ar/api-reference/introduction)، أو HubSpot.

* **وسائط البطاقات** — إذا لم تقدّم وسائط لبطاقة، يرسل Flowella صورة أو فيديو العينة المعتمد لتلك البطاقة. تستخدم الإرسالات الاختبارية والمجمّعة وإرسالات صندوق الوارد وHubSpot دائمًا وسائط العينة المعتمدة.
* **قيم لكل بطاقة** — عبر API، مرّر إدخال `carouselCards` واحدًا لكل بطاقة، بترتيب البطاقات. يمكن لكل إدخال ضبط وسائط البطاقة (`mediaUrl` أو `mediaId`)، ومتغيرات متن البطاقة (`bodyParameters`)، وقيم الأزرار (`buttonParameters`).
* **نفس البطاقات لكل مستلم** — يستخدم الإرسال المجمّع نفس وسائط البطاقات وقيمها لكل مستلم. لا يزال بإمكان متغيرات متن الرسالة أن تختلف لكل مستلم.

```bash theme={null}
curl -X POST "https://api.flowella.io/v1/templates/send" \
  -H "Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "clxxxxxxxxxxxxxxxxxxxxxxxx",
    "whatsappChannelId": "clxxxxxxxxxxxxxxxxxxxxxxxx",
    "recipients": [{ "phone": "+15551234567", "bodyParameters": ["Ada"] }],
    "carouselCards": [
      {
        "mediaUrl": "https://cdn.example.com/card-1.jpg",
        "buttonParameters": [{ "index": 1, "text": "summer" }]
      },
      { "mediaUrl": "https://cdn.example.com/card-2.jpg" }
    ]
  }'
```

في هذا المثال، تستخدم البطاقة 1 صورة مخصصة وتملأ المتغير في نهاية رابط زرها الثاني بـ `summer`. تستخدم البطاقة 2 صورة مخصصة. يبدأ `index` الزر من الصفر.

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

تتيح لك علامة تبويب **الإرسال** أيضًا إرسال قالب **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>


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