خطأ WhatsApp 3: مشكلة في القدرات أو الصلاحيات
يعني رمز الخطأ 3 أن التطبيق الذي يستدعي نقطة النهاية (endpoint) يفتقر إلى قدرة أو صلاحية تتطلبها تلك النقطة. وصف Meta له هو «مشكلة في القدرات أو الصلاحيات»، وتسميه Graph API باسم API Method. الحل هو فحص الصلاحيات الممنوحة لرمز الوصول (token) بأداة تصحيح رمز الوصول، ثم إضافة الصلاحية التي تحتاجها نقطة النهاية.
الرمز الذي تستخدمه Meta للدلالة على «مشكلة في القدرات أو الصلاحيات».
الاسم الذي يمنحه دليل معالجة الأخطاء في Graph API للرمز 3.
whatsapp_business_management و whatsapp_business_messaging، وهما الصلاحيتان اللتان تحتاجهما أغلب نقاط النهاية في WhatsApp.
ماذا يعني رمز الخطأ 3 في WhatsApp؟
يعني أن الطلب جرى توثيقه لكن التطبيق غير مسموح له بما طلبه.
تدرج Meta الرمز 3 ضمن أخطاء التفويض في مرجع Cloud API مع نص التفاصيل «مشكلة في القدرات أو الصلاحيات». أما دليل معالجة الأخطاء في Graph API، الذي ترثه Cloud API، فيسمي الرمز نفسه API Method ويطلب التأكد من أن التطبيق يملك القدرة أو الصلاحيات التي يحتاجها الاستدعاء.
إذن الـ token يعمل. الهوية ليست المشكلة، وهذا ما يفصل هذا الخطأ عن الرمزين 0 و190. المشكلة فيما يُسمح للرمز بالوصول إليه.
كيف تعرف الصلاحيات التي يملكها الـ token؟
بأداة تصحيح رمز الوصول، أو عبر endpoint باسم debug_token الذي يعيد المعلومات نفسها.
تسرد الاستجابة الصلاحيات الممنوحة في الخاصية scopes. قارن القائمة بصفحة المرجع الخاصة بنقطة النهاية التي فشلت، فكل مرجع يذكر الصلاحيات التي يتطلبها.
في WhatsApp تغطي صلاحيتان ما يقارب كل شيء. تلزم whatsapp_business_management لبيانات الحساب الوصفية والقوالب وقوائم أرقام الهاتف والتحليلات ولـ خطاف الويب (webhook) الخاص بالحساب. وتلزم whatsapp_business_messaging لإرسال أي رسالة ولاستقبال webhook الرسائل والحالة. الـ token الذي يحمل إحداهما فقط يفشل في الاستدعاءات التي تحتاج الأخرى.
لماذا يظهر الخطأ 3 لتطبيق شريك ولا يظهر لمطور يعمل مباشرة؟
لأن الشركاء الذين يخدمون نشاطات تجارية أخرى يمرون ببوابة إضافية.
يقول دليل الصلاحيات من Meta إن الشريك الذي يستخدم عملاؤه تطبيقه للوصول إلى بياناتهم يجب أن يجتاز مراجعة التطبيق (App Review) ويحصل على وصول متقدم (Advanced access) لكل صلاحية يحتاجها التطبيق. أما المطور المباشر الذي يعمل على بيانات نشاطه التجاري وحده فلا يحتاج إلى ذلك.
لذلك قد يعمل الكود نفسه بسلاسة على حساب المطور ويفشل على حساب عميل. حين يظهر هذا النمط، فالسؤال ليس عن الصلاحية الناقصة في الـ token، بل عن موافقة Meta على استخدام التطبيق لتلك الصلاحية على أصول لا يملكها.
الأخطاء الشائعة
- إنشاء token جديد بالصلاحيات نفسها. الرمز الجديد بالصلاحيات نفسها يفشل في الموضع نفسه.
- فحص اسم الصلاحية في إعدادات التطبيق بدل فحصه على الرمز. المعتبر هو ما مُنح للرمز فعلًا.
- الاختبار على حسابك وحده. تحتاج تطبيقات الشركاء إلى وصول متقدم قبل أن تقبل حسابات العملاء الاستدعاء.
تربط EasyCoexistence كل رقم عبر تدفق Embedded Signup الرسمي من Meta، فيمنح النشاط التجاري الصلاحيات عند الإعداد الأولي، وتبقى صحة الاتصال ظاهرة في لوحة التحكم بعد ذلك.
الأسئلة الشائعة
هل الخطأ 3 مشكلة في رقم هاتفي؟
لا. يتعلق بما يُسمح لـ token التطبيق بفعله. لا يُفحص الرقم قبل رفض الطلب.
ما الفرق بين الخطأ 3 والخطأ 10؟
الرمز 3 مشكلة في القدرات أو الصلاحيات. أما الرمز 10 فيفيد بأن صلاحية لم تُمنح أو أُزيلت. ويُحل كلاهما بفحص قيمة scopes في الرمز.
ما الصلاحية التي أحتاجها لإرسال الرسائل؟
whatsapp_business_messaging. يقول دليل الصلاحيات من Meta إنها مطلوبة لإرسال أي نوع من الرسائل.
هل تفيد إعادة المحاولة؟
لا. صلاحيات الـ token لا تتغير بين المحاولات، فتكون النتيجة نفسها.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في