واتساب API لا يستقبل الرسائل: تسعة أسباب بالترتيب، والعَرَض الذي يدل على كل واحد
في هذه الصفحة 4
الإجابة المختصرة
افصل أولًا بين الإرسال والاستقبال بإرسال رسالة اختبار والرد عليها من هاتفك. إن كان الاستقبال وحده صامتًا فالسبب الأرجح اشتراك الويب هوك أو حقل «messages» الناقص، ثم رقم ما زال على تطبيق واتساب بلا وضع تعايش، ثم رقم اختبار، ثم رمز منتهٍ. وإعادة ربط الرقم من المنصة تصلح الثلاثة الأولى في دقيقة.
الإجابة المختصرة
افصل أولًا بين الإرسال والاستقبال بإرسال رسالة اختبار والرد عليها من هاتفك. إن كان الاستقبال وحده صامتًا فالسبب الأرجح اشتراك الويب هوك أو حقل «messages» الناقص، ثم رقم ما زال على تطبيق واتساب بلا وضع تعايش، ثم رقم اختبار، ثم رمز منتهٍ. وإعادة ربط الرقم من المنصة تصلح الثلاثة الأولى في دقيقة.
يُسأل عنها أيضًا: «الواتساب api مش بيستقبل رسايل» · «الويب هوك ما يوصل شي» · «ليش ما توصلني رسائل العملاء على المنصة» · «whatsapp api not receiving messages»
قبل أي شيء: حدد أي الاتجاهين معطّل
الإرسال والاستقبال مساران مختلفان عند ميتا. الإرسال طلب تصنعه أنت إلى خوادمهم؛ الاستقبال حدث يصنعونه هم إلى خادمك عبر «ويب هوك». فأرسل رسالة اختبار من المنصة إلى رقمك، ثم رد عليها من هاتفك. إن وصلت الأولى ولم تصل الثانية فالعطل في الاستقبال وحده، وهذه القائمة له. وإن لم تصل الأولى أصلًا فابدأ من السبب الثاني والخامس.
الأسباب بالترتيب الذي نراه فعلًا
- الويب هوك غير مشترك، أو مشترك بلا حقل «messages»
أكثر سبب على الإطلاق. الاشتراك في تطبيق ميتا يحتاج تحققًا أوليًّا ثم اختيار الحقول، وحقل الرسائل يُنسى أو يُلغى بعد تعديل. الأعراض: الإرسال يعمل، والاستقبال صامت تمامًا، ولا خطأ في أي سجل — لأن ميتا لا ترسل ما لم يُطلب. الإصلاح: إعادة ربط الرقم من المنصة تعيد الاشتراك بحقوله، أو راجع الحقول في إعدادات التطبيق.
- الرقم ما زال على تطبيق واتساب
رقم مسجَّل على التطبيق لا يرسل أحداثه إلى الواجهة. إما نقله كاملًا — بحذفه من التطبيق ثم تسجيله على الـAPI — أو تفعيل وضع التعايش فيعمل الاثنان ويصل كل شيء للطرفين. وفي التعايش تبقى المزامنة الأولى لجهات الاتصال والسجل متاحة أربعًا وعشرين ساعة بعد الربط فقط.
- رقم اختبار لا رقم إنتاج
رقم الاختبار الذي تمنحه ميتا يستقبل من الأرقام المضافة إلى قائمته فقط. عميل حقيقي يراسله لا يصل. حين تنتقل إلى رقمك الحقيقي ينتهي هذا القيد.
- رمز الوصول انتهى أو فقد صلاحيته
رمز مؤقت من واجهة المطورين يعيش ساعات؛ الربط الدائم يكون بمستخدم نظام ورمز لا ينتهي. والرمز الذي فقد صلاحية «whatsapp_business_messaging» بعد تغيير في الحساب يفشل الإرسال معه بخطأ واضح، وقد يتوقف التحقق من الويب هوك. الإصلاح: إعادة الربط من المنصة تولّد رمزًا صالحًا.
- الرقم غير مسجَّل بعد، أو معلّق للتحقق
رقم أُضيف ولم يُكمل تسجيله — رمز التحقق بالرسالة أو الاتصال لم يُدخل — أو حساب أعمال معلّق لتحقق ميتا. حالة الرقم في صفحته على المنصة تقول ذلك نصًّا.
- العميل خارج النافذة وقالبك مرفوض — هذا عطل إرسال لا استقبال
حين تبدأ أنت المحادثة خارج نافذة الأربع والعشرين ساعة تحتاج قالبًا معتمدًا. قالب مرفوض أو معلّق يُسقط رسالتك، ويبدو الأمر كأن العميل «لا يرد». الاستقبال سليم هنا؛ ما يحتاج إصلاحًا هو القالب.
- الرقم نفسه مربوط في منصتين
حساب واتساب للأعمال الواحد يرسل أحداثه إلى تطبيق ميتا واحد. إن ربطت الرقم في منصة ثانية بعد الأولى فقد انتقل الويب هوك إليها والأولى صمتت. اختر منصة واحدة للرقم.
- حظر من العميل، أو ملف ترفضه ميتا
عميل واحد لا يصل وغيره يصل: حظرك، أو أرسل ملفًا بحجم أو نوع لا تقبله ميتا فسقطت رسالته وحدها. لا عطل عام هنا.
- خادم الاستقبال يرد بخطأ فتتراكم إعادة المحاولة
ميتا تعيد المحاولة حين يرد الخادم بخطأ، وتؤجل ثم تتوقف. على منصتنا يُراقَب باب الويب هوك ويُرفض ما ليس من ميتا بتوقيعه، فالرسائل الحقيقية تدخل والمزيف يُصدّ — ونعرف الفرق من سجل الوصول لا من سجل الأخطاء.
العَرَض يدلّ على السبب
| ما تراه | السبب الأرجح | أين تصلحه |
|---|---|---|
| الإرسال يعمل، الاستقبال صامت، لا أخطاء | اشتراك الويب هوك أو حقل الرسائل | إعادة ربط الرقم من المنصة |
| الرسائل تصل الهاتف لا المنصة | الرقم على التطبيق بلا تعايش | تفعيل التعايش أو نقل الرقم |
| يصل من أرقام بعينها فقط | رقم اختبار | الانتقال إلى الرقم الحقيقي |
| الإرسال يفشل بخطأ صلاحية | الرمز | إعادة الربط |
| العميل «لا يرد» على رسالة بدأتها | قالب مرفوض خارج النافذة | صفحة القوالب |
| صمت بدأ يوم ربط منصة أخرى | الرقم في منصتين | اختيار منصة واحدة |
الأسئلة الشائعة
الرسائل تصل تطبيق واتساب على الهاتف ولا تصل المنصة — لماذا؟
لأن الرقم ما زال مسجَّلًا على التطبيق لا على الواجهة. الرقم الواحد يكون في مكان واحد: إما تنقله كاملًا إلى الـAPI، أو تفعّل وضع التعايش فيعمل الاثنان معًا وتصل الرسائل للطرفين. قبل ذلك، ما يصل التطبيق لا يصل الواجهة.
أرسل من المنصة بنجاح لكن لا يصلني رد العميل
الإرسال يمر بمسار والاستقبال بمسار آخر هو الويب هوك. إن نجح الإرسال وفشل الاستقبال فالخلل في اشتراك الويب هوك أو حقوله — تحديدًا حقل «messages» — لا في الرقم ولا في الرمز. يُصلَح من إعدادات التطبيق في ميتا أو بإعادة ربط الرقم من المنصة.
يصل بعض العملاء ولا يصل بعضهم
ثلاثة أسباب معتادة: عميل حظر رقمك، أو عميل على نسخة قديمة جدًّا من واتساب، أو رسالة تحمل ملفًا بحجم أو نوع لا تقبله ميتا فتسقط وحدها. راجع سجل الويب هوك للرقم المعيّن قبل أن تفترض عطلًا عامًّا.
هل يوقف انخفاض تقييم الجودة الاستقبال؟
لا. تقييم الجودة وحدود الإرسال تقيّد ما ترسله أنت من رسائل تبدأها؛ ما يبدأه العميل يصلك دائمًا. إن توقف الاستقبال فالسبب في مكان آخر من هذه القائمة.
كيف أعرف أن الرقم متصل الآن؟
من صفحة الرقم في المنصة: حالة الاتصال وآخر تحديث. وحين ينقطع الربط تصلك رسالة تنبيه على واتساب أو إشعار في التطبيق تفتح صفحة الإصلاح مباشرة — لا تكتشفه من صمت الصندوق.
هل يعيد ميتا إرسال ما فات أثناء العطل؟
يعيد المحاولة لفترة إن كان الخادم قد رد بخطأ، ولا يعيدها إن لم يكن الويب هوك مشتركًا أصلًا. ولذلك الاشتراك والحقول هما أول ما يُفحص، لا آخره.
اقرأ بعدها
جرّب الوكيل قبل أن تدفع شيئًا
الوكيل الذي يرد على عملائك هو نفسه الذي يرد عليك الآن: اسأله من زر الدردشة هنا أو على واتساب. وحسابك مجاني بلا بطاقة ائتمان، والتجربة المجانية على رقمك أو صفحتك تُفعَّل بعد التواصل مع الإدارة على واتساب خدمة العملاء.