إلغاء ربط تصنيف بالدردشة

إزالة تصنيف محدد من دردشة أو جهة اتصال.

DELETE
https://api.wawp.net/v2/labels/{id}/chats/{chatId}?access_token=123456789&chatId=201234567890%40c.us&id=1&instance_id=123456789

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

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

تسجيل الدخول
اختبار /v2/labels/{id}/chats/{chatId}/delete
DELETEPOST

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

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

توصيات

  • قم بإزالة ملصقات 'جديد' بمجرد رد الوكيل.

  • قم بمراجعة الدردشات القديمة بشكل دوري لإزالة الملصقات القديمة.

إلغاء وسم المحادثات: إتقان تهذيب التصنيفات

نقطة نهاية إلغاء ربط تصنيف بالدردشة هي المكمل الحاسم لعملية الوسم. تتيح لك إزالة البيانات الوصفية القديمة أو التي تم حلها من المحادثة، مما يضمن بقاء صندوق وارد وكلائك خالياً من الفوضى وأن محركات الأتمتة تعمل على أحدث حالة للعلاقة.


🏗️ المفهوم الأساسي: خفض تصعيد الحالة

إزالة التصنيف هي المعادل البرمجي لـ حل حالة أو الانتقال لمرحلة جديدة.

الخصائص التشغيلية الرئيسية:

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

🚀 حالات الاستخدام الاستراتيجية

1. نظافة انتقال القمع

مع تعمق العميل في قمع المبيعات أو الدعم، تصبح مراحله السابقة غالباً غير ذات صلة. على سبيل المثال، بمجرد أن يصبح "عميل جديد" "فرصة مؤهلة"، يجب إلغاء ربط وسم "عميل جديد". هذا يبقي الواجهة البصرية مركزة على الإجراء المطلوب التالي.

2. التنظيف التلقائي للبيانات "القديمة"

في الحسابات ذات المجلدات الكبيرة، يمكن أن تتراكم التصنيفات بمرور الوقت. استخدم هذه الواجهة مع وظيفة مجدولة لإلغاء ربط التصنيفات "المؤقتة" بعد فترة محددة من الخمول (مثلاً 7 أيام).


🎯 أفضل الممارسات

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

البارامترات

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

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

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

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

مثال:
string

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

مثال:
string

رقم الهاتف المستهدف أو معرف المجموعة (@c.us, @g.us)

مثال:
string

المعرف الفريد للتصنيف

مثال:

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

MCP READY

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

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

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/labels/1/chats/201234567890@c.us";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "123456789"
6}).toString();
7
8
9fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
10 method: "DELETE",
11 headers: { "Content-Type": "application/json" },
12
13})
14 .then(async (response) => {
15 if (response.ok) {
16 const data = await response.json();
17 console.log("Success:", data);
18 return data;
19 }
20
21 // Error Handling
22 if (response.status === 400) {
23 console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
24 }
25 if (response.status === 400) {
26 console.error("Error 400: طلب غير صالح (تنسيق XML)");
27 }
28 if (response.status === 400) {
29 console.error("Error 400: طلب غير صالح (نص عادي)");
30 }
31 if (response.status === 401) {
32 console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
33 }
34 if (response.status === 401) {
35 console.error("Error 401: غير مصرح (تنسيق XML)");
36 }
37 if (response.status === 404) {
38 console.error("Error 404: غير موجود - الجلسة غير موجودة");
39 }
40 if (response.status === 404) {
41 console.error("Error 404: غير موجود (تنسيق XML)");
42 }
43 if (response.status === 500) {
44 console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
45 }
46 if (response.status === 500) {
47 console.error("Error 500: خطأ في الخادم الداخلي (HTML)");
48 }
49 if (response.status === 502) {
50 console.error("Error 502: بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي");
51 }
52 if (response.status === 502) {
53 console.error("Error 502: بوابة غير صالحة (تنسيق XML)");
54 }
55
56 const errorText = await response.text();
57 console.error(`Error ${response.status}: ${errorText}`);
58 })
59 .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 59, Col 1javascript

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

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

ناجح - تم إكمال الطلب بنجاح
النوع:
application/json
boolean *
string *

Example

{
"success": true,
"message": "Operation completed successfully"
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي
الموضوع السابقربط تصنيف بالدردشة
الموضوع التاليجلب تصنيفات الدردشة

Command Palette

Search for a command to run...