حذف تصنيف

حذف تصنيف واتساب بشكل نهائي.

DELETE

https://api.wawp.net/v2/labels/{labelId}?access_token=123456789&instance_id=123456789&labelId=3

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

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

تسجيل الدخول

اختبار /v2/labels/{labelId}/delete

يدعم

DELETE

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

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

تسلسل

حذف الملصق يزيله من جميع الدردشات المرتبطة به.

لا رجعة فيه

لا يمكن التراجع عن هذا الإجراء.

توصيات

فكر في إعادة التسمية بدلاً من الحذف إذا تغير الغرض قليلاً.
دمج الدردشات في ملصق جديد قبل حذف القديم.

إدارة دورة الحياة: بروتوكول الحذف

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

⚠️ خطورة الحذف: عواقب لا يمكن التراجع عنها

يعد حذف التصنيف أحد الإجراءات التدميرية القليلة في منظومة واتساب. من الضروري فهم الآثار المترتبة قبل التنفيذ:

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

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

1. إيقاف تشغيل ما بعد الحملة

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

2. دمج التصنيفات

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

🛡️ نمط "إيقاف التشغيل الآمن"

لتجنب فقدان البيانات العرضي أو تعطل سير العمل، يجب اتخاذ الخطوات المعمارية التالية قبل حذف التصنيف:

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

البارامترات

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

محتوى الطلب

يرسل كـ JSON

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		المعرف الفريد للتصنيف المراد حذفه مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/labels/3";
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 === 401) {
23      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
24    }
25    if (response.status === 500) {
26      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
27    }
28
29    const errorText = await response.text();
30    console.error(`Error ${response.status}: ${errorText}`);
31  })
32  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 32, Col 1javascript

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

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

Label deleted successfully

application/json

boolean *

Example

{
"ok": true
}

غير مصرح - مفتاح الوصول غير صالح أو مفقود

خطأ في الخادم الداخلي - فشل غير متوقع