خطأ WhatsApp 10: الإذن غير ممنوح أو تمت إزالته
يعني رمز الخطأ 10 أن رمز الوصول (token) الخاص بالتطبيق يفتقر إلى إذن تحتاجه نقطة النهاية (endpoint)، إما لأنه لم يُمنح قط أو لأنه أُزيل. وصف Meta له: «الإذن إما غير ممنوح أو أُزيل». وتذكر Meta سببين آخرين في WhatsApp: رقم غير مدرج في القائمة المسموح بها في Flows with Endpoint، وعدم استيفاء شروط الأهلية الخاصة بواجهة برمجة التطبيقات (API) المستخدمة.
رمز Meta لعبارة «الإذن إما غير ممنوح أو أُزيل».
الاسم الذي يعطيه دليل معالجة أخطاء Graph API للرمز 10.
ما يحتاجه تطبيق الشريك لكل إذن يستخدمه على حسابات العملاء.
ماذا يعني رمز الخطأ 10 في WhatsApp؟
يعني أن token وصل إلى Meta وجرى التعرف عليه، لكن الإذن الذي يتطلبه الاستدعاء غير موجود عليه.
يعطي مرجع Cloud API من Meta الرمز 10 نص التفاصيل «الإذن إما غير ممنوح أو أُزيل». ويسميه دليل معالجة أخطاء Graph API «API Permission Denied» ويطلب معالجة الإذن الناقص.
كلمة «أُزيل» مهمة هنا. فقد يُمنح الإذن عند الإعداد ثم يُسحب لاحقًا، مثلًا حين يلغي أحدهم وصول التطبيق من إعدادات النشاط التجاري، فيبدأ تكامل عمل شهورًا في إرجاع الخطأ 10 دون أي تغيير في شيفرته.
ما الأسباب الأخرى التي تذكرها Meta للخطأ 10؟
سببان خاصان بـ WhatsApp، ومن السهل تفويتهما لأنهما لا يتعلقان بالنطاقات إطلاقًا.
ففي WhatsApp Flows مع Flows with Endpoint، تقول Meta إن عليك التأكد من أن الرقم المستخدم لتعيين المفتاح العام للنشاط التجاري مدرج في القائمة المسموح بها. والرقم الخارج عن القائمة يُنتج هذا الرمز حتى لو كان token يحمل كل الأذونات.
وتقول Meta أيضًا إن الحساب الذي لا يستوفي شروط الأهلية الخاصة بواجهة API التي يستدعيها يتلقى هذا الرمز. وفي هذه الحالة لن يفيد أي تغيير في token، لأن العائق هو أهلية الحساب وليس بيانات الاعتماد.
كيف تعالج الخطأ 10؟
ابدأ بمصحّح رمز الوصول (Access Token Debugger)، فهو أول فحص تذكره Meta.
إذا خلت قائمة النطاقات من الإذن الذي تحتاجه endpoint، فاطلب من النشاط التجاري منحه من جديد. وفي تطبيق الشريك يعني ذلك أيضًا التأكد من الوصول المتقدم لهذا الإذن، لأن دليل الأذونات من Meta يشترطه لحسابات العملاء.
أما إذا بدت النطاقات مكتملة، فانتقل إلى السببين الخاصين بـ WhatsApp. في استدعاء Flows، افحص القائمة المسموح بها للرقم الذي عيّن المفتاح العام. وفي أي حالة أخرى، اقرأ شروط الأهلية لواجهة API التي تستدعيها وتأكد من أن الحساب يستوفيها قبل تغيير أي بيانات اعتماد.
الأخطاء الشائعة
- افتراض أن التكامل تعطل بسبب نشر جديد. فالإذن الذي أُزيل من إعدادات النشاط التجاري يُنتج هذا الرمز دون أي تغيير في الشيفرة.
- إعادة إنشاء token بينما السبب هو الأهلية. فبيانات الاعتماد لا تجعل الحساب غير المؤهل مؤهلًا.
- تجاهل القائمة المسموح بها في Flows. ففي Flows with Endpoint يُرجع الرقم الخارج عنها الرمز 10 حتى مع اكتمال النطاقات.
تواصل EasyCoexistence مراقبة كل رقم متصل بعد الإعداد، فيظهر الاتصال الذي يفقد صلاحية الوصول في لوحة التحكم بدلًا من أن يتكشف أولًا في صورة رسائل فاشلة الإرسال.
الأسئلة الشائعة
هل الخطأ 10 هو نفسه الخطأ 131005؟
يشتركان في الوصف نفسه في مرجع Meta. الرمز 10 هو رمز Graph API، أما 131005 فيقع ضمن نطاق رموز WhatsApp. ويُفحص كلاهما بالطريقة نفسها.
هل يمكن أن يظهر الخطأ 10 على رقم كان يعمل بالأمس؟
نعم. فوصف Meta يشمل الأذونات التي أُزيلت، لذا يمكن سحب وصول مُنح سابقًا في أي وقت لاحق.
هل يعني الخطأ 10 أن token انتهت صلاحيته؟
لا. انتهاء صلاحية token يظهر بالرمز 190 أو 0. أما الرمز 10 فيعني أن token صالح لكنه يفتقر إلى إذن.
كيف أرى الأذونات الممنوحة؟
استدعِ debug_token أو افتح مصحّح رمز الوصول. وتسرد الخاصية scopes كل إذن موجود على token.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في