واجهة WhatsApp API متصلة لكن الرسائل لا تصل: قائمة فحص

قد تكون شارة الاتصال الخضراء مضللة لأن ربط بيانات الاعتماد وتفعيل رقم الهاتف خطوتان منفصلتان. اتبع القائمة من تسجيل الرقم حتى اختبار حقيقي في الاتجاهين. لا تفصل القناة وتعيد ربطها مرارًا، فقد يسبب ذلك قيودًا إضافية من دون إصلاح الطبقة المعطلة.

آخر تحديث: 13 يوليو 2026

تأكد أن حالة رقم الهاتف لدى Meta هي CONNECTED

تحقق من الدفع واشتراك webhook في حساب WABA الذي يملك الرقم فعلًا

اختبر الاستقبال والإرسال كلًا على حدة من هاتف خارجي واحد

الإجابة القصيرة

اعتبر حالة «متصل» الخطوة الأولى وليست فحص الصحة النهائي. يجب أن يكون الرقم العامل مسجلًا بحالة CONNECTED لدى Meta، وقابلًا للفوترة في WABA المالكة، ومشتركًا في webhook الصحيح، ومفوّضًا للإرسال، ومثبتًا باختبار في الاتجاهين.

لماذا تبحث الفرق عن هذا

لماذا يظهر الرقم متصلًا لكنه يبقى غير نشط؟

تؤكد شارة الاتصال أن marv.Inbox حفظ رابطًا صالحًا إلى حساب WhatsApp Business. لكن على Meta أيضًا تسجيل رقم الهاتف في شبكة Cloud API. إذا بقي التسجيل PENDING أو فشل، فقد تبدو القناة متصلة بينما لا تصل رسائل العملاء. في marv.Inbox افتح القنوات ثم WhatsApp وشغّل فحص الاتصال. إذا ظهر تنبيه برتقالي بأن الرقم غير نشط لدى Meta، أصلح السبب ثم أعد محاولة التسجيل بدل إعادة ربط القناة.

▲التسجيل: يجب أن تكون حالة رقم الهاتف لدى Meta هي CONNECTED، وليس حالة التكامل فقط.
▲الدفع: يجب أن تكون وسيلة الدفع في حساب WABA نفسه الذي يملك الرقم.
▲الاستقبال: يجب أن يكون تطبيق Meta مشتركًا في webhook الخاص بالحساب وفي الحقل messages.

1. هل اكتمل تسجيل رقم الهاتف وهل وسيلة دفع Meta مطلوبة؟

بالنسبة لرقم يعمل عبر Cloud API فقط، يجب اكتمال التسجيل قبل وصول الرسائل الواردة. يعني التنبيه البرتقالي في marv.Inbox أن الرابط حُفظ لكن Meta لم تفعّل الرقم. شغّل فحص الاتصال أولًا. بعد إصلاح السبب اختر إعادة محاولة التسجيل. لا حاجة إلى ربط القناة من جديد أو طلب رمز تحقق آخر.

قد تطلب Meta وسيلة دفع لإكمال التسجيل أو إرسال فئات رسائل مدفوعة. الفوترة منفصلة لكل WABA وليست موحدة لكل Meta Business. أضف وسيلة الدفع إلى حساب WABA الذي يحتوي الرقم تحديدًا. بطاقة في حساب WABA آخر لن تحل المشكلة، ولا يستطيع marv.Inbox إضافة بطاقة العميل نيابة عنه.

2. هل اشتراك webhook صحيح؟

يتطلب الاستقبال اشتراك تطبيق Meta الخاص بـ marv.Inbox في WABA التابعة للرقم وفي الحقل messages. يتحقق فحص الاتصال في قناة WhatsApp من الاشتراك ويمكنه استكمال الحقول الناقصة ما دامت الصلاحية سارية. وجود عنوان callback يعمل لا يثبت وحده أن WABA مشتركة.

إذا كان الإرسال يعمل والاستقبال لا يعمل، فركّز على تسجيل الرقم وwebhook الخاص بـ WABA. إذا كان الاستقبال يعمل والرد يفشل، فإن webhook يوصل الأحداث بالفعل، لذلك افحص الرسالة الصادرة الفاشلة. لا يُسمح برد نصي حر إلا خلال نافذة خدمة العملاء التي تبلغ 24 ساعة. خارجها يجب استخدام قالب معتمد.

3. لماذا لم يصل رمز التحقق أو فشل نقل المزود؟

إذا لم يصل رمز التحقق، راجع الرقم الدولي كاملًا ورمز الدولة، وتأكد أن الشريحة أو الخط الأرضي يستقبل طريقة SMS أو المكالمة المحددة، وأزل حظر السنترال أو تصفية الرسائل والمكالمات. انتظر مؤقت إعادة الإرسال لدى Meta، لأن الطلبات المتكررة قد تسبب حدًا مؤقتًا. لا ترسل رمز التحقق إلى الدعم أبدًا.

قد يحتاج الرقم المرتبط بمزود WhatsApp آخر إلى مسار نقل بدل إضافته كرقم جديد. أبقِ المزود السابق فعالًا حتى ينجح الاختبار في الاتجاهين، واختر حساب WABA والرقم الحاليين أثناء التسجيل. عطّل التحقق بخطوتين لرقم الهاتف في WhatsApp Manager قبل النقل، لأن رقم PIN قائمًا قد يمنع التسجيل أو النقل. أزل المزود القديم فقط بعد نجاح الاختبار.

4. أين يظهر خطأ Meta وكيف تختبر بأمان؟

في فشل التسجيل افتح القنوات ثم WhatsApp وانسخ السبب المفصل من التنبيه البرتقالي. في فشل رسالة صادرة افتح المحادثة ومرر المؤشر فوق رمز الفشل الأحمر لرؤية رمز Meta والعنوان والتفاصيل. إذا بقي السبب عامًا، أعط الدعم وقت الاختبار ومعرّف WABA ومعرّف رقم الهاتف ليعثروا على استجابة Meta الأصلية. لا تشارك رمز الوصول أو PIN أو رمز التحقق.

ابدأ بهاتف خارجي واحد ورسالة نصية بسيطة. أرسل رسالة واردة ورد خلال 24 ساعة وتأكد من التسليم في المكانين. نفّذ محاولات قليلة فقط ولا تستخدم حملة إنتاجية للاختبار ولا تكرر التسجيل أو الربط. بعد نجاح النص في الاتجاهين، اختبر رسالة وسائط واحدة وقالبًا معتمدًا واحدًا ثم الأتمتة كطبقات منفصلة.

سير العمل

اختبار آمن للاتصال خلال عشر دقائق

من القنوات ثم WhatsApp شغّل فحص الاتصال وسجّل نتيجة التسجيل وwebhook والتفويض. انسخ سبب Meta المفصل قبل تغيير أي إعداد.

من هاتف شخصي منفصل أرسل رسالة نصية جديدة إلى رقم النشاط. انتظر ظهورها في marv.Inbox ثم رد منها أثناء نافذة خدمة العملاء التي تبلغ 24 ساعة.

تأكد من وصول الرد إلى الهاتف الخارجي. إذا فشل اتجاه واحد فانتقل إلى القسم المطابق. إذا نجح الاتجاهان، اختبر الوسائط والأتمتة كلًا على حدة من دون تغيير اتصال القناة.

ما الذي يجب أن يتضمنه الإعداد الأفضل

حدّد العَرَض قبل تغيير الإعداد

الإرسال يعمل والاستقبال يفشل

تستطيع بيانات الاعتماد استدعاء واجهة الإرسال، لكن تسجيل الرقم أو webhook الوارد غير سليم. افحص حساب WABA والتطبيق والحقل messages.

الاستقبال يعمل والرد يفشل

يعمل webhook الوارد. افحص خطأ الرسالة الصادرة ونافذة 24 ساعة والقالب المعتمد خارجها وصلاحيات الرمز ومعرّف رقم الهاتف.

الاتجاهان لا يعملان

ابدأ بتسجيل الرقم والدفع في WABA وملكية المزود السابق والتفويض. تعديل webhook لن يفعّل رقمًا ما زال PENDING لدى Meta.

أفضل ملاءمة

اجمع هذه المعلومات قبل التواصل مع الدعم

✓معرّف النشاط ومعرّف WABA ومعرّف رقم الهاتف والرقم الظاهر ووضع الاتصال واسم المزود السابق.
✓وقت اختبار وارد واحد واختبار صادر واحد مع المنطقة الزمنية ورقم الهاتف الخارجي المستخدم.
✓رمز خطأ Meta والسبب المفصل الظاهر في الرسالة الفاشلة أو تنبيه التسجيل. احذف رموز الوصول وأكواد التحقق قبل المشاركة.

أسئلة تطرحها الفرق قبل تغيير سير العمل

لماذا يظهر رقم هاتفي متصلًا لكنه يبقى غير نشط؟+

تؤكد حالة متصل رابط الحساب لا تفعيل الرقم. قد يبقى الرقم PENDING لدى Meta إذا فشل التسجيل. شغّل فحص الاتصال وأصلح السبب ثم أعد محاولة التسجيل بدل إعادة الربط.

هل أكملت تسجيل رقم الهاتف؟+

يجب أن تكون حالة رقم الهاتف لدى Meta هي CONNECTED. يعرض marv.Inbox تنبيهًا برتقاليًا بأن الرقم غير نشط لدى Meta إذا لم يكتمل التسجيل.

هل وسيلة دفع Meta مطلوبة؟+

قد تكون مطلوبة للتسجيل وفئات الرسائل المدفوعة. أضفها إلى حساب WABA الذي يملك الرقم تحديدًا. فوترة حساب آخر لا تنطبق عليه.

هل اشتراك webhook صحيح؟+

يجب أن يكون تطبيق Meta الصحيح مشتركًا في WABA المالكة للرقم وفي الحقل messages. شغّل فحص الاتصال، فعنوان callback العامل وحده لا يكفي.

لماذا أستطيع الإرسال ولا أستطيع الاستقبال؟+

قد تعمل بيانات الاعتماد الصادرة بينما يفشل الوارد. افحص تسجيل الرقم واشتراك webhook في WABA والتطبيق والحقول المشترك بها ومعالجة الأحداث.

لماذا أستطيع الاستقبال ولا أستطيع الرد؟+

يعمل webhook الوارد. افحص خطأ الإرسال ونافذة 24 ساعة ومتطلب القالب المعتمد خارجها وصلاحيات الرمز ومعرّف رقم الهاتف.

لماذا لم يصل رمز التحقق؟+

راجع الرقم الدولي وإمكانية استقبال SMS أو المكالمة وأزل حظر السنترال أو التصفية وانتظر مؤقت Meta. قد تسبب الطلبات المتكررة حدًا مؤقتًا.

هل ما زال الرقم متصلًا بمزود آخر؟+

إذا كان كذلك فاستخدم مسار النقل مع WABA الحالية. أبقِ المزود السابق حتى ينجح اختبار الاستقبال والإرسال ثم أزله.

هل منع التحقق بخطوتين نقل الرقم؟+

قد يمنع رقم PIN قائم تسجيل الرقم أو نقله. عطّل التحقق بخطوتين في WhatsApp Manager قبل النقل ثم أعد الحماية المطلوبة بعد اكتماله.

أين أرى رمز خطأ Meta الفعلي؟+

للتسجيل اقرأ السبب في تنبيه قناة WhatsApp. ولرسالة صادرة فاشلة مرر المؤشر فوق رمز الفشل الأحمر لرؤية الرمز والتفاصيل. لا تشارك رموز الوصول أو PIN أو أكواد التحقق.

كيف أختبر الاتصال بأمان؟+

استخدم هاتفًا خارجيًا واحدًا، وأرسل نصًا واردًا، ورد خلال 24 ساعة، وتأكد من التسليم في الاتجاهين. تجنب الحملات وإعادة الربط المتكررة، واختبر الوسائط والقوالب والأتمتة بعد نجاح النص.

اكتشف إن كان هذا المسار مناسبًا لفريقك

ابدأ بجولة المنتج، ثم اطلب عرضًا إذا أردت المساعدة في التوزيع أو الملكية أو الإطلاق.

استكشف التجربة محادثة سريعة عبر واتساب اطلب عرضًا