خطأ WhatsApp 4: بلغ التطبيق حد معدل استدعاءات API
يعني رمز الخطأ 4 أن التطبيق بلغ حد معدل استدعاءات واجهة برمجة التطبيقات (API). وصف Meta له: «وصل التطبيق إلى حد معدل استدعاءات API». يحسب الحد الاستدعاءات التي يجريها التطبيق خلال ساعة متحركة، لا الرسائل المرسلة من رقم. راجع الاستهلاك في لوحة تحكم التطبيق، وانتظر، ثم قلل عدد مرات الاستدعاء.
رمز Meta للوصف: «وصل التطبيق إلى حد معدل استدعاءات API».
عدد الاستدعاءات التي يحق للتطبيق إجراؤها في ساعة واحدة وفق Graph API Platform Rate Limits.
الاسم الذي يطلقه دليل معالجة أخطاء Graph API على الرمز 4.
ماذا يعني رمز خطأ WhatsApp رقم 4؟
يعني أن تطبيقك أجرى استدعاءات كثيرة جدًا في النافذة الحالية، وأن أي استدعاء آخر سيُرفض إلى أن ينخفض العدد.
تدرج Meta الرمز 4 ضمن أخطاء التقييد، ونص تفاصيله: «وصل التطبيق إلى حد معدل استدعاءات API». ويسميه دليل معالجة أخطاء Graph API باسم API Too Many Calls ويصفه بأنه مشكلة تقييد مؤقتة.
يجاور هذا الرمز رمزَي تقييد آخرين يسهل الخلط بينهما وبينه. الرمز 80007 يعني بلوغ حساب WhatsApp Business حد المعدل. والرمز 130429 يخص معدل تمرير الرسائل في Cloud API. الرمز 4 ليس أيًّا منهما: إنه ميزانية الاستدعاءات الخاصة بالتطبيق نفسه.
كيف يُحسب حد الاستدعاءات للتطبيق؟
بالنسبة إلى الطلبات التي تُنفذ برمز الوصول (token) الخاص بالتطبيق، يقدم دليل تحديد المعدل في Graph API من Meta معادلة: عدد الاستدعاءات خلال ساعة يساوي 200 مضروبًا في عدد المستخدمين.
يستند عدد المستخدمين إلى المستخدمين النشطين الفريدين يوميًا للتطبيق، مع اعتماد الأرقام الأسبوعية والشهرية عندما ينخفض الاستخدام اليومي. الحد مفروض على التطبيق كله لا على كل مستخدم، لذا قد يستهلك بضعة مستخدمين نشطين معظمه.
ويذكر الدليل أيضًا أن الاستهلاك يظهر في لوحة تحكم التطبيق، وبعد عدد كافٍ من الاستدعاءات يظهر في الرأس X-App-Usage ضمن الاستجابات. هذا الرأس هو وسيلتك لرؤية اقتراب الحد قبل أن يصلك الخطأ 4.
ماذا تفعل بعد الخطأ 4؟
توقف عن الاستدعاء لفترة، ثم قلل استدعاءاتك لاحقًا.
دليل تحديد المعدل لدى Meta صريح في الجزء الأول: عند بلوغ الحد، أوقف استدعاءات API، لأن الاستمرار يزيد عدد الاستدعاءات ويطيل المدة التي تسبق نجاح الاستدعاءات من جديد.
الجزء الثاني يتعلق بالتصميم. وزّع الطلبات بالتساوي بدل إرسالها دفعات، وصفِّ الاستجابات حتى يعيد استدعاء واحد ما تحتاجه، وتجنب الاستدعاءات التي تجلب بيانات متداخلة. الاستطلاع المتكرر هو السبب المعتاد: تكامل يسأل عن حالة الحساب نفسها كل بضع ثوانٍ ينفق ميزانيته على إجابات يملكها أصلًا.
الأخطاء الشائعة
- إعادة المحاولة في حلقة. كل استدعاء إضافي يزيد العدد ويبعّد التعافي.
- اعتباره حد إرسال. الرمز 4 يحسب استدعاءات التطبيق، أما معدل تمرير الرسائل فرمزه 130429.
- الاستعلام المتكرر عن نقاط نهاية (endpoint) الحالة بفاصل زمني قصير. قراءة بيانات لم تتغير مرارًا تستنزف الميزانية الساعية.
تراقب EasyCoexistence كل رقم متصل على مدار الساعة (24/7) من جانبها، فلا يلزمك بناء فحص صحة الاتصال كحلقة استطلاع تستهلك ميزانية استدعاءات تطبيقك.
الأسئلة الشائعة
هل يتطابق الخطأ 4 مع الخطأ 130429 في المعنى؟
لا. الرمز 130429 يخص معدل تمرير الرسائل لرقم واحد. أما الخطأ 4 فيخص عدد استدعاءات API التي أجراها تطبيقك.
كم يدوم الخطأ 4؟
حتى ينخفض عدد الاستدعاءات في النافذة المتحركة البالغة ساعة واحدة عن الحد. والاستدعاء خلال هذه المدة يطيلها.
أين أرى مدى اقتراب تطبيقي من الحد؟
في قسم حد معدل الطلبات للتطبيق داخل لوحة تحكم التطبيق، وفي الرأس X-App-Usage الذي تعيده الاستجابات.
هل يتطابق الخطأ 4 مع الخطأ 80007 في المعنى؟
لا. تستخدم Meta الرمز 80007 عندما يبلغ حساب WhatsApp Business حد المعدل، بينما يحسب الخطأ 4 استدعاءات التطبيق نفسه.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في