خطأ «انتهت صلاحية رمز التفويض» بعد تسجيل Coexistence
عند انتهاء Embedded Signup من Meta، تسلّم المنصة التي أطلقته رمزًا قصير العمر يجب استبداله برمز الوصول (token) خلال 30 ثانية. إذا تم الاستبدال لاحقًا، أو استُخدم رمز من محاولة سابقة، ترد Meta بأن رمز التفويض انتهت صلاحيته. أما تشغيل التدفق من جديد فيُنتج رمزًا جديدًا.
مدة الصلاحية التي تحددها Meta لرمز الاستبدال الذي يعيده Embedded Signup.
تقول Meta إن استبدال الرمز يجب أن يكون طلبًا من خادم إلى خادم، وليس من جهة العميل أبدًا.
المدة المتاحة للمنصة بعد الإعداد لمزامنة سجل رقم Coexistence قبل أن يلزم إعادة التدفق.
ما الرمز الذي انتهت صلاحيته؟
عندما يُكمل النشاط التجاري Embedded Signup، تعيد Meta معرّفات الأصول ورمز استبدال إلى نافذة المتصفح التي فتحت النافذة المنبثقة. ثم ترسل المنصة هذا الرمز إلى خادمها، الذي يستدعي نقطة النهاية (endpoint) المسماة oauth access_token مع معرّف التطبيق والسر الخاص به، ليستبدله بـ token خاص بالنشاط التجاري.
دليل التنفيذ من Meta صريح بشأن التوقيت: مدة صلاحية رمز الاستبدال 30 ثانية، لذا يجب أن تكون المنصة قادرة على استبداله قبل انتهائها. أي محاولة استبدال بعد ذلك تُرفض، وهذا الرفض هو ما تعبّر عنه عبارة «انتهت صلاحية رمز التفويض هذا». لم يرتكب النشاط التجاري خطأً بإنهاء النافذة ببطء؛ فالمؤقت يبدأ لحظة إعادة الرمز.
لماذا يحدث ذلك عند إنهاء النافذة متأخرًا أو مرتين؟
قد تؤخر عدة حالات الاستبدال إلى ما بعد هذا الحد.
تُرك تبويب المتصفح في الخلفية أو دخل الحاسوب المحمول في السكون عند انتهاء التدفق، فوصل الرمز إلى خادم المنصة بعد إصداره بوقت طويل. أو وضع خادم المنصة الاستبدال في الطابور خلف أعمال أخرى بدل تنفيذه فورًا. أو فتح الشخص التدفق مرتين وأكمل الاثنين، فاستبدلت المنصة رمز النافذة الأولى بعد اكتمال الثانية.
وفي الاختبار توجد حالة رابعة: نسخ الرمز من وحدة تحكم المتصفح واستبداله يدويًا عبر cURL أو Postman. ينبّه دليل Meta إلى ذلك تحديدًا ويوصي بتجهيز طلب الاستبدال قبل البدء.
كيف تُكمل الاتصال؟
شغّل التدفق من جديد من البداية في نافذة واحدة، واتركه ينتهي وصفحة المنصة في المقدمة. كل إكمال يعيد رمزًا جديدًا، وكل ما تحتاجه المنصة هو استبدال سريع لهذا الرمز.
بالنسبة إلى رقم Coexistence، تصرّف بسرعة. تحوّل Meta حساب WhatsApp Business عندما يُكمل النشاط التجاري التدفق، وبعد أن تُدرج المنصة العميل تكون أمامها 24 ساعة لمزامنة سجل الرسائل؛ وبعد ذلك يجب إلغاء ربط النشاط التجاري وإكمال التدفق مرة أخرى.
من جهة المنصة، الحل الدائم هو استبدال الرمز على الخادم لحظة وصوله، قبل أي خطوة إعداد أخرى.
الأخطاء الشائعة
- إعادة محاولة استبدال token بالرمز نفسه. لقد انتهت صلاحيته بعد 30 ثانية ولن يعود.
- تشغيل التسجيل في نافذتين في وقت واحد. لا يُعتد إلا برمز المحاولة التي يجري استبدالها.
- استبدال الرمز من المتصفح. تشترط Meta أن يكون الاستبدال طلبًا من خادم إلى خادم باستخدام السر الخاص بالتطبيق.
تستبدل EasyCoexistence الرمز على خادمها فور أن يعيده Embedded Signup، وتسجّل كل محاولة على الخط الزمني للاتصال، فيظهر الرمز المفقود كحدث مؤرخ لا كفشل غامض.
الأسئلة الشائعة
هل ربط النشاط التجاري الرقم أم لا؟
أكمل النشاط التجاري تدفق Meta، لكن المنصة لم تستطع تحويل الرمز إلى token صالح، فلا يمكنها التصرف في الرقم بعد. تشغيل التدفق من جديد يمنحها رمزًا جديدًا.
هل يمكن جعل الرمز يدوم أطول؟
لا. Meta هي من تحدد مدة الصلاحية بـ 30 ثانية، ولا تستطيع أي منصة تمديدها.
هل يتأثر تطبيق WhatsApp Business؟
لا. يستمر التطبيق في العمل على الهاتف أثناء حل المشكلة.
هل هذا هو نفسه انتهاء صلاحية token؟
لا. هذا هو رمز التسجيل قصير العمر. أما انتهاء صلاحية token على اتصال يعمل فيعيد الخطأ 190.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في