الانتقال إلى المحتوى الرئيسي
يمكن أن يحتوي قالب “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، مع دفق صوتي واحد أو بدون صوت.
لا تدعم عملاء Android WhatsApp مقاطع الفيديو المشفرة باستخدام ملف تعريف H.264 “High” وإطارات B. قم بالترميز (أو إعادة الترميز) باستخدام ملف تعريف H.264 “Main” بدون إطارات B، أو ملف تعريف “Baseline”، وضع مربعاتmoov قبل مربعاتmdat لتحقيق توافق أوسع.في حالة استخدام ffmpeg، يتولى العلامة-movflags faststart ترتيبmoov /mdat .

​
المستندات

التنسيقالامتدادنوع 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 ولكنها تتطلب أن يكون لدى المستلم تطبيق متوافق مثبت؛ وعادةً ما يتم فتحها كمعاينات على الهواتف المحمولة غير المخصصة للأعمال.

​
ما لا يعمل

لا يمكنك تضمين مقطع فيديو من YouTube أو Vimeo في رأس القالب. يجب أن يكون الرأس ملف MP4 أو 3GPP يمكن لـ Meta استرداده واستضافته.إذا كنت ترغب في إرسال مقطع فيديو من YouTube، فهناك خياران:
  1. ضع رابط YouTube في النص الأساسي أو زر URL. يؤدي النقر عليه إلى فتح تطبيق YouTube أو المتصفح. ستكون معاينة الفيديو المعروضة في WhatsApp عبارة عن صورة مصغرة ثابتة.
  2. قم بتنزيل الفيديو وأعد تحميله بتنسيق MP4. يخضع ذلك لحقوقك في إعادة توزيع المحتوى، مما يعني عادةً أنه يجب أن يكون الفيديو ملكك.
الخيار الأخير هو الطريقة للحصول على معاينة فيديو فعلية أثناء المحادثة.
صور GIF المتحركة (.gif ) غير مدرجة في قائمة الملفات المدعومة. يقوم WhatsApp بتحويلها من جانب الخادم عند مشاركتها من نظير إلى نظير في تطبيق المستهلك، ولكن منصة الأعمال لا تقوم بذلك. أعد ترميز ملف GIF كملف MP4 (الذي يقوم عملاء WhatsApp على الأجهزة المحمولة بتشغيله تلقائيًا وبدون صوت، بنفس الطريقة التي يعرضون بها ملف GIF).
صور WebP صالحة فقط لرسائل الملصقات، وليس لعناوين القوالب. قم بالتحويل إلى JPEG أو PNG قبل استخدامها كصورة رأس.
تقوم أجهزة iPhone افتراضيًا بحفظ الصور بتنسيق HEIC، وهو تنسيق غير مدرج في قائمة التنسيقات المدعومة. قم بتغيير إعدادات iPhone لالتقاط الصور بتنسيق JPEG، أو قم بتحويل HEIC إلى JPEG قبل التحميل.
سيتم رفض أي صورة بحجم 6 ميغابايت، أو مقطع فيديو بحجم 18 ميغابايت، أو ملف PDF بحجم 110 ميغابايت. قم بالضغط قبل التحميل. بالنسبة للصور، يقوم عميل WhatsApp أيضًا بإعادة الضغط عند العرض، لذا لن تبدو الصورة بحجم 4 ميغابايت أفضل بكثير من الصورة بحجم 1 ميغابايت على شاشة الهاتف.

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

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

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

قم بتحميل الملف عبر واجهة برمجة تطبيقات الوسائط (Media API) الخاصة بـ Meta ، واحصل على معرف الوسائط، وقم بالإشارة إلى المعرف عند إرسال القالب. يستخدمه Flowella بشكل افتراضي. المزايا:
  • يستضيف Meta الملف، لذلك لا تحدث أخطاء في عناوين URL المعطلة عند الإرسال.
  • تسليم أسرع لأن Meta لا يحتاج إلى جلب الملف من رابط خارجي.
  • يعمل مع حدود الحجم الكاملة المذكورة أعلاه.
