التصنيفات (Labels)

إنشاء تصنيف

إنشاء تصنيف واتساب جديد مع اسم ولون اختياري.

POST
https://api.wawp.net/v2/labels?access_token=123456789&color=0&instance_id=123456789&name=Urgent

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

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

تسجيل الدخول
اختبار /v2/labels/create
POST
POST

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

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

توصيات

  • أنشئ اتفاقية تسمية عبر مؤسستك.

  • استخدم ألوانًا مميزة للعناصر ذات الأولوية العالية مقابل العناصر ذات الأولوية المنخفضة.

بناء بنية التصنيف: إنشاء التصنيفات

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

🏗️ الفلسفة المعمارية: تصميم بنية قابلة للتوسع

عندما تنشئ تصنيفاً، فأنت لا تقوم فقط بتسمية مجلد؛ بل تحدد حالة أو سمة يمكن للمحادثة أن تمتلكها. نظرًا لأن واتساب يحدد كل حساب بـ 20 تصنيفاً فقط، يجب أن يكون كل إدخال استراتيجياً وفعالاً.

استراتيجية "مخطط التصنيف"

يجب أن يركز نظام التصنيف المصمم جيداً على ثلاث ركائز أساسية:

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

🎨 نظام الألوان: ذكاء بصري للوكلاء

واجهة تصنيفات واتساب هي بيئة بصرية للغاية. تم تصميم لوحة الألوان المكونة من 20 لوناً لتقليل العبء المعرفي على الوكلاء الذين يديرون عشرات المحادثات المتزامنة.

  • الفهارس 0 و 13 (الأحمر عالي الاستعجال): محجوزة للتصعيد الحرج أو مخاطر خسارة العملاء.
  • الفهارس 1 و 14 (الأزرق التشغيلي): مثالية لسير العمل النشط أو التحديثات المعلوماتية.
  • الفهارس 9 و 15 (الأخضر الإيجابي): تستخدم لحالات "تم الإغلاق بنجاح" أو الدفعات المؤكدة.
  • الفهرس 2 (الأصفر): يمثل حالة "قيد الانتظار" — عادةً عندما تكون الكرة في ملعب العميل.

📏 قواعد التسمية والمعايير

لضمان فعالية تصنيفاتك في تطبيق الهاتف وسياق CRM الخاص بك، اتبع هذه المعايير:

  1. اقتصاد الأحرف: يفرض واتساب حداً يبلغ حوالي 25 حرفاً. الأسماء الطويلة سيتم اقتطاعها في الواجهة، مما يجعلها غير مفيدة. استخدم "عاجل: أحمد" بدلاً من "طلب دعم عالي الأولوية محال إلى أحمد".
  2. تسمية موجهة نحو العمل: استخدم التصنيفات التي تصف حالة أو إجراءً مطلوباً. "فاتورة" هي اسم؛ أما "تم إرسال الفاتورة" فهي حالة قابلة للتنفيذ.

⚠️ التوسع بما يتجاوز حد الـ 20 تصنيفاً

يمثل حد الـ 20 تصنيفاً تحدياً متكرراً للشركات سريعة النمو. إذا كان نظامك يتطلب أكثر من 20 فئة، نوصي بالأنماط التالية:

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

البارامترات

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

محتوى الطلب

يرسل كـ JSON
string

Your unique WhatsApp Instance ID

مثال:
string

Your API Access Token

مثال:
string

اسم التصنيف الجديد

مثال:
number—

رقم اللون الداخلي (0-19). مثلاً: 0=#ff9485

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/labels";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7const body = {
8  "name": "Urgent",
9  "color": "0"
10};
11
12fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
13  method: "POST",
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));
عينات تفاعلية
Ln 38, Col 1javascript

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

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

Label created successfully
طلب غير صالح - تنسيق المعامل غير صالح
غير مصرح - مفتاح الوصول غير صالح أو مفقود
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقجلب تصنيف محدد
الموضوع التاليتحديث تصنيف

Command Palette

Search for a command to run...