إلغاء حظر جهة اتصال

إلغاء حظر جهة اتصال تم حظرها مسبقاً.

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

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

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

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

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

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

توصيات

  • قم بإلغاء حظر المستخدمين بعد إكمالهم عملية التحقق أو الاستئناف.

  • أرسل رسالة تؤكد رفع الحظر لإعادة التفاعل.

استعادة الروابط: إلغاء حظر جهات الاتصال

تعكس نقطة النهاية /v2/contacts/unblock تأثيرات الحظر، مما يسمح للمستخدم بالتواصل مع البوت الخاص بك مرة أخرى.


🔓 خرافة "الصحيفة البيضاء"

من الضروري فهم ما يفعله وما لا يفعله إلغاء الحظر.

ما يفعله:

  1. الرسائل الواردة: يمكن للمستخدم الآن إرسال رسائل إليك مرة أخرى، وستتلقاها عبر الويب هوك.
  2. الحالة: يمكنهم الآن رؤية حالة "متصل"، و"حول"، وصورتك الشخصية (حسب إعدادات خصوصيتك).

ما لا يفعله:

  1. استرجاع الرسائل الفائتة: إذا أرسل المستخدم رسائل أثناء حظره، فهذه الرسائل فُقدت للأبد. لا يمكنك "جلبها" بعد إلغاء الحظر.
  2. إخطار المستخدم: لن يتلقى المستخدم إشعاراً يفيد بأنه تم إلغاء حظره. سيلاحظون فقط أن رسائلهم بدأت تأخذ علامتي صح (تم التسليم) مرة أخرى.

🔄 استراتيجيات إعادة التفاعل

إذا قمت بحظر مستخدم بسبب السبام وتريد الآن الترحيب به مرة أخرى:

1. إلغاء الحظر الصامت

  • الإجراء: استدعِ unblockContact ولا تفعل شيئاً آخر. إذا راسلك المستخدم مستقبلاً ستجيبه.

2. إعادة التفاعل النشط

  • الإجراء: بعد إلغاء الحظر، انتظر ثانيتين ثم أرسل رسالة نصية: "مرحباً! لقد قمنا بتنشيط حسابك مرة أخرى. يرجى اتباع شروط الخدمة الخاصة بنا."

⚠️ الأخطاء الشائعة

400 Bad Request

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

البارامترات

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

معاملات الاستعلام والطلب (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/unblock";
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 unblocked successfully
application/json
boolean *

Example

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

Command Palette

Search for a command to run...