يكون المعرف صالحًا لمدة 30 يومًا. إذا كان القالب الخاص بك يُرسل بشكل متكرر مع نفس الوسائط، فإن Flowella يقوم بتحديث المعرف تلقائيًا قبل انتهاء صلاحيته.

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

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

​
كيف يتعامل Flowella

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

إضافة ملف وسائط الرأس عند إنشاء القالب

في القوالب → إنشاء، اختر صورة أو فيديو أو مستند كنوع الرأس، ثم اسحب الملف إلى منطقة التحميل.
2

Flowella يتحقق من صحة الملف

يتم التحقق من التنسيق والحجم ونوع MIME قبل الإرسال. إذا كان الملف غير مدعوم، فسترى خطأً على الفور بدلاً من الانتظار حتى يرفض Meta القالب.
3

يقوم فلوويلا بالتحميل إلى Meta ويخزن المقبض

يتم تحميل الملف عبر واجهة برمجة تطبيقات الوسائط (Media API) الخاصة بـ Meta . يتم حفظ المعرف المرتجع مقابل القالب.
4

يتضمن إرسال القالب يتضمن المقبض

عندما يتم إرسال القالب للموافقة عليه، يرى Meta الوسائط الفعلية (وليس عنوان URL)، بحيث يمكن لعملية المراجعة تقييم العناصر المرئية كجزء من عملية الموافقة.
5

يرسل إعادة استخدام نفس المقبض

حتى يتغير رأس الوسائط الخاص بالقالب، تستخدم كل عملية إرسال نفس المعرف. يتم تحديث المعرفات تلقائيًا قبل انتهاء صلاحيتها.
بالنسبة للوسائط الخاصة بكل مستلم (ملفات PDF المخصصة، ملصقات الشحن)، استخدم خيار Public URL في أداة إنشاء القوالب وقم بتمرير الرابط كمتغير عند تشغيل الإرسال من سير عمل أو واجهة برمجة التطبيقات. انظر إجراءات سير العمل.

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

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

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

لا يتطابق نوع MIME الفعلي للملف مع ما تم الإعلان عنه. يحدث هذا غالبًا عندما يكون ملف “JPEG” تم تصديره من iPhone هو في الواقع HEIC، أو عندما تقوم أداة ما بإعادة تسمية.docx إلى.pdf دون تحويل.الحل: افحص الملف (على macOS/Linux:file -I yourfile.png ) وقم إما بإعادة التصدير بالتنسيق الصحيح أو تغيير الامتداد ليتطابق.
برنامج ترميز الصوت مختلف عن AAC، أو يوجد عدة تدفقات صوتية.الحل: أعد الترميز باستخدامffmpeg -i input.mp4 -c:v libx264 -profile:v main -c:a aac -movflags faststart output.mp4 .
تم الترميز باستخدام H.264 High profile و B-frames. أعد الترميز باستخدام Main أو Baseline profile.
Meta لا يمكن الوصول إلى عنوان URL. الأسباب الشائعة: يتطلب عنوان URL المصادقة، أو أن الشهادة غير صالحة، أو أن الخادم بطيء في الاستجابة (انتهت مهلة الانتظار)، أو أن عنوان URL يعرض إعادة توجيه بدلاً من الملف.الحل: اختبر عنوان URL باستخدامcurl -I للتأكد من أنه يعرض 200 مع نوع المحتوى الصحيح، وأن الشهادة صالحة. ثم أعد المحاولة.
المصدر منخفض الدقة، أو تم تكبيره. لا يعيد WhatsApp معالجة الصورة لتحسين الوضوح؛ ما تقوم بتحميله هو ما يتم عرضه.الحل: قم بتحميل صورة لا يقل طول ضلعها الأطول عن 800 بكسل بنسبة عرض إلى ارتفاع 1.91:1، ولا تقم بترقية دقة مصدر صغير.

​
أدلة ذات صلة