خطأ WhatsApp 131005: تم رفض الوصول والإذن مفقود
يعني الخطأ 131005 أن رمز الوصول (token) يفتقر إلى إذن تتطلبه نقطة النهاية (endpoint) في واجهة برمجة التطبيقات (API) الخاصة بـ WhatsApp، لأنه لم يُمنح قط أو أُزيل لاحقًا. وصف Meta له: "Permission is either not granted or has been removed." الحل: افحص الـ token بأداة تصحيح رمز الوصول (access token debugger)، ثم امنح الإذن المفقود أو انتقل إلى token يملكه.
رمز Meta للوصف "Permission is either not granted or has been removed."
الإذن المطلوب لإرسال أي نوع من الرسائل إلى مستخدمي WhatsApp
business_management، whatsapp_business_management، whatsapp_business_messaging: تُمنح عند إنشاء token لمستخدم النظام
ماذا يعني خطأ WhatsApp 131005؟
يعني أن الـ token مقبول بوصفه حقيقيًا، لكنه لا يحمل الإذن الذي يتحقق منه الـ endpoint.
يورد مرجع Cloud API من Meta الرمز 131005 مع نص التفاصيل "Permission is either not granted or has been removed." ويحمل خطأ Graph API رقم 10 الجملة نفسها. الفرق في النطاق فقط: الرمز 10 رمز عام في Graph API، أما 131005 فيقع بين رموز WhatsApp التي تبدأ بـ 131.
ولأن الكلمات واحدة، فالتشخيص واحد. علاج Meta للحالتين هو استخدام أداة تصحيح رمز الوصول والتأكد من أن التطبيق يملك الأذونات التي يتطلبها الـ endpoint.
ما الإذن الذي يغيب عادةً؟
عادةً أحد إذنَي WhatsApp، ويعتمد أيهما على ما يفعله الطلب.
يقسّمهما دليل الأذونات من Meta بحسب المهمة. whatsapp_business_messaging مطلوب لإرسال أي نوع من الرسائل، ولاستقبال خطاف الويب (webhook) الخاص بالرسائل والحالة. whatsapp_business_management مطلوب للبيانات التعريفية للحساب، وإدارة القوالب، وعرض قائمة الأرقام، والتحليلات، وwebhook الحساب.
قد يستطيع token أُنشئ بإذن الإدارة وحده قراءة الحساب وعرض القوالب، ثم يفشل لحظة محاولة الإرسال. وعند إنشاء token لمستخدم النظام، يطلب دليل رمز الوصول من Meta تعيين الأذونات business_management، whatsapp_business_management، whatsapp_business_messaging معًا.
كيف تصلح الخطأ 131005؟
اقرأ الـ token أولًا، ثم غيّر ما هو مفقود فقط.
استدعِ الـ endpoint المسمى debug_token، أو الصق الـ token في أداة تصحيح رمز الوصول. تسرد الخاصية scopes كل إذن ممنوح. قارنها بصفحة المرجع للـ endpoint الذي فشل.
إذا غاب إذن، فأنشئ token جديدًا يتضمنه، أو اطلب من مالك النشاط التجاري منحه مجددًا إذا كان الـ token قادمًا من تدفق شريك. وإذا كانت كل الأذونات موجودة واستمر الخطأ، فتحقق من أن مستخدم النظام صاحب الـ token مُنح حق الوصول إلى حساب WhatsApp Business بعينه، فقد يكون الـ token كامل النطاقات ومع ذلك غير مُسند إلى ذلك الأصل.
الأخطاء الشائعة
- افتراض أن الـ token انتهت صلاحيته. الانتهاء يعيد 190 أو 0. هذا الرمز يعني أن الـ token يعمل لكنه يفتقر إلى إذن.
- إنشاء token بإذن الإدارة فقط ثم استخدامه للإرسال. whatsapp_business_messaging هو الإذن الذي يحتاجه الإرسال.
- فحص النطاقات ثم التوقف عندها. يحتاج مستخدم النظام أيضًا إلى حق وصول ممنوح إلى حساب WhatsApp Business بعينه.
يضم EasyCoexistence كل رقم عبر Embedded Signup من Meta، حيث يمنح النشاط التجاري التطبيق أذوناته، ويعرض موصل MCP الخاص به سلامة الرقم ليتحقق المساعد قبل الإرسال.
الأسئلة الشائعة
هل الخطأ 131005 هو نفسه الخطأ 10؟
يحملان الوصف نفسه في مرجع Meta، لكن نطاق Graph API هو الذي ينتمي إليه 10، ونطاق WhatsApp هو الذي ينتمي إليه 131005.
هل يمكن إزالة إذن بعد الإعداد؟
نعم. يشمل وصف Meta صراحةً الأذونات التي أُزيلت، لا تلك التي لم تُمنح قط فحسب.
هل يؤثر الخطأ 131005 على تطبيق WhatsApp Business في الهاتف؟
لا. يتعلق الأمر بـ token الـ API فقط، ويواصل التطبيق في الهاتف العمل كما كان.
هل أعيد المحاولة بعد الخطأ 131005؟
لا. إعادة المحاولة بالـ token نفسه تعطي النتيجة نفسها. أصلح الإذن أولًا.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في