Groups API

WhatsApp Groups API: الأهلية والبدء والمراسلة

دليل محدث لواجهة WhatsApp Groups API الرسمية: الأهلية، إنشاء المجموعة، رابط الدعوة، Webhooks وإرسال الرسائل.

تم التحقق من المصادر الرسمية: 4 أغسطس 2026
الإجابة المختصرة: WhatsApp Groups API تتيح للشركات المؤهلة إنشاء مجموعات وإدارتها برمجيًا على Cloud API. الانضمام يتم عبر رابط دعوة يختاره المستخدم، وبعد انضمامه تصل أحداث Webhook ويمكن بدء مراسلة المجموعة وفق القيود الحالية.

من المؤهل؟

تنص وثائق Meta الحالية على متطلبات أهلية لميزة المجموعات، وتوضح أن المجموعات غير متاحة لأرقام تطبيق WhatsApp Business. يجب فحص أهلية حسابك ورقمك من المصدر الرسمي قبل البناء؛ ظهور Cloud API وحده لا يعني أن Groups API متاحة للحساب.

خطوات البدء

جهّز رقم Cloud API وWebhook، واشترك في حقول أحداث المجموعات المطلوبة، ثم أنشئ المجموعة بموضوع ووصف اختياري. يعيد حدث إنشاء المجموعة رابط الدعوة الذي يمكن مشاركته مع المشاركين المحتملين.

الدعوة والانضمام

المجموعات قائمة على الدعوة؛ لا يُضاف العميل سرًا. تعرض الدعوة معلومات المجموعة ويقرر المستخدم الانضمام. عند انضمامه يصل حدث group_participants_update، ويصبح التفاعل مع المجموعة ممكنًا وفق القواعد.

الأحداث والمراسلة

تشمل أحداث المجموعات دورة حياة المجموعة والمشاركين والإعدادات والحالة. كما تصل الرسائل الواردة وحالات الرسائل عبر Webhooks. ابنِ معالجة تمنع تكرار الحدث وتحافظ على سجل واضح للمجموعة والمشاركين.

ملاحظة مهمة قبل الإطلاق

الميزة والأهلية والقيود قابلة للتغيير. لا تعتمد على مقال قديم أو لقطة شاشة؛ راجع صفحة Groups API الرسمية وحالة الحساب مباشرة يوم التنفيذ.

أسئلة شائعة

هل Groups API متاحة لكل حساب؟

لا. تخضع للأهلية والقيود الموضحة في وثائق Meta وحالة الحساب.

هل يمكن إضافة العميل مباشرة؟

الانضمام قائم على رابط دعوة، والمستخدم يقرر الانضمام.

هل تعمل مع رقم تطبيق WhatsApp Business؟

توضح الوثائق الحالية أنها غير متاحة لأرقام تطبيق WhatsApp Business؛ المطلوب رقم Cloud API مؤهل.

كيف أعرف أن عضوًا انضم؟

عبر حدث group_participants_update في Webhook.

المصادر الرسمية

تمت مراجعة هذه الصفحة مقابل المصادر التالية في 4 أغسطس 2026:

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