الموضوع له حد للأحرف (حوالي 100 حرف).

يمكن اعتبار تغييرات الاسم المتكررة كرسائل عشوائية.

تحديث اسم المجموعة

تحديث اسم (موضوع) المجموعة.

PUT

https://api.wawp.net/v2/groups/{id}/subject?access_token=123456789&id=1234567890%40g.us&instance_id=123456789&subject=Alpha+Team+Updates

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

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

تسجيل الدخول

اختبار /v2/groups/{id}/subject

يدعم

PUT

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

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

توصيات

قم بتضمين طابع زمني أو حالة في الموضوع (مثلًا، 'مشروع ألفا [مغلق]').
استخدم اتفاقيات تسمية متسقة للبحث السهل.
تجنب المعلومات الشخصية الحساسة في مواضيع المجموعة لأنها تظهر في الإشعارات.

قوة التسمية: الإشارة الاستراتيجية للهوية

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

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

من منظور تقني، اسم المجموعة هو حقل متغير مرتبط بـ معرف غير متغير (Global-JID).

فصل الهوية عن التواجد: يجب أن يرتكز منطق قاعدة البيانات الخاصة بك دائماً على معرف المجموعة (@g.us)، وليس اسمها. يتيح لك هذا الـ API فرض اتفاقية التسمية المفضلة لديك، مما يضمن مطابقة الواقع المرئي للمحادثة مع حالة المشروع الداخلية.
قوة حقوق المسؤول: اعتماداً على إعدادات المجموعة، قد تقتصر هذه القدرة على المسؤولين فقط. لضمان قدرة نظامك دائماً على التحديث، يجب أن يحافظ مثيل Wawp على وضع المسؤول.
المزامنة العالمية وإشعارات الدفع: في كل مرة يتم فيها تحديث الاسم، يتم دفع حدث مزامنة لجميع الأعضاء. استخدم هذا "لجذب الانتباه" استراتيجياً للإشارة إلى معالم المشروع الكبرى.

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

1. مؤشر "مراحل سير العمل"

في الدعم الفني، يمكن أن تبدأ المجموعة باسم [OPEN] - طلب #1234، ومع التقدم تتغير إلى [IN PROGRESS] ثم [RESOLVED]. يتيح ذلك للعميل معرفة تقدم طلبه بمجرد النظر لقائمة المحادثات.

2. الترقيم التسلسلي لإنتاجية الوكلاء

بالنسبة للشركات التي تدير مئات المجموعات، يمكن حقن أكواد الأولوية (مثل [PRIO-A] توصيل شركة أجمي) لمساعدة الوكلاء البشر على ترتيب أولوياتهم بناءً على إشارات مرئية.

🛡️ الحوكمة ونظافة التشغيل

إذا كانت الإعدادات تسمح للمشاركين بتغيير الاسم، فقد تسمي المجموعة باسم غير لائق. نوصي بالاستماع للويب هوك group.update؛ وإذا تم اكتشاف تغيير غير مصرح به، يمكن للنظام فوراً إعادة الاسم للمعيار الرسمي للشركة. لاحظ أن أسماء مجموعات واتساب محدودة بـ 25 حرفاً، لذا يجب أن يكون منطقك مختصراً ويضع المعلومات المهمة في البداية.

البارامترات

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

محتوى الطلب

يرسل كـ JSON

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		The unique ID of the group مثال:
	`string`		اسم المجموعة الجديد مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/groups/1234567890@g.us/subject";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7const body = {
8  "subject": "Alpha Team Updates"
9};
10
11fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
12  method: "PUT",
13  headers: { "Content-Type": "application/json" },
14  body: JSON.stringify(body)
15})
16  .then(async (response) => {
17    if (response.ok) {
18      const data = await response.json();
19      console.log("Success:", data);
20      return data;
21    }
22    
23    // Error Handling
24    
25
26    const errorText = await response.text();
27    console.error(`Error ${response.status}: ${errorText}`);
28  })
29  .catch((error) => console.error("Network Error:", error));

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

Ln 29, Col 1javascript

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

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

Subject updated

application/json

boolean *

Example

{
"ok": true
}

الموضوع السابقتحديث وصف المجموعة

الموضوع التاليجلب إعدادات 'تعديل المعلومات للمسؤولين فقط'