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

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

PUT
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}
PUT
PUT

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

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

توصيات

  • أضف ملصق 'تم التعامل معه بواسطة الروبوت' إلى الدردشات التي يديرها الروبوت الخاص بك.

  • استخدم الملصقات لتتبع رحلة العميل (مثل: عميل محتمل، مؤهل، مغلق).

وسم المحادثات: إتقان التنسيق الدلالي

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


🏗️ المفهوم الأساسي: البيانات الوصفية في المقدمة

فكر في التصنيفات كـ سمات ديناميكية تنقل الدردشة عبر خط المعالجة الداخلي الخاص بك.

المبادئ المعمارية الرئيسية:

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

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

1. إدارة حالة القمع

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

2. ذكاء الوسم التلقائي

من خلال دمج سجل الرسائل مع محرك تحليل أو كاشف كلمات دلالية، يمكنك وسم الدردشات برمجياً.

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

⚡ تنسيق الويب هوك

يؤدي كل ربط ناجح إلى إطلاق حدث إضافة تصنيف لدردشة. يمكنك استخدام هذا من أجل:

  • إطلاق التنبيهات: إرسال تنبيه في المتصفح للوكيل.
  • بدء الأتمتة: بدء حملة تنقيط معينة أو تسلسل بوت عند تطبيق تصنيف "عميل مهتم".

البارامترات

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

محتوى الطلب

يرسل كـ JSON
string

Your unique WhatsApp Instance ID

مثال:
string

Your API Access Token

مثال:
string

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

مثال:
string

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

مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (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: "PUT",
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...