معلومات الملف الشخصي

ضبط حالة 'حول'

قم بتحديث حالة 'حول' (السيرة الذاتية) الخاصة بك على واتساب.

PUT
https://api.wawp.net/v2/profile/status?access_token=YOUR_ACCESS_TOKEN&instance_id=123456789&status=Available+for+support

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

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

تسجيل الدخول
اختبار /v2/profile/status
PUT
PUT

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

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

توصيات

  • قم بتضمين ساعات عملك أو موقع الدعم هنا.

  • استخدم هذه المساحة لشعار قصير.

لافتة المتجر الرقمية: إدارة نص "حول" الخاص بك

يعد حقل "حول" (المعروف سابقاً باسم "الحالة") عبارة عن سطر نصي بطول 139 حرفاً يظهر تحت اسم نشاطك التجاري في قائمة جهات اتصال المستخدم. على الرغم من تجاهله غالباً، إلا أنه مؤشر مستوى خدمة قوي. تسمح لك نقطة النهاية /v2/profile/status بمعاملة هذا الحقل كلوحة تحكم ديناميكية، تبث حالتك التشغيلية الحالية لأي شخص يعرض ملفك الشخصي.

🏗️ المواصفات التقنية

تعد هذه واحدة من أكثر نقاط النهاية خفة في مجموعة Wawp، ولكن لها قيود محددة:

  1. حد الطول: الحد الأقصى 139 حرفاً. سيقوم API باقتطاع أو رفض السلاسل الأطول.
  2. الظهور: افتراضياً، يكون هذا مرئياً للجميع ما لم تقيد إعدادات الخصوصية في الهاتف ظهور "حول" لـ "جهات اتصالي" أو "لا أحد".
  3. لا يوجد نص منسق: على عكس الرسائل، لا يمكنك استخدام تنسيق عريض/مائل هنا. ومع ذلك، فإن الرموز التعبيرية (Emojis) مدعومة بالكامل ويوصى بها بشدة للتدرج البصري.

🚀 أنماط الحالة الديناميكية

1. لافتة "مفتوح/مغلق"

قم بأتمتة ساعات عملك مباشرة على ملفك الشخصي.

  • سير العمل: ربط نقطة النهاية هذه بنظام الجدولة الداخلي الخاص بك.
  • الحالة أ (9 صباحاً - 5 مساءً): "🟢 متصل | الرد المعتاد: أقل من 5 دقائق"
  • الحالة ب (5 مساءً - 9 صباحاً): "🌙 غير متصل | اترك رسالة، وسنرد في الساعة 9 صباحاً."

2. إدارة الحوادث

أثناء انقطاع الخدمة، يمتلئ فريق الدعم بأسئلة "هل النظام متعطل؟".

  • تشتيت استباقي: قم بتحديث حالتك إلى: "⚠️ صيانة النظام جارية. التحديثات على status.acme.com".
  • الفائدة: سيرى المستخدمون الذين يتحققون من ملفك الشخصي ذلك فوراً، مما قد يمنع إنشاء تذكرة دعم.

🛡️ أفضل الممارسات للتفاعل

  • أضف لمسة إنسانية للبوت: إذا كان رقمك مؤتمتاً بشكل أساسي، فاذكر ذلك بوضوح.
    • مثال: "🤖 بوت حجز مؤتمت | اكتب 'مساعدة' للتحدث مع إنسان."
  • تجنب "متوفر": الحالة الافتراضية في واتساب هي "متوفر" (Available). إن تغييرها إلى شيء محدد (حتى مجرد شعارك) يجعل عملك يبدو فوراً أكثر نشاطاً ومهنية.

🧩 حالة استخدام متقدمة: تعاقب الوكلاء

لرقم دعم مشترك بين عدة وكلاء:

  • المنطق: عندما يسجل وكيل دخوله إلى لوحة التحكم، قم بإضافة اسمه إلى الحالة.
    • مثال: "الدعم | في الخدمة: سارة ومايك 👥"

⚠️ اعتبارات هامة

  • مدة التخزين المؤقت: يقوم واتساب بتخزين نص الحالة مؤقتاً وبقوة على أجهزة العملاء. قد يستغرق التغيير الذي تجريه عبر API ما يصل إلى 10 دقائق لينعكس على هاتف المستخدم إذا قام بالتحقق من ملفك الشخصي مؤخراً.

البارامترات

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

محتوى الطلب

يرسل كـ JSON
string

WhatsApp Instance ID

مثال:
string

API Access Token

مثال:
string

نص الحالة الجديد

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/profile/status";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "YOUR_ACCESS_TOKEN"
6}).toString();
7const body = {
8  "status": "Available for support"
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    if (response.status === 400) {
25      console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
26    }
27    if (response.status === 400) {
28      console.error("Error 400: طلب غير صالح (تنسيق XML)");
29    }
30    if (response.status === 400) {
31      console.error("Error 400: طلب غير صالح (نص عادي)");
32    }
33    if (response.status === 401) {
34      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
35    }
36    if (response.status === 401) {
37      console.error("Error 401: غير مصرح (تنسيق XML)");
38    }
39    if (response.status === 404) {
40      console.error("Error 404: غير موجود - الجلسة غير موجودة");
41    }
42    if (response.status === 404) {
43      console.error("Error 404: غير موجود (تنسيق XML)");
44    }
45    if (response.status === 500) {
46      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
47    }
48    if (response.status === 500) {
49      console.error("Error 500: خطأ في الخادم الداخلي (HTML)");
50    }
51    if (response.status === 502) {
52      console.error("Error 502: بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي");
53    }
54    if (response.status === 502) {
55      console.error("Error 502: بوابة غير صالحة (تنسيق XML)");
56    }
57
58    const errorText = await response.text();
59    console.error(`Error ${response.status}: ${errorText}`);
60  })
61  .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 61, Col 1javascript

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

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

ناجح - تم إكمال الطلب بنجاح
النوع:
application/json
boolean *
string *

Example

{
"success": true,
"message": "Operation completed successfully"
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي
الموضوع السابقضبط اسم الملف الشخصي
الموضوع التاليرفع صورة واتساب

Command Palette

Search for a command to run...