التحكم في القنوات

إنشاء قناة

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

POST
https://api.wawp.net/v2/channels?access_token=123456789&description=Channel+Description&instance_id=123456789&name=Channel+Name&picture=%7B%0A++%22mimetype%22%3A+%22image%2Fjpeg%22%2C%0A++%22filename%22%3A+%22filename.jpg%22%2C%0A++%22url%22%3A+%22https%3A%2F%2Fwawp.net%2Fwp-content%2Fuploads%2F2025%2F08%2Ficon-256x256-1.jpg%22%0A%7D&type=string

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

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

تسجيل الدخول
اختبار /v2/channels/create
POST
POST

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

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

توصيات

  • استخدم عناوين واضحة ووصفية لتحسين إمكانية الاكتشاف.

  • قم بإعداد تقويم للمحتوى قبل الإطلاق للحفاظ على تفاعل المتابعين.

  • تحقق مما إذا كانت منطقتك المحلية تدعم إنشاء القنوات.

الكتلة الأولى: إنشاء القنوات برمجياً

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

🏗️ تشريح القناة

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

1. الاسم (name)

  • القيد: بحد أقصى حوالي 100 حرف (على الرغم من أن واتساب يوصي بأقل من 25 حرفاً لسهولة الظهور).
  • الاستراتيجية: هذا هو العنوان القابل للبحث. إذا كنت وكالة أنباء، فتضمن اسم علامتك التجارية.

2. الوصف (description)

  • SEO: يتم أرشفة هذا الحقل بواسطة بحث دليل واتساب. تضمن الكلمات الرئيسية هنا.
    • مثال: "تنبيهات يومية لأسواق البيتكوين و العملات الرقمية. القناة الرسمية لـ CryptoNews."

3. الصورة (picture)

  • الأبعاد: يوصى بـ 640x640 بكسل (مربع).
  • السلوك: يوصى بشدة بضبط هذه الصورة أثناء الإنشاء لزيادة معدلات النقر من الدليل.

🚀 سير العمل بعد الإنشاء

بمجرد تلقي استجابة 201 Created، ستصبح قناتك مباشرة على الشبكة، ولكن بـ 0 متابعين.

الخطوة 1: حفظ الـ JID

ستحتوي الاستجابة على معرف id ينتهي بـ @newsletter.

  • الإجراء: قم بتخزين هذا المعرف بشكل دائم في قاعدة بياناتك. لا يمكنك إرسال رسائل بدونه.

الخطوة 2: رابط الدعوة

يمكنك عادةً الحصول على رابط الدعوة (invite_link) بجلب معلومات القناة.

  • التوزيع: قم بتضمين هذا الرابط في توقيع بريدك الإلكتروني، ولافتات موقعك، وحملات SMS الخاصة بك.

⚠️ القيود والضوابط

  • حدود المعدل: يمكنك عادةً إنشاء عدد محدود من القنوات لكل رقم هاتف يومياً.
  • الامتثال: يتم الإشراف على محتوى القناة من قبل Meta. قد يؤدي إنشاء قنوات لمواضيع غير قانونية إلى حظر فوري لمثيل Wawp الخاص بك بالكامل.

البارامترات

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

محتوى الطلب

يرسل كـ JSON
string

Your unique WhatsApp Instance ID

مثال:
string

Your API Access Token

مثال:
string

اسم القناة

مثال:
string—

وصف موجز للقناة

مثال:
object—

تفاصيل صورة ملف تعريف القناة

مثال:
string—

نوع القناة

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/channels";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7const body = {
8  "name": "Channel Name",
9  "description": "Channel Description",
10  "picture": {
11    "mimetype": "image/jpeg",
12    "filename": "filename.jpg",
13    "url": "https://wawp.net/wp-content/uploads/2025/08/icon-256x256-1.jpg"
14  },
15  "type": "string"
16};
17
18fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
19  method: "POST",
20  headers: { "Content-Type": "application/json" },
21  body: JSON.stringify(body)
22})
23  .then(async (response) => {
24    if (response.ok) {
25      const data = await response.json();
26      console.log("Success:", data);
27      return data;
28    }
29    
30    // Error Handling
31    if (response.status === 401) {
32      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
33    }
34    if (response.status === 400) {
35      console.error("Error 400: طلب غير صالح - تنسيق المعامل غير صالح");
36    }
37    if (response.status === 500) {
38      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
39    }
40
41    const errorText = await response.text();
42    console.error(`Error ${response.status}: ${errorText}`);
43  })
44  .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 44, Col 1javascript

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

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

تم إنشاء القناة بنجاح
طلب غير صالح - تنسيق المعامل غير صالح
غير مصرح - مفتاح الوصول غير صالح أو مفقود
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقالحصول على قائمة القنوات
الموضوع التاليالحصول على معلومات القناة

Command Palette

Search for a command to run...