إعدادات الوسائط والتجاهل للجلسة
جلب أو تعديل أوضاع التحميل التلقائي للوسائط الواردة (auto, on_demand, disabled) وفلاتر التجاهل (الحالات، القنوات، المجموعات، القوائم الجماعية) للجلسة.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
فعّل خياري ignore_status و ignore_channels في بوتات الإنتاج.
حدد max_auto_download_mb بين 5 و 25 ميجابايت لمنع الملفات الضخمة من إبطاء إشعارات الويب هوك.
التحكم في وسائط الجلسة واستهلاك البيانات
تتيح لك نقطة النهاية /v2/session/media-settings استعراض (GET) أو تحديث (POST) كيفية تعامل جلسة واتساب الخاصة بك مع ملفات الوسائط الواردة وتدفقات المحادثات الكثيفة.
⚙️ أوضاع استقبال الوسائط
يدعم كل نوع من الوسائط (receive_images, receive_videos, receive_audio, receive_documents, receive_stickers) ثلاثة أوضاع:
auto: تحميل الوسائط تلقائياً وإرفاق روابطها مع أحداث الويب هوك (حتى الحد الأقصىmax_auto_download_mb).on_demand: تسليم بيانات الرسالة فوراً دون تحميل الوسائط الثقيلة تلقائياً، مع إمكانية جلبها عند الطلب.disabled: إيقاف تحميل الوسائط تماماً لتوفير استهلاك الباندويث.
🛡️ فلاتر تجاهل التدفقات
لتقليل استهلاك المعالج والذاكرة والضوضاء في الويب هوك، يمكنك تجاهل فئات محددة من الرسائل على مستوى المحرك:
ignore_status: تجاهل تحديثات حالات واتساب (الافتراضي:true).ignore_channels: تجاهل حركة قنوات واتساب (الافتراضي:true).ignore_groups: تجاهل رسائل المجموعات (الافتراضي:false).ignore_broadcast: تجاهل القوائم الجماعية (الافتراضي:false).
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
معاملات الاستعلام والطلب (Query & Body Parameters)
تدعم التمرير عبر الرابط (Query String) أو كـ JSON Bodystring | معرف الجلسة الفريد المكون من 12 خانة. مثال: | ||
string | رمز الوصول الخاص بواجهة البرمجة (Access Token). مثال: | ||
string | — | اسم الجلسة الاختياري (كبديل لـ instance_id). مثال: | |
boolean | — | تجاهل أحداث حالات واتساب (القصص) الواردة. الافتراضي: trueمثال: | |
boolean | — | تجاهل أحداث قنوات واتساب الواردة. الافتراضي: trueمثال: | |
boolean | — | تجاهل رسائل وأحداث المجموعات الواردة. الافتراضي: falseمثال: | |
boolean | — | تجاهل رسائل القوائم الجماعية (Broadcast) الواردة. الافتراضي: falseمثال: | |
string | — | وضع تحميل الصور الواردة: 'auto' أو 'on_demand' أو 'disabled'. الافتراضي: autoمثال: | |
string | — | وضع تحميل الفيديوهات الواردة: 'auto' أو 'on_demand' أو 'disabled'. الافتراضي: on_demandمثال: | |
string | — | وضع تحميل المقاطع الصوتية الواردة: 'auto' أو 'on_demand' أو 'disabled'. الافتراضي: autoمثال: | |
string | — | وضع تحميل المستندات الواردة: 'auto' أو 'on_demand' أو 'disabled'. الافتراضي: on_demandمثال: | |
string | — | وضع تحميل الملصقات الواردة: 'auto' أو 'on_demand' أو 'disabled'. الافتراضي: disabledمثال: | |
number | — | الحد الأقصى لحجم الملف بالميجابايت للتحميل التلقائي (من 1 إلى 100). الافتراضي: 10مثال: |
برمج بالذكاء الاصطناعي باستخدام Wawp MCP
MCP READYقم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"status": "success",
"instance_id": "123456789",
"settings": {
"ignore_status": true,
"ignore_channels": true,
"ignore_groups": false,
"ignore_broadcast": false,
"receive_images": "auto",
"receive_videos": "on_demand",
"receive_audio": "auto",
"receive_documents": "on_demand",
"receive_stickers": "disabled",
"max_auto_download_mb": 10,
"admin_locked_fields": {
},
"admin_note": null
}
}Command Palette
Search for a command to run...