حظر جهة اتصال
حظر جهة اتصال من التواصل معك.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
احظر المستخدمين الذين ينتهكون شروط الخدمة الخاصة بك فورًا.
سجل سبب الحظر لعمليات تدقيق الامتثال.
الخيار النووي: حظر جهات الاتصال
تسمح لك نقطة النهاية /v2/contacts/block بقطع التواصل مع مستخدم محدد على واتساب.
🚫 ماذا يحدث عند الحظر؟
الحظر إجراء حاسم وله عواقب فورية على بروتوكول واتساب.
1. الرسائل الواردة
- السلوك: يمكن للمستخدم المحظور إرسال رسائل إليك، لكنه سيرى دائماً علامة صح واحدة (تم الإرسال).
- جانبك: لن تتلقى هذه الرسائل أبداً. يقوم السيرفر بإلغائها قبل وصولها لجهازك. حتى لو ألغيت الحظر لاحقاً، تلك الرسائل فُقدت للأبد.
2. تحديثات الحالة وصورة الملف الشخصي
- الظهور: لن يتمكن المستخدم المحظور من رؤية صورتك الشخصية، أو حالة "حول"، أو "آخر ظهور".
- القصص: لن يتمكنوا من مشاهدة تحديثات الحالة الخاصة بك.
3. المكالمات
- المكالمات من المستخدمين المحظورين ستظهر لديهم كأنها ترن، ولكن سيتم رفضها بصمت من قِبل جهازك. لن تحصل حتى على إشعار بمكالمة فائتة.
⚖️ متى تستخدم الحظر؟
الحالة أ: كلمة "STOP"
إذا كنت تدير بوت تسويقي، فأنت ملزم قانونياً باحترام طلبات إلغاء الاشتراك.
- الإجراء: استدعِ
blockContact. - لماذا: هذا أضمن من مجرد وضع علامة في قاعدة بياناتك. إذا حدث خطأ برمجي وحاول النظام مراسلتهم، فإن الحظر في واتساب سيمنع ذلك مادياً.
الحالة ب: الحماية من السبام
إذا قام مستخدم بتجاوز حدود معدل الرسائل (مثلاً إرسال 100 رسالة في دقيقة واحدة): يمكنك حظرهم تلقائياً وربما فك الحظر بعد 24 ساعة.
🔮 تفاصيل التنفيذ
عملية صامتة
الحظر عملية صامتة. لن يتلقى المستخدم إشعاراً يفيد بأنه تم حظره. سيرون فقط أنك توقفت عن استلام رسائلهم (لا توجد علامتا صح زرقاء أو رمادية).
المجموعات (Groups)
- استثناء: حظر المستخدم لا يخرجه من المجموعات المشتركة بينكما.
- التفاعل: ستظل ترى رسائلهم في تلك المجموعات، وسيظلون يرون رسائلك هناك. الحظر ينطبق فقط على الرسائل المباشرة (1:1).
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
معاملات الاستعلام والطلب (Query & Body Parameters)
تدعم التمرير عبر الرابط (Query String) أو كـ JSON Bodystring | معرف الجلسة الفريد (Instance ID) الخاص برقمك مثال: | ||
string | مفتاح الوصول السري للـ API (Access Token) مثال: | ||
string | المعرف الفريد لجهة الاتصال المراد حظرها مثال: |
برمج بالذكاء الاصطناعي باستخدام Wawp MCP
MCP READYقم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"ok": true
}Command Palette
Search for a command to run...