جلب كود دعوة المجموعة

الحصول على كود الدعوة الحالي للمجموعة.

GET

https://api.wawp.net/v2/groups/{id}/invite-code?access_token=123456789&id=1234567890%40g.us&instance_id=123456789

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

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

تسجيل الدخول

اختبار /v2/groups/{id}/invite-code

يدعم

GET

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

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

الأمان

يمكن لأي شخص لديه هذا الرمز الانضمام. عامله مثل كلمة المرور.

التنسيق

يعيد رابطًا كاملاً (https://chat.whatsapp.com/...) والرمز الخام.

توصيات

شارك هذا الرمز فقط في القنوات الآمنة.
قم بإلغاء الرمز فورًا إذا اكتشفت انضمامات غير مصرح بها.
استخدم هذا للمجتمعات 'المفتوحة' حيث تكون الإضافة اليدوية بطيئة جدًا.

مفتاح الوصول: إتقان توزيع الدخول للمجموعات

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

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

من منظور تقني، كود الدعوة هو وكيل عام لمعرف خاص.

فصل الاكتشاف عن الهوية: معرف المجموعة (@g.us) هو معرف داخلي يصعب على المستخدم استخدامه مباشرة، بينما يوفر كود الدعوة رابطاً نصياً (chat.whatsapp.com/...) يمكن لتطبيق واتساب حله فوراً.
قوة الإشراف الإداري: لا يمكن إلا لـ مسؤول المجموعة (Admin) استرداد الكود أو إدارته، مما يضمن أن توليد روابط الدخول هو عمل تحت الحوكمة.
الاستمرارية والتقلب: يظل كود الدعوة قائماً حتى يتم إلغاؤه صراحةً، مما يتيح لك طباعة رمز QR أو تضمين رابط في نشرة إخبارية بثقة في بقائه فعالاً.

🚀 حالات الاستخدام الاستراتيجي: التحصيل عالي السرعة

1. قمع هبوط "بدون احتكاك"

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

2. جسر من الواقع إلى العالم الرقمي (QR Codes)

بالنسبة للفعاليات أو المتاجر، يمكن لنظامك جلب الكود لمجموعة إقليمية وتوليد رمز QR ديناميكي للعرض في المتجر، ليمسحه العملاء وينضموا فوراً لمجموعة دعم لهذا الموقع المحدد.

🛡️ أفضل الممارسات التشغيلية

هوية الرابط: عند مشاركة الكود، يفضل دائماً تقديمه كرابط كامل: https://chat.whatsapp.com/{code} لضمان تعرف جميع أنظمة التشغيل عليه كرابط عميق قابل للنقر.
مراقبة نبض الدخول: استمع لويب هوك group.participants.update؛ فعندما ينضم مستخدم عبر كود، يتضمن الإخطار غالباً طريقة الدخول، مما يساعدك في قياس كفاءة حملاتك.

البارامترات

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

بارامترات الرابط

جزء من مسار الرابط أو استعلام

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		The unique ID of the group مثال:

أمثلة الكود

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

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

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

Ln 27, Col 1javascript

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

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

Invite code retrieved

application/json

string *

Example

{
"code": "ABC123XYZ"
}

الموضوع السابققصر إرسال الرسائل على المسؤولين فقط

الموضوع التاليإلغاء كود دعوة المجموعة وتوليد كود جديد