نظرة عامة
ارفع صوراً أو فيديو أو مستندات لترويسات قوالب WhatsApp لكل مستلم. POST multipart/form-data بحقل file. يُرجع media_id لاستخدامه كـ header_media_id عند الإرسال. يحذف DELETE /api/v2/whatsapp/media/{id} الأصول غير المستخدمة.
POST /api/v2/whatsapp/media
أرسل multipart/form-data بحقل file ثنائي. لا تضبط Content-Type يدوياً في fetch — FormData يضبط الحدود.
curl --request POST \
'https://app.buzzbip.com/api/v2/whatsapp/media' \
--header 'Authorization: Bearer YOUR_JWT' \
--form 'file=@/path/to/invoice-april.pdf'ملاحظات الاستخدام
⚠️ ملاحظة: قيم media_id مرتبطة بالمستخدم. لا يمكن للمستخدم B الإشارة إلى ملف رفعه المستخدم A. ارفع دائماً بنفس حساب المستخدم الذي سيرسل الرسالة. 💡 نصيحة: استخدم التدفق بخطوتين — ارفع أولاً للحصول على media_id، ثم أشر إلى header_media_id عند إرسال القالب.
ملاحظة: قيم media_id مرتبطة بالمستخدم. لا يمكن للمستخدم B الإشارة إلى ملف رفعه المستخدم A. ارفع دائماً بنفس حساب المستخدم الذي سيرسل الرسالة.
ملاحظات التكامل
عند دمج نقطة نهاية Buzzbip هذه، استخدم https://app.buzzbip.com كمضيف إنتاج. احصل على JWT من POST /api/login_check وأرسل Authorization: Bearer في كل طلب. تأكد من تفعيل User.hasApiAccess في إدارة Buzzbip. حلّل استجابات JSend. مسارات WhatsApp v2 لا تستخدم شرطة مائلة نهائية. نفّذ إعادة المحاولة مع backoff عند حدود المعدل. خزّن بيانات الاعتماد على الخادم وأعد المصادقة قبل انتهاء JWT (3600 ثانية).
الأمان
أفضل الممارسات: بيانات الاعتماد على الخادم فقط، TLS إلزامي، مراقبة فشل المصادقة. افصل حسابات التجربة والإنتاج. وثّق القوالب والأتمتة. احذف الأرقام والمحتوى من السجلات المشتركة.
ما التالي؟
صفحات ذات صلة: api/v2/whatsapp-templates/send-template api/v2/whatsapp-templates guides/whatsapp-v2-use-cases