تعيين تصنيفات الدردشة

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

PUT
https://api.wawp.net/v2/labels/chats/{chatId}?access_token=123456789&chatId=123456789%40c.us&instance_id=123456789&labels=%5B%221%22%2C+%222%22%5D

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

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

تسجيل الدخول
اختبار /v2/labels/chats/{chatId}/set
PUTPOST

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

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

توصيات

  • استخدم نقاط نهاية 'إضافة' بدلاً من ذلك إذا كنت تريد الحفاظ على الملصقات الموجودة.

  • تحقق من صحة جميع معرفات الملصقات قبل إرسال الطلب.

إدارة الحالة الحاسمة: استبدال جميع تصنيفات الدردشة

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


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

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

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

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

⚡ العمق التقني: سلامة المعاملات

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

  1. جلب الحالة الحالية للمحادثة.
  2. أضف / أزل المعرفات التي تريدها محلياً.
  3. استدعِ هذه الواجهة بالمصفوفة النهائية.

🛡️ الموثوقية وتنسيق الويب هوك

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

  • إدارة ضجيج الويب هوك: إذا كان نظامك يستمع لحدث إضافة تصنيف لدردشة، فإن تعيين 5 تصنيفات في وقت واحد سيطلق 5 أحداث ويب هوك.
  • التماثل: إذا قمت بتعيين نفس التصنيفات التي تحملها الدردشة بالفعل، فلن تنطلق أي أحداث ويب هوك، مما يجعلها عملية آمنة للتشغيل في وظائف المزامنة الدورية.

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

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

البارامترات

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

معاملات الاستعلام والطلب (Query & Body Parameters)

تدعم التمرير عبر الرابط (Query String) أو كـ JSON Body
string

معرف الجلسة الفريد (Instance ID) الخاص برقمك

مثال:
string

مفتاح الوصول السري للـ API (Access Token)

مثال:
string

المعرف الفريد للدردشة (مثلاً: 123456789@c.us)

مثال:
string[]

مصفوفة من معرفات التصنيفات للتعيين (تستبدل الموجودة)

مثال:

برمج بالذكاء الاصطناعي باستخدام Wawp MCP

MCP READY

قم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!

طريقة الربط والإعداد

أمثلة الكود

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

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

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

Labels updated successfully
application/json
boolean *

Example

{
"ok": true
}
طلب غير صالح - تنسيق المعامل غير صالح
غير مصرح - مفتاح الوصول غير صالح أو مفقود
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقجلب تصنيفات الدردشة
الموضوع التالينظرة عامة على المجموعات

Command Palette

Search for a command to run...