حالة فيديو
انشر حالة فيديو (قصة) على واتساب.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
استخدم الفيديو العمودي (نسبة العرض إلى الارتفاع 9:16) للحصول على أفضل مشاهدة.
قم بقص مقاطع الفيديو إلى أكثر 30 ثانية جاذبية.
الحركة والعاطفة: حالة الفيديو
تسمح لك نقطة النهاية /v2/status/video بنشر مقاطع قصيرة وجذابة. الفيديو هو التنسيق الأكثر تفاعلاً على واتساب، وغالباً ما يحقق ثلاثة أضعاف معدل الاحتفاظ مقارنة بالصور الثابتة.
⏱️ حد الـ 30 ثانية الصارم
هذا هو القيد الأكثر حرجاً في بروتوكول حالة واتساب.
- المدة القصوى: 30 ثانية.
- السلوك: إذا رفعت فيديو مدته 60 ثانية، فسيقوم واتساب إما بفشل الرفع أو قصه بشكل حاد.
- أفضل ممارسة: قم دائماً بقص مقاطعك مسبقاً إلى 29.5 ثانية باستخدام
ffmpegقبل إرسالها.
كيف تنشر فيديوهات أطول؟
يجب استخدام استراتيجية "التقطيع" (Slicing). إذا كان لديك مقطع مدته دقيقتان، قم بقطعه إلى أربعة أجزاء مدة كل منها 30 ثانية، وارفعها بالتتابع. سيقوم واتساب بتشغيلها تباعاً لتوفير تجربة تشغيل سلسة.
🎞️ المواصفات التقنية
لضمان التشغيل الفوري وتجنب "عجلة التخمين" (Buffering):
- الحاوية: MP4 (حصرياً).
- ترميز الفيديو: H.264 (AVC). لا تستخدم H.265 (HEVC).
- ترميز الصوت: AAC.
- الدقة: 720x1280 (720p عمودي) هي النقطة المثالية.
- معدل البت (Bitrate): حافظ عليه أقل من 2.5 ميجابت في الثانية؛ أي معدل أعلى سيقوم واتساب بضغطه وتدميره.
🔄 علامة convert
تتضمن نقطة النهاية هذه أداة قوية: convert: true.
- الوظيفة: إذا أرسلت ملف MOV أو AVI أو MKV، ستحاول الواجهة تحويله إلى MP4 متوافق مع واتساب أثناء المعالجة.
- تحذير: التحويل يستهلك وقتاً من المعالج، مما سيزيد وقت استجابة الواجهة بمقدار 5-10 ثوانٍ.
🎬 استراتيجيات إبداعية
1. "سينيماغراف" (Cinemagraph)
بدلاً من فيديو كامل، انشر حلقة مكررة حيث يتحرك عنصر واحد فقط (مثل بخار يتصاعد من فنجان قهوة). يتميز هذا بجاذبية صورية عالية وحجم ملف صغير جداً.
2. نمط "ملاحظة الفيديو" (asNote)
هناك وضع سري يدعى asNote: true.
- التأثير: ينسق الفيديو كملاحظة فيديو دائرية فورية. يشعر هذا النمط بأنه أقل "إنتاجية" وأكثر "واقعية".
3. الترجمة ضرورية
80% من المستخدمين يشاهدون حالات واتساب في وضع الصمت.
- قاعدة: إذا كان الفيديو يعتمد على التعليق الصوتي، يجب عليك حرق الترجمة (Subtitles) داخل الفيديو. إذا لم تفعل، سيتخطى 80% من جمهورك الفيديو فوراً.
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
محتوى الطلب
يرسل كـ JSONstring | WhatsApp Instance ID مثال: | ||
string | API Access Token مثال: | ||
string | رابط ملف الفيديو مثال: | ||
string | اسم الملف مثال: | ||
string | نوع MIME مثال: | ||
boolean | تمكين التحويل التلقائي مثال: | ||
boolean | إرسال كملاحظة فيديو دائرية مثال: | ||
string | تعليق نصي للفيديو مثال: |
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"success": true,
"message": "Operation completed successfully"
}Command Palette
Search for a command to run...