تحديث تصنيف

تحديث اسم أو لون تصنيف واتساب موجود.

PUT

https://api.wawp.net/v2/labels/{labelId}?access_token=123456789&color=0&instance_id=123456789&labelId=3&name=Very+Urgent

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

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

تسجيل الدخول

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

يدعم

PUT

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

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

تعديل

يسمح بإعادة تسمية أو تغيير لون ملصق موجود.

الاتساق

يتم دفع التحديثات إلى جميع الأجهزة فورًا.

توصيات

أخطر الوكلاء إذا تغير معنى ملصق شائع (مثل 'أحمر' أصبح 'أولوية منخفضة').
قم بتحديث الطابع الزمني المحدث في قاعدة بياناتك المحلية.

تطور التصنيفات: التنقل في تغييرات البنية

مع نمو عملك ونضوج أقماع المبيعات أو الدعم، ستتغير متطلباتك التنظيمية حتماً. تم تصميم نقطة نهاية تحديث تصنيف لتسهيل هذا التطور، مما يتيح لك تحسين مصطلحاتك وتدرجك البصري دون قطع روابط المحادثات الموجودة.

🏗️ المفهوم الأساسي: التحسين غير التدميري

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

قوة التحديثات الجزئية

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

⚠️ السلوكيات الحرجة والمنطق الذري

مبدأ "المعرف المستقر"

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

تحمل الأسماء المكررة

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

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

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

البارامترات

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

محتوى الطلب

يرسل كـ JSON

`string`		Your unique WhatsApp Instance ID مثال:
`string`		Your API Access Token مثال:
`string`		المعرف الفريد للتصنيف المراد تحديثه مثال:
`string`	—	الاسم الجديد للتصنيف مثال:
`number`	—	رقم اللون الداخلي الجديد (0-19). مثلاً: 0=#ff9485 مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (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();
7const body = {
8  "name": "Very Urgent",
9  "color": "0"
10};
11
12fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
13  method: "PUT",
14  headers: { "Content-Type": "application/json" },
15  body: JSON.stringify(body)
16})
17  .then(async (response) => {
18    if (response.ok) {
19      const data = await response.json();
20      console.log("Success:", data);
21      return data;
22    }
23    
24    // Error Handling
25    if (response.status === 401) {
26      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
27    }
28    if (response.status === 400) {
29      console.error("Error 400: طلب غير صالح - تنسيق المعامل غير صالح");
30    }
31    if (response.status === 500) {
32      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
33    }
34
35    const errorText = await response.text();
36    console.error(`Error ${response.status}: ${errorText}`);
37  })
38  .catch((error) => console.error("Network Error:", error));

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

Ln 38, Col 1javascript

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

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

Label updated successfully

application/json

string *

number *

string *

Example

{
"id": "3",
"name": "Very Urgent",
"color": 0,
"colorHex": "#ff0000"
}

طلب غير صالح - تنسيق المعامل غير صالح

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

Command Palette

Search for a command to run...