إرسال الوسائط: الصور والفيديو والصوت والمستندات
تُرسل الوسائط إما برفع الملف أولًا والإشارة إلى المعرّف الذي يعيده، أو بمنح Meta رابطًا عامًا لجلبه. الرفع أكثر موثوقية، وتختلف حدود الحجم حسب النوع بطرق قد تفاجئك.
الحد الأقصى لحجم الصور في Cloud API.
الحد الأقصى للفيديو والصوت.
الحد الأقصى للمستندات.
الحدود حسب النوع
يختلف الحد لكل نوع، وتجاوزه يعيد الخطأ 131053 بدلًا من رسالة واضحة.
- الصور: 5 MB. JPEG وPNG.
- الفيديو: 16 MB. MP4 و3GPP، مع فيديو H.264 وصوت AAC.
- الصوت: 16 MB. AAC وAMR وMP3 وصوت MP4 وOGG مع Opus.
- المستندات: 100 MB. معظم أنواع المستندات الشائعة، بما فيها PDF وOffice.
- الملصقات: 100 KB المتحركة و500 KB الثابتة، وWebP فقط.
الرفع مقارنة بالربط
طريقتان لإرسال الملف نفسه، لكنهما تفشلان بطرق مختلفة.
يرفع الرفع الملف إلى Meta أولًا ويعيد معرّف وسائط تشير إليه عند الإرسال. أما الربط فيمنح Meta عنوان URL لجلبه وقت الإرسال. يبدو مسار الربط أبسط، لكنه يضيف سببًا للفشل لا يمكنك رؤيته: قد يتعذر الوصول إلى عنوان URL من بنية Meta التحتية بسبب الموقع الجغرافي أو قاعدة جدار ناري أو ملف تعريف ارتباط لجلسة يحتفظ به متصفحك.
استخدم الرفع. إنه طلب إضافي واحد، ويزيل فئة كاملة من أسباب الفشل.
استلام الوسائط
تصل الوسائط الواردة على شكل معرّف وسائط بدلًا من البيانات نفسها. يجلب معالجك الملف منفصلًا باستخدام ذلك المعرّف.
- اجلبها سريعًا. لا تظل المعرّفات صالحة إلى أجل غير محدد.
- يعيد الجلب الفاشل الخطأ 131052، ما يعني عادةً أن رفع المرسل لم يكتمل.
- خزّن الملف لديك إذا احتجت إليه لاحقًا. Meta ليس أرشيفًا.
- سجّل الرسالة حتى عند فشل جلب الوسائط، كي يبقى النص والسياق محفوظين.
ما الذي يغيّره Coexistence
تعمل الوسائط على رقم Coexistence تمامًا كما تعمل على أي رقم آخر في Cloud API، وبالحدود نفسها.
الفرق الوحيد الجدير بالمعرفة هو السجل. عند اتصال الرقم أول مرة، تزامن Meta الرسائل الحديثة من تطبيق WhatsApp Business، وتشمل المزامنة نص الرسائل، لا أرشيفًا كاملًا للوسائط. أما الوسائط السابقة للاتصال فتبقى على الهاتف، كما كانت دائمًا.
الأخطاء الشائعة
- إرسال رابط لأنه يبدو أبسط. شبكة Meta ليست متصفحك.
- جلب الوسائط الواردة بعد ساعات. تنتهي صلاحية معرّفات الوسائط.
- تصدير الفيديو من دون التحقق من برنامج الترميز. غالبًا لا تكون الإعدادات الافتراضية لبرامج التحرير مدعومة.
توصّل EasyCoexistence أحداث الرسائل الواردة مباشرةً من Meta إلى نقطة النهاية (endpoint) لديك، فتصل معرّفات الوسائط إلى نظامك فورًا ويمكن جلبها ما دامت صالحة.
الأسئلة الشائعة
ما أكبر ملف يمكنني إرساله؟
100 MB، وذلك للمستندات فقط. يبلغ الحد الأقصى للفيديو والصوت 16 MB وللصور 5 MB.
هل أرفع الملف أم أرسل عنوان URL؟
ارفعه. فهذا يزيل إمكانية الوصول كسبب للفشل.
ما مدة صلاحية معرّف الوسائط؟
ليست دائمة، لذلك ينبغي جلب الوسائط الواردة فور وصول الحدث.
هل تتزامن الوسائط القديمة عند الاتصال؟
لا. تغطي مزامنة السجل محتوى الرسائل الحديثة، بينما تبقى الوسائط السابقة للاتصال على الهاتف.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في