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

ضبط اسم الملف الشخصي

قم بتحديث اسم العرض على واتساب (اسم الدفع).

PUT
https://api.wawp.net/v2/profile/name?access_token=YOUR_ACCESS_TOKEN&instance_id=123456789&name=Wawp+Support

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

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

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

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

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

توصيات

  • استخدم اسم عملك الرسمي أو اختصارًا واضحًا.

  • تجنب الرموز التعبيرية إذا كنت تريد أن تبدو محترفًا تمامًا.

الهوية في الجوهر: إدارة اسم عرض واتساب الخاص بك

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

🏗️ القيود التقنية والامتثال

على عكس سمات الملف الشخصي الأخرى، يخضع اسم العرض لرقابة آلية صارمة من قبل أنظمة النزاهة في Meta.

  1. حد الطول: يجب أن يتراوح الاسم بين 3 و 25 حرفاً.
  2. مجموعة الأحرف: يمكن أن يحتوي على رموز تعبيرية ونصوص محلية (العربية، السيريلية، إلخ) ولكنه لا يمكن أن يحتوي على روابط URL أو أرقام هواتف أو أحرف خاصة تُستخدم لانتحال شخصية كيانات واتساب الرسمية (على سبيل المثال، "WhatsApp Support" محظور).
  3. تنبيه المراجعة: قد يؤدي تغيير اسمك بشكل متكرر (على سبيل المثال، أكثر من 3 مرات في 24 ساعة) إلى تفعيل علامة "نشاط مشبوه"، مما يتسبب في تقييد رقمك مؤقتاً من إرسال قوالب التسويق.

🚀 أنماط التسمية الاستراتيجية

1. التنسيق "المحقق"

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

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

2. اللاحقة القسمية (للحسابات غير المحققة)

إذا كنت تدير مثيلات متعددة لفرق مختلفة:

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

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

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

🧩 حالة استخدام متقدمة: العلامة التجارية المحلية

للشركات العالمية التي تعمل في مناطق متعددة:

  • الاستراتيجية: استخدم أرقاماً (مثيلات) مميزة لكل سوق واضبط اسم العرض باللغة المحلية.
    • الأرقام أ (السعودية): "شركة الدعم"
    • الأرقام ب (أمريكا): "Support Co."

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

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

البارامترات

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

محتوى الطلب

يرسل كـ JSON
string

WhatsApp Instance ID

مثال:
string

API Access Token

مثال:
string

اسم العرض الجديد

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/profile/name";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "YOUR_ACCESS_TOKEN"
6}).toString();
7const body = {
8  "name": "Wawp 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...