"Your app is missing required Graph API permissions for Cloud API companion pairing"
تعني هذه الرسالة أن المنصة التي بدأت عملية التسجيل لا تملك أذونات WhatsApp التي تشترطها Meta، وبمستوى الوصول الذي تشترطه، لربط رقم تطبيق WhatsApp Business إلى Cloud API. لا تسمح Meta للنشاط التجاري بمنح الأذونات إلا إذا كانت المنصة تملك Advanced access لها. لا يستطيع النشاط التجاري إصلاح ذلك، فالمنصة هي التي يجب أن تصلحه.
ما يحتاجه الشريك لكل إذن قبل أن يتمكن عملاؤه من منحه عبر Embedded Signup.
الخطأ الذي تعيده استدعاءات واجهة برمجة التطبيقات (API) عند استخدام whatsapp_business_management دون Advanced access على حسابات لا يملكها التطبيق.
whatsapp_business_management و whatsapp_business_messaging، وهما الإذنان اللذان تقول Meta إن تكاملات WhatsApp تحتاج إليهما عموماً.
تشترط Meta أن تكون المنصة Solution Partner أو Tech Provider أصلاً حتى تسجّل مستخدمي تطبيق WhatsApp Business.
ما معنى هذه الرسالة؟
النص الكامل هو: "Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again." لا تدرج مراجع الأخطاء العامة لدى Meta هذه الصياغة بالحرف، لكن كل جزء منها يقابل شيئاً توثقه Meta.
"Your app" هو تطبيق Meta الخاص بالمنصة التي تجري التسجيل، وليس تطبيق WhatsApp Business على الهاتف. لا تعرّف Meta مصطلح companion pairing علناً؛ وبحسب السياق يصف انضمام Cloud API إلى رقم يبقى مسجلاً في تطبيق WhatsApp Business، وهذا هو ترتيب Coexistence. أما أذونات WhatsApp Business "المتقدمة" فتشير إلى Advanced access، وهو المستوى الذي تمنحه Meta عبر App Review.
ما الأذونات المعنية؟
تذكر وثائق الأذونات لدى Meta إذنين تحتاج إليهما تكاملات WhatsApp عموماً. يغطي whatsapp_business_management بيانات الحساب الوصفية والقوالب وأرقام الهاتف والتحليلات وخطاف الويب (webhook) الخاص بالحساب. ويغطي whatsapp_business_messaging إرسال الرسائل واستقبال webhook الرسائل والحالة.
بالنسبة إلى شريك يستخدم عملاؤه تطبيقه، تشترط Meta إجراء App Review والحصول على Advanced access لكل إذن يحتاج إليه التطبيق. وتنص Meta على النتيجة صراحة: من دون Advanced access لإذن ما، لا يستطيع العملاء منحه للتطبيق عبر Embedded Signup. أما الاستدعاءات التي تستخدم whatsapp_business_management على حسابات لا يملكها التطبيق، من دون Advanced access، فتعيد الخطأ 200.
يمكن للمنصة أن تتحقق مما منحه النشاط التجاري فعلاً بفحص رمز الوصول (token) عبر نقطة النهاية (endpoint) debug_token من Meta، التي تسرد الأذونات الممنوحة ضمن scopes في الاستجابة.
ماذا يستطيع النشاط التجاري أن يفعل؟
القليل جداً من جانبه، ولا ينبغي أن يحاول تغيير إعدادات Meta الخاصة به لتجاوز هذا الخطأ. يقع الحل لدى المنصة: عليها أن تكون Tech Provider أو Solution Partner، وهو شرط تذكره Meta لتسجيل مستخدمي تطبيق WhatsApp Business، وأن تحصل على موافقة Advanced access لأذونات WhatsApp.
ما يستطيعه النشاط التجاري هو إبلاغ المنصة بنص الرسالة بالضبط، ثم إعادة المحاولة بعد أن تؤكد المنصة حصولها على الوصول، أو استخدام منصة تملك هذه الصفة أصلاً. إعادة المحاولة بالمسار نفسه على المنصة نفسها قبل ذلك تعطي النتيجة نفسها، ولا تؤثر في تطبيق WhatsApp Business على الهاتف.
الأخطاء الشائعة
- منح أذونات إضافية من إعدادات Meta الخاصة بالنشاط التجاري. الوصول المفقود يخص تطبيق المنصة.
- استضافة أداة ذاتياً على تطبيق مطوّر دون App Review. من دون Advanced access لا تستطيع الأنشطة التجارية منح الأذونات المطلوبة.
- إعادة المحاولة مراراً على المنصة نفسها. لا تتغير النتيجة إلا إذا تغيّر وصول تلك المنصة.
EasyCoexistence هي Tech Provider مستقلة لدى Meta، ولها تطبيق Meta خاص بها، وتشغّل Embedded Signup v4 لميزة Coexistence، فتربط الأنشطة التجارية أرقامها عبر منصة تملك أصلاً الوصول الذي تشترطه Meta.
الأسئلة الشائعة
هل هناك خلل في تطبيق WhatsApp Business لدي؟
لا. تشير الرسالة إلى تطبيق Meta الخاص بالمنصة، وليس إلى التطبيق على هاتفك، وهو يواصل العمل.
هل أستطيع منح الإذن بنفسي؟
لا تظهر لك للمنح إلا الأذونات التي تملك المنصة Advanced access لها. يجب أولاً اعتماد الوصول المفقود للمنصة.
كيف تحصل المنصة على Advanced access؟
عبر Meta App Review لكل إذن يحتاج إليه تطبيقها، بصفتها شريكاً يستخدم عملاؤه التطبيق.
هل يحتاج النشاط التجاري إلى App Review؟
لا. تقول Meta إن المطوّر المباشر الذي يصل إلى بيانات نشاطه التجاري فقط لا يحتاج إلى App Review ولا إلى Advanced access.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في