> ## 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 في رؤوس القوالب، ولماذا لا تعمل روابط YouTube، وكيف ترفع الصور والفيديو والمستندات عبر Flowella.

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

هذه الصفحة هي مرجع عملي لما ينجح وما لا ينجح، وكيفية إدراج الوسائط عبر Flowella
.

## التنسيقات المدعومة والحدود

هذه هي التنسيقات وحدود الحجم التي يفرضها Meta
على الوسائط في رؤوس القوالب (وفي أي مكان آخر في رسائل WhatsApp Business Platform
).

### الصور

| التنسيق      | الامتداد | نوع MIME | الحجم الأقصى |
| ------------ | -------- | -------- | ------------ |
| JPEG         | `.jpeg`  |          |              |
| /`.jpg`      |          |          |              |
| `image/jpeg` |          |          |              |
| 5 ميغابايت   |          |          |              |
| PNG          | `.png`   |          |              |
| `image/png`  |          |          |              |
| 5 ميغابايت   |          |          |              |

يجب أن تكون الصور **8 بت، RGB أو RGBA**. **لا** يُقبل تنسيق WebP في رؤوس القوالب (وهو صالح فقط في رسائل الملصقات، وهي نوع منفصل من الرسائل).

**الأبعاد الموصى بها:** نسبة العرض إلى الارتفاع 1.91:1، بحد أدنى 800×418 بكسل. كما يتم عرض الصور المربعة (1:1) بشكل مقبول. يتم عرض نسب العرض إلى الارتفاع الأخرى في صندوق بريد من قبل عميل WhatsApp
.

### مقاطع الفيديو

| التنسيق      | الامتداد | نوع MIME | الحجم الأقصى |
| ------------ | -------- | -------- | ------------ |
| 3GPP         | `.3gp`   |          |              |
| `video/3gpp` |          |          |              |
| 16 ميغابايت  |          |          |              |
| MP4          | `.mp4`   |          |              |
| `video/mp4`  |          |          |              |
| 16 ميغابايت  |          |          |              |

يجب أن تستخدم مقاطع الفيديو **برنامج ترميز الفيديو H.264** و**برنامج ترميز الصوت AAC**، مع **دفق صوتي واحد أو بدون صوت**.

<Warning>
  لا تدعم عملاء Android WhatsApp
  مقاطع الفيديو المشفرة باستخدام **ملف تعريف H.264 "High" وإطارات B**. قم بالترميز (أو إعادة الترميز) باستخدام ملف تعريف H.264 **"Main" بدون إطارات B**، أو **ملف تعريف "Baseline"**، وضع مربعات`moov`
  قبل مربعات`mdat`
  لتحقيق توافق أوسع.

  في حالة استخدام ffmpeg، يتولى العلامة`-movflags faststart`
  ترتيب`moov`
  /`mdat`
  .
</Warning>

### المستندات

| التنسيق                                                                      | الامتداد | نوع MIME | الحجم الأقصى |
| ---------------------------------------------------------------------------- | -------- | -------- | ------------ |
| PDF                                                                          | `.pdf`   |          |              |
| `application/pdf`                                                            |          |          |              |
| 100 ميجابايت                                                                 |          |          |              |
| Microsoft Word                                                               | `.doc`   |          |              |
| /`.docx`                                                                     |          |          |              |
| `application/msword`                                                         |          |          |              |
| /`application/vnd.openxmlformats-officedocument.wordprocessingml.document`   |          |          |              |
| 100 ميغابايت                                                                 |          |          |              |
| Microsoft Excel                                                              | `.xls`   |          |              |
| /`.xlsx`                                                                     |          |          |              |
| `application/vnd.ms-excel`                                                   |          |          |              |
| /`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`         |          |          |              |
| 100 ميغابايت                                                                 |          |          |              |
| Microsoft PowerPoint                                                         | `.ppt`   |          |              |
| /`.pptx`                                                                     |          |          |              |
| `application/vnd.ms-powerpoint`                                              |          |          |              |
| /`application/vnd.openxmlformats-officedocument.presentationml.presentation` |          |          |              |
| 100 ميغابايت                                                                 |          |          |              |
| نص عادي                                                                      | `.txt`   |          |              |
| `text/plain`                                                                 |          |          |              |
| 100 ميغابايت                                                                 |          |          |              |

ملفات PDF هي الأكثر موثوقية في العرض عبر الأجهزة. تعمل مستندات Office ولكنها تتطلب أن يكون لدى المستلم تطبيق متوافق مثبت؛ وعادةً ما يتم فتحها كمعاينات على الهواتف المحمولة غير المخصصة للأعمال.

## ما لا يعمل

<AccordionGroup>
  <Accordion title="تضمينات YouTube وVimeo">
    لا يمكنك تضمين مقطع فيديو من YouTube أو Vimeo في رأس القالب. يجب أن يكون الرأس ملف MP4 أو 3GPP يمكن لـ Meta
    استرداده واستضافته.

    إذا كنت ترغب في إرسال مقطع فيديو من YouTube، فهناك خياران:

    1. **ضع رابط YouTube في النص الأساسي أو زر URL.** يؤدي النقر عليه إلى فتح تطبيق YouTube أو المتصفح. ستكون معاينة الفيديو المعروضة في WhatsApp
       عبارة عن صورة مصغرة ثابتة.
    2. **قم بتنزيل الفيديو وأعد تحميله بتنسيق MP4.** يخضع ذلك لحقوقك في إعادة توزيع المحتوى، مما يعني عادةً أنه يجب أن يكون الفيديو ملكك.

    الخيار الأخير هو الطريقة للحصول على معاينة فيديو فعلية أثناء المحادثة.
  </Accordion>

  <Accordion title="صور GIF">
    صور GIF المتحركة (`.gif`
    ) غير مدرجة في قائمة الملفات المدعومة. يقوم WhatsApp
    بتحويلها من جانب الخادم عند مشاركتها من نظير إلى نظير في تطبيق المستهلك، ولكن منصة الأعمال لا تقوم بذلك. أعد ترميز ملف GIF كملف MP4 (الذي يقوم عملاء WhatsApp
    على الأجهزة المحمولة بتشغيله تلقائيًا وبدون صوت، بنفس الطريقة التي يعرضون بها ملف GIF).
  </Accordion>

  <Accordion title="صور WebP">
    صور WebP صالحة فقط لرسائل الملصقات، وليس لعناوين القوالب. قم بالتحويل إلى JPEG أو PNG قبل استخدامها كصورة رأس.
  </Accordion>

  <Accordion title="صور HEIC مباشرة من iPhone">
    تقوم أجهزة iPhone افتراضيًا بحفظ الصور بتنسيق HEIC، وهو تنسيق غير مدرج في قائمة التنسيقات المدعومة. قم بتغيير إعدادات iPhone لالتقاط الصور بتنسيق JPEG، أو قم بتحويل HEIC إلى JPEG قبل التحميل.
  </Accordion>

  <Accordion title="الملفات فوق الحد الأقصى للحجم">
    سيتم رفض أي صورة بحجم 6 ميغابايت، أو مقطع فيديو بحجم 18 ميغابايت، أو ملف PDF بحجم 110 ميغابايت. قم بالضغط قبل التحميل. بالنسبة للصور، يقوم عميل WhatsApp
    أيضًا بإعادة الضغط عند العرض، لذا لن تبدو الصورة بحجم 4 ميغابايت أفضل بكثير من الصورة بحجم 1 ميغابايت على شاشة الهاتف.
  </Accordion>
</AccordionGroup>

## طريقتان لإرفاق الوسائط بنموذج يدعم

Meta
نمطين لإدخال الوسائط في النموذج:

### النمط 1: معرف الوسائط (موصى به)

قم بتحميل الملف عبر واجهة برمجة تطبيقات الوسائط (Media API) الخاصة بـ Meta
، واحصل على **معرف الوسائط**، وقم بالإشارة إلى المعرف عند إرسال القالب. يستخدمه Flowella
بشكل افتراضي.

المزايا:

* يستضيف Meta
  الملف، لذلك لا تحدث أخطاء في عناوين URL المعطلة عند الإرسال.
* تسليم أسرع لأن Meta
  لا يحتاج إلى جلب الملف من رابط خارجي.
* يعمل مع حدود الحجم الكاملة المذكورة أعلاه.

يكون المعرف صالحًا لمدة 30 يومًا. إذا كان القالب الخاص بك يُرسل بشكل متكرر مع نفس الوسائط، فإن Flowella
يقوم بتحديث المعرف تلقائيًا قبل انتهاء صلاحيته.

### النمط 2: رابط HTTPS عام

قم بتوفير عنوان URL لملف يمكن الوصول إليه بشكل عام. يقوم Meta
باسترداده في وقت الإرسال.

يكون هذا مفيدًا في الحالات التالية:

* عندما تتغير الوسائط حسب المستلم (ملف PDF مخصص، ملصق شحن لكل طلب).
* عندما يتم إنشاء الوسائط على الفور ولا ترغب في التحميل لكل عملية إرسال.

الملاحظات:

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

## كيف يتعامل Flowella

مع تحميل الوسائط

في معظم حالات الاستخدام، يدير Flowella
معالج الوسائط نيابة عنك:

<Steps>
  <Step title="إضافة ملف وسائط الرأس عند إنشاء القالب">
    في **القوالب → إنشاء**، اختر **صورة** أو **فيديو** أو **مستند** كنوع الرأس، ثم اسحب الملف إلى منطقة التحميل.
  </Step>

  <Step title="Flowella يتحقق من صحة الملف">
    يتم التحقق من التنسيق والحجم ونوع MIME قبل الإرسال. إذا كان الملف غير مدعوم، فسترى خطأً على الفور بدلاً من الانتظار حتى يرفض Meta
    القالب.
  </Step>

  <Step title="يقوم فلوويلا بالتحميل إلى Meta ويخزن المقبض">
    يتم تحميل الملف عبر واجهة برمجة تطبيقات الوسائط (Media API) الخاصة بـ Meta
    . يتم حفظ المعرف المرتجع مقابل القالب.
  </Step>

  <Step title="يتضمن إرسال القالب يتضمن المقبض">
    عندما يتم إرسال القالب للموافقة عليه، يرى Meta
    الوسائط الفعلية (وليس عنوان URL)، بحيث يمكن لعملية المراجعة تقييم العناصر المرئية كجزء من عملية الموافقة.
  </Step>

  <Step title="يرسل إعادة استخدام نفس المقبض">
    حتى يتغير رأس الوسائط الخاص بالقالب، تستخدم كل عملية إرسال نفس المعرف. يتم تحديث المعرفات تلقائيًا قبل انتهاء صلاحيتها.
  </Step>
</Steps>

بالنسبة للوسائط الخاصة بكل مستلم (ملفات PDF المخصصة، ملصقات الشحن)، استخدم خيار **Public URL** في أداة إنشاء القوالب وقم بتمرير الرابط كمتغير عند تشغيل الإرسال من سير عمل أو واجهة برمجة التطبيقات. انظر [إجراءات سير العمل](/ar/hubspot/workflow-actions).

## التصميم من أجل نافذة عرض WhatsApp

بعض الملاحظات التصميمية التي لا تظهر في مواصفات Meta
ولكنها مهمة في الممارسة العملية:

* **النص على الصور.** اجعله كبيرًا وعالي التباين. يعرض WhatsApp
  الصورة بعرض شاشة الهاتف المحمول تقريبًا، لذا فإن أي شيء أصغر من حوالي 14 بكسل يصبح غير قابل للقراءة.
* **المنطقة الآمنة.** قد يقوم WhatsApp
  بقص الصورة أو عرضها في صندوق؛ لذا، احرص على وضع المحتوى المهم في الوسط الذي يشكل 80% من الصورة.
* **اتساق العلامة التجارية.** تقع صورة العنوان واسم العرض وصورة الملف الشخصي على WhatsApp
  بالقرب من بعضها البعض — لذا، احرص على اتساقها بصريًا.
* **الإطار الأول للفيديو.** يستخدم WhatsApp
  يستخدم الإطار الأول كمعاينة ثابتة قبل تشغيل الفيديو. لا تبدأ بإطار أسود أو شعار الشركة؛ ابدأ بصورة ذات معنى.
* **اسم ملف المستند.** عند إرسال ملف PDF أو مستند آخر، يكون **اسم الملف** مرئيًا للمستلم. استخدم اسمًا واضحًا ووصفياً مثل`Acme-Order-12345-Receipt.pdf`
  ، وليس`attachment.pdf`
  .

## الأخطاء الشائعة وحلولها

<AccordionGroup>
  <Accordion title="131053 - نوع MIME غير متطابق">
    لا يتطابق نوع MIME الفعلي للملف مع ما تم الإعلان عنه. يحدث هذا غالبًا عندما يكون ملف "JPEG" تم تصديره من iPhone هو في الواقع HEIC، أو عندما تقوم أداة ما بإعادة تسمية`.docx`
    إلى`.pdf`
    دون تحويل.

    الحل: افحص الملف (على macOS/Linux:`file -I yourfile.png`
    ) وقم إما بإعادة التصدير بالتنسيق الصحيح أو تغيير الامتداد ليتطابق.
  </Accordion>

  <Accordion title="تشغيل الفيديو بدون صوت">
    برنامج ترميز الصوت مختلف عن AAC، أو يوجد عدة تدفقات صوتية.

    الحل: أعد الترميز باستخدام`ffmpeg -i input.mp4 -c:v libx264 -profile:v main -c:a aac -movflags faststart output.mp4`
    .
  </Accordion>

  <Accordion title="لا يتم تشغيل الفيديو على نظام Android">
    تم الترميز باستخدام H.264 High profile و B-frames. أعد الترميز باستخدام Main أو Baseline profile.
  </Accordion>

  <Accordion title="فشل جلب عنوان URL العام">
    Meta
    لا يمكن الوصول إلى عنوان URL. الأسباب الشائعة: يتطلب عنوان URL المصادقة، أو أن الشهادة غير صالحة، أو أن الخادم بطيء في الاستجابة (انتهت مهلة الانتظار)، أو أن عنوان URL يعرض إعادة توجيه بدلاً من الملف.

    الحل: اختبر عنوان URL باستخدام`curl -I`
    للتأكد من أنه يعرض 200 مع نوع المحتوى الصحيح، وأن الشهادة صالحة. ثم أعد المحاولة.
  </Accordion>

  <Accordion title="تبدو الصورة منقطة">
    المصدر منخفض الدقة، أو تم تكبيره. لا يعيد WhatsApp
    معالجة الصورة لتحسين الوضوح؛ ما تقوم بتحميله هو ما يتم عرضه.

    الحل: قم بتحميل صورة لا يقل طول ضلعها الأطول عن 800 بكسل بنسبة عرض إلى ارتفاع 1.91:1، ولا تقم بترقية دقة مصدر صغير.
  </Accordion>
</AccordionGroup>

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

* [مرجع القوالب](/ar/app/template-reference) — هيكل القالب الكامل الذي يتم إدراج هذه الوسائط فيه

* [القوالب](/ar/app/templates) — إنشاء القوالب خطوة بخطوة في Flowella

* [إجراءات سير العمل](/ar/hubspot/workflow-actions) — تمرير عناوين URL للوسائط لكل مستلم عبر سير عمل HubSpot