جلب تصنيفات الدردشة

الحصول على جميع التصنيفات المعينة لدردشة محددة.

GET

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

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

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

تسجيل الدخول

اختبار /v2/labels/chats/{chatId}

يدعم

GET

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

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

الاقتران

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

تقسيم الصفحات

يدعم تقسيم الصفحات المستند إلى المؤشر للقوائم الكبيرة.

توصيات

استخدم هذا لبناء 'طرق عرض ذكية' في نظام إدارة علاقات العملاء (CRM) المخصص لديك.
اجلب الحقول الضرورية فقط لتحسين الأداء.

قراءة بيانات المحادثة: جلب جميع تصنيفات دردشة محددة

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

🏗️ المفهوم الأساسي

هذه الواجهة هي الأداة الأساسية لـ الاكتشاف في المحادثة. فهي تجيب على السؤال: "ما هو سياق العمل الحالي لهذه المحادثة المحددة؟"

القدرات الرئيسية:

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

🚀 حالات الاستخدام ذات الأولوية

ردود تلقائية ذكية

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

تحديث حالة CRM

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

🔄 اتساق الحالة والمزامنة

في بيئة متعددة الوكلاء، يعد ضمان رؤية جميع الوكلاء لنفس التصنيفات في نفس الوقت أمراً حيوياً لمنع تكرار العمل.

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

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

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

البارامترات

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

بارامترات الرابط

جزء من مسار الرابط أو استعلام

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		المعرف الفريد للدردشة (مثلاً: 123456789@c.us) مثال:

أمثلة الكود

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

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

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

Ln 35, Col 1javascript

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

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

List of labels for the chat

application/json

object *

Example

{
"0": {
  "id": "1",
  "name": "New Customer",
  "color": 0,
  "colorHex": "#ff9485"
  }
}

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

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

Command Palette

Search for a command to run...