خطأ WhatsApp Business API: خطأ عام في المستخدم

⚠️ نظرة عامة
عند إرسال رسالة أو اختبار قالب في WhatsApp Business API (WABA)، قد يظهر لك هذا الخطأ:

تشير هذه الرسالة إلى حدوث خطأ أثناء تسليم الرسالة، لكن واجهة Meta API لم تُرجع سببًا محددًا.
إنه خطأ عام أو شامل، غالبًا ما يكون مرتبطًا بحساب WhatsApp الخاص بالمستلم، أو إعدادات القالب، أو توقيت الرسالة.

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

📩 القالب أو الرسالة غير معتمدة
قد يكون القالب الذي تحاول إرساله ما زال قيد المراجعة، مرفوض، أو مؤرشف في مدير WABA الخاص بك.

🚫 المستلم غير متاح أو محظور
قد يكون العميل قد حظر رقمك، حذف تطبيق WhatsApp، أو أن حسابه غير نشط مؤقتًا.

🔢 تنسيق الرقم غير صحيح
رقم هاتف المستلم لا يشمل رمز الدولة الصحيح أو يحتوي على أرقام غير صالحة.

🧾 مشكلة في حالة الحساب أو الجودة
قد يكون حساب WhatsApp Business الخاص بك في حالة مقيدة أو مُعلّمة، مما يؤثر مؤقتًا على تسليم الرسائل.

🔐 مشكلة في الأذونات أو التوكن
قد يكون رمز الوصول (Access Token) الذي تستخدمه منتهي الصلاحية أو لا يمتلك الإذن لإرسال الرسائل من هذا الرقم.

🧰 كيفية إصلاح المشكلة
✅ الخطوة 1: تحقق من حالة WABA والرقم
انتقل إلى Meta Business Manager → حسابات WhatsApp → حالة الحساب.
تأكد من أن الحساب والرقم نشطين (وليس مقيدين أو معطلين).

✅ الخطوة 2: تحقق من نوع الرسالة
إذا كنت ترسل بعد مرور 24 ساعة، استخدم قالب رسالة معتمد بدلاً من رسالة الجلسة.

✅ الخطوة 3: تحقق من اعتماد القالب
انتقل إلى Message Templates → تأكد من أن القالب معتمد وفي حالة نشط.

✅ الخطوة 4: تأكد من رقم المستلم
تأكد من أن رقم الهاتف صالح ويشمل رمز الدولة (مثال: +2126xxxxxxx).

✅ الخطوة 5: تجديد رمز الوصول
إذا كنت تستخدم تكامل API، أنشئ رمز وصول دائم جديد وجرب الإرسال مرة أخرى.

✅ الخطوة 6: جرب رقم اختبار آخر
أرسل نفس الرسالة إلى رقم WhatsApp آخر للتحقق مما إذا كانت المشكلة خاصة بالمستلم فقط.

🛡️ كيفية تجنب هذا الخطأ مستقبلاً

• أرسل دائمًا رسائل القوالب بعد مرور 24 ساعة على عدم الرد.

• حافظ على اعتماد الحساب والقوالب الخاصة بك وأن تكون نشطة.

• جدّد رمز الوصول بشكل دوري وتحقق من إعدادات الـ Webhook.

• تجنب إرسال الرسائل إلى أرقام لم توافق على الاستلام.

• راقب تقييم جودة WABA من قسم نظرة عامة على الحساب.

🧾 المراجع
🔗 Meta Business Help Center – Message Sending Errors
🔗 WhatsApp Business Platform Error Codes Documentation
🔗 WABA Message Template Guidelines