إعدادات الوسائط والتجاهل للجلسة

جلب أو تعديل أوضاع التحميل التلقائي للوسائط الواردة (auto, on_demand, disabled) وفلاتر التجاهل (الحالات، القنوات، المجموعات، القوائم الجماعية) للجلسة.

GET
https://api.wawp.net/v2/session/media-settings?access_token=YOUR_ACCESS_TOKEN&ignore_broadcast=false&ignore_channels=true&ignore_groups=false&ignore_status=true&instance_id=123456789&max_auto_download_mb=10&receive_audio=auto&receive_documents=on_demand&receive_images=auto&receive_stickers=disabled&receive_videos=on_demand&session_name=default

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول
اختبار /v2/session/media-settings
GETPOST

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

توصيات

  • فعّل خياري 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 Body
string

معرف الجلسة الفريد المكون من 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) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/session/media-settings";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "YOUR_ACCESS_TOKEN",
6 "session_name": "default",
7 "ignore_status": "true",
8 "ignore_channels": "true",
9 "ignore_groups": "false",
10 "ignore_broadcast": "false",
11 "receive_images": "auto",
12 "receive_videos": "on_demand",
13 "receive_audio": "auto",
14 "receive_documents": "on_demand",
15 "receive_stickers": "disabled",
16 "max_auto_download_mb": "10"
17}).toString();
18
19
20fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
21 method: "GET",
22 headers: { "Content-Type": "application/json" },
23
24})
25 .then(async (response) => {
26 if (response.ok) {
27 const data = await response.json();
28 console.log("Success:", data);
29 return data;
30 }
31
32 // Error Handling
33 if (response.status === 400) {
34 console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
35 }
36 if (response.status === 401) {
37 console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
38 }
39 if (response.status === 404) {
40 console.error("Error 404: غير موجود - الجلسة غير موجودة");
41 }
42 if (response.status === 500) {
43 console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
44 }
45
46 const errorText = await response.text();
47 console.error(`Error ${response.status}: ${errorText}`);
48 })
49 .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 49, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Session media settings retrieved or updated successfully
application/json
string *
string *
object *

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
  }
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقإدارة الـ Webhook
الموضوع التالياستعلام استهلاك الباندويث

Command Palette

Search for a command to run...