حظر جهة اتصال

حظر جهة اتصال من التواصل معك.

POST
https://api.wawp.net/v2/contacts/block?access_token=123456789&contactId=123456789%40c.us&instance_id=123456789

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

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

تسجيل الدخول
اختبار /v2/contacts/block
POST
POST

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

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

توصيات

  • احظر المستخدمين الذين ينتهكون شروط الخدمة الخاصة بك فورًا.

  • سجل سبب الحظر لعمليات تدقيق الامتثال.

الخيار النووي: حظر جهات الاتصال

تسمح لك نقطة النهاية /v2/contacts/block بقطع التواصل مع مستخدم محدد على واتساب.


🚫 ماذا يحدث عند الحظر؟

الحظر إجراء حاسم وله عواقب فورية على بروتوكول واتساب.

1. الرسائل الواردة

  • السلوك: يمكن للمستخدم المحظور إرسال رسائل إليك، لكنه سيرى دائماً علامة صح واحدة (تم الإرسال).
  • جانبك: لن تتلقى هذه الرسائل أبداً. يقوم السيرفر بإلغائها قبل وصولها لجهازك. حتى لو ألغيت الحظر لاحقاً، تلك الرسائل فُقدت للأبد.

2. تحديثات الحالة وصورة الملف الشخصي

  • الظهور: لن يتمكن المستخدم المحظور من رؤية صورتك الشخصية، أو حالة "حول"، أو "آخر ظهور".
  • القصص: لن يتمكنوا من مشاهدة تحديثات الحالة الخاصة بك.

3. المكالمات

  • المكالمات من المستخدمين المحظورين ستظهر لديهم كأنها ترن، ولكن سيتم رفضها بصمت من قِبل جهازك. لن تحصل حتى على إشعار بمكالمة فائتة.

⚖️ متى تستخدم الحظر؟

الحالة أ: كلمة "STOP"

إذا كنت تدير بوت تسويقي، فأنت ملزم قانونياً باحترام طلبات إلغاء الاشتراك.

  • الإجراء: استدعِ blockContact.
  • لماذا: هذا أضمن من مجرد وضع علامة في قاعدة بياناتك. إذا حدث خطأ برمجي وحاول النظام مراسلتهم، فإن الحظر في واتساب سيمنع ذلك مادياً.

الحالة ب: الحماية من السبام

إذا قام مستخدم بتجاوز حدود معدل الرسائل (مثلاً إرسال 100 رسالة في دقيقة واحدة): يمكنك حظرهم تلقائياً وربما فك الحظر بعد 24 ساعة.


🔮 تفاصيل التنفيذ

عملية صامتة

الحظر عملية صامتة. لن يتلقى المستخدم إشعاراً يفيد بأنه تم حظره. سيرون فقط أنك توقفت عن استلام رسائلهم (لا توجد علامتا صح زرقاء أو رمادية).

المجموعات (Groups)

  • استثناء: حظر المستخدم لا يخرجه من المجموعات المشتركة بينكما.
  • التفاعل: ستظل ترى رسائلهم في تلك المجموعات، وسيظلون يرون رسائلك هناك. الحظر ينطبق فقط على الرسائل المباشرة (1:1).

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

معاملات الاستعلام والطلب (Query & Body Parameters)

تدعم التمرير عبر الرابط (Query String) أو كـ JSON Body
string

معرف الجلسة الفريد (Instance ID) الخاص برقمك

مثال:
string

مفتاح الوصول السري للـ API (Access Token)

مثال:
string

المعرف الفريد لجهة الاتصال المراد حظرها

مثال:

برمج بالذكاء الاصطناعي باستخدام Wawp MCP

MCP READY

قم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!

طريقة الربط والإعداد

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/contacts/block";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "123456789"
6}).toString();
7const body = {
8 "contactId": "123456789@c.us"
9};
10
11fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
12 method: "POST",
13 headers: { "Content-Type": "application/json" },
14 body: JSON.stringify(body)
15})
16 .then(async (response) => {
17 if (response.ok) {
18 const data = await response.json();
19 console.log("Success:", data);
20 return data;
21 }
22
23 // Error Handling
24 if (response.status === 401) {
25 console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
26 }
27 if (response.status === 400) {
28 console.error("Error 400: طلب غير صالح - تنسيق المعامل غير صالح");
29 }
30 if (response.status === 500) {
31 console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
32 }
33
34 const errorText = await response.text();
35 console.error(`Error ${response.status}: ${errorText}`);
36 })
37 .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 37, Col 1javascript

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

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

Contact blocked successfully
application/json
boolean *

Example

{
"ok": true
}
طلب غير صالح - تنسيق المعامل غير صالح
غير مصرح - مفتاح الوصول غير صالح أو مفقود
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقجلب صورة الملف الشخصي
الموضوع التاليإلغاء حظر جهة اتصال

Command Palette

Search for a command to run...