خطاف الويب (webhook) phone_number_quality_update
يرسل phone_number_quality_update تغييرات معدل الإرسال وحدود المراسلة لرقم. منذ 2026، لا يحمل تقييم الجودة الأخضر أو الأصفر أو الأحمر رغم اسمه، بل يجب استطلاع التقييم من رقم الهاتف نفسه.
السنة التي تغير فيها محتوى هذا الحقل ولم يعد يحمل تقييم الألوان.
تقييمات الجودة التي يمكن أن يحملها الرقم: الأخضر والأصفر والأحمر، ولا يصل أي منها هنا.
الخطأ الذي يعيده الرقم بعد بدء تطبيق تقييد الجودة.
ما الذي يحتويه خطاف الويب هذا فعلياً؟
معلومات عن معدل الإرسال وحد المراسلة، تصل كقيمة للحدث مع حقول تحمل الحد الحالي.
المحتوى العملي هو أن سعة الرقم تغيرت: انتقل إلى مستوى مراسلة مختلف، أو عُدّل معدل إرساله. من المفيد تسجيل ذلك لأنه يغير ما يستطيع التكامل فعله، ولأن انخفاض المستوى إشارة مبكرة.
أما ما لا يحتويه، رغم اسم الحقل، فهو تقييم الجودة. سيبحث المعالج المبني على توثيق أقدم عن GREEN أو YELLOW أو RED هنا ولن يجد شيئاً، ثم يستنتج أن الجودة لا تتغير.
من أين يأتي تقييم الألوان إذن؟
من قراءة رقم الهاتف مباشرة وفق جدول زمني.
يعيش الحقل quality_rating في كائن رقم الهاتف ضمن واجهة برمجة التطبيقات Graph (API)، ويجب استطلاعه بدلاً من انتظار وصوله. لذلك تحتاج مراقبة الاتصال بصورة صحيحة إلى أداة استطلاع وإلى مستقبِل لخطاف الويب: فكل منهما يحمل معلومات مختلفة، ولا يكفي أي منهما وحده.
ولهذا أيضاً يظل انخفاض الجودة غير مرئي لمعظم عمليات التكامل. لا توجد آلية تدفعه، ولا يعرض تطبيق WhatsApp Business أي إشارة إليه، وبحلول وقت ظهور الخطأ 131048 تكون عمليات الإرسال المتأثرة قد فشلت بالفعل.
الأخطاء الشائعة
- البحث عن GREEN أو YELLOW أو RED في حمولة البيانات. منذ 2026، لم تعد موجودة فيها.
- بناء المراقبة على خطافات الويب وحدها. يجب استطلاع تقييم الجودة.
- تجاهل انخفاض مستوى المراسلة. غالباً ما يكون أول إشارة مرئية إلى وجود مشكلة.
يستطلع EasyCoexistence تقييم الجودة ومستوى المراسلة ومعدل الإرسال لكل رقم متصل، ويسجل كل فحص لتظهر أي بوادر تراجع قبل أن تفشل رسالة.
الأسئلة الشائعة
لماذا سُمّي الحقل بالجودة إذن؟
يسبق هذا التغيير. بقي الاسم بينما تغير المحتوى، ولهذا يربك الأمر كثيراً من المستخدمين.
كم مرة ينبغي استطلاع التقييم؟
بمعدل يكفي لاكتشاف التراجع قبل تحوله إلى تقييد. نحن نستطلع وفق جدول زمني لا عند الطلب.
هل يعرض التطبيق التقييم؟
لا. لا يظهر أي شيء عنه في تطبيق WhatsApp Business على الهاتف.
هل يرتبط الخطأ 131048 بذلك؟
نعم. يبدأ الرقم بإرجاع هذا الخطأ عندما يؤدي التقييم المنخفض إلى فرض التقييد.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في