أخطاء رسائل واجهة برمجة تطبيقات واتساب (WhatsApp Business API)

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

فيما يلي شرح لأكثر رموز أخطاء واجهة برمجة تطبيقات واتساب شيوعًا وكيفية التعامل معها:

1. 131049 — تم حظر الرسالة لحماية النظام

الرسالة:
"لم يتم تسليم هذه الرسالة حفاظًا على تفاعل صحي في النظام."

السبب:
واتساب يحد من الإرسال لحماية المستخدمين من الرسائل غير المرغوب فيها أو منخفضة الجودة. يحدث ذلك غالبًا عند الإرسال لمستخدمين لم يمنحوا موافقة مسبقة (Opt-in) أو عند وجود معدل مرتفع من الحظر/التبليغ.

الحل:

• أرسل الرسائل فقط للمستخدمين الذين منحوا موافقتهم بشكل صريح.

• حسّن جودة الرسائل ووضوحها وشخصنتها.

• تجنّب الرسائل الدعائية العشوائية أو الإرسال الكثيف.

2. 131047 — انتهاء نافذة إعادة التفاعل

الرسالة:
"فشل إرسال الرسالة لأن أكثر من 24 ساعة مضت منذ آخر رد من العميل على هذا الرقم."

السبب:
واتساب يفرض نافذة رعاية عملاء مدتها 24 ساعة. أي رسالة خارج هذه النافذة يجب أن تستخدم قالبًا معتمدًا مسبقًا.

الحل:

• استخدم قالب رسالة معتمد لإعادة التفاعل مع العميل.

• تأكد من أن العميل يرد خلال 24 ساعة إذا كنت تخطط لاستخدام رسائل الجلسة.

3. 131042 — قيود متعلقة بالدفع

الرسالة:
"فشل إرسال الرسالة بسبب وجود خطأ أو أكثر مرتبط بوسيلة الدفع الخاصة بك."

السبب:
حساب واتساب للأعمال يواجه مشاكل في الفوترة أو الدفع ضمن Meta Business Manager.

الحل:

• سجّل الدخول إلى Meta Business Manager وتحقق من إعدادات الدفع.

• قم بتسوية أي فواتير أو مشكلات دفع معلّقة.

4. 131048 — تجاوز حد الرسائل (معدل سبام)

الرسالة:
"فشل إرسال الرسالة بسبب وجود قيود على عدد الرسائل المسموح إرسالها من هذا الرقم."

السبب:
رقم الهاتف الخاص بالعمل تجاوز الحدود الآمنة للإرسال نتيجة حظر أو وسم رسائل سابقة كرسائل مزعجة (Spam).

الحل:

• قلل من وتيرة الإرسال.

• حسّن عمليات الحصول على موافقة (Opt-in).

• راقب جودة القوالب في WhatsApp Business Manager.

5. 130472 — المستخدم ضمن تجربة من طرف Meta

الرسالة:
"فشل إرسال الرسالة لأن رقم هاتف هذا المستخدم ضمن تجربة من طرف Meta."

السبب:
الرقم خاص بالمستخدم وهو ضمن تجربة مؤقتة على جانب Meta، ولا يمكنه استقبال رسائل API.

الحل:
لا حاجة لأي إجراء. تجاهل هذا الرقم مؤقتًا أو حاول لاحقًا.

6. 131000 — خطأ داخلي

الرسالة:
"حدث خطأ ما."

السبب:
خطأ داخلي عام صادر من خوادم واتساب.

الحل:

• أعد المحاولة بعد بضع دقائق.

• إذا استمرت المشكلة، تواصل مع دعم eGrow للتحقيق.

7. 131053 — خطأ في رفع الوسائط

الرسالة:
يظهر هذا الرمز مع عدة حالات مرتبطة بالوسائط. من أبرز الأسباب:

• نوع ملف غير صحيح (MIME) مثل: image/webp أو image/jpg.

• صيغة غير مدعومة (مثلاً: text/plain لصورة).

• حجم الملف يتجاوز الحد الأقصى (5 ميغابايت).

• ملف فارغ أو تالف.

الحل:

• استخدم صيغ الصور المدعومة: image/png, image/jpeg.

• استخدم صيغ الصوت المدعومة: audio/ogg, audio/amr.

• اجعل حجم الملفات أقل من 5 ميغابايت.

• استخدم نظام الألوان RGB للصور.

• تحقق من سلامة الملف قبل رفعه.

8. تم قفل حساب الأعمال

الرسالة:
"تعذر تسليم الرسالة. تم قفل حساب الأعمال."

السبب:
تم تقييد حساب واتساب للأعمال بسبب انتهاكات للسياسات أو مشكلات في التحقق.

الحل:

• سجّل الدخول إلى WhatsApp Business Manager.

• تحقق من الإشعارات أو القيود.

• تواصل مع دعم Meta Business لحل المشكلة.

9. تعذر تسليم الرسالة

الرسالة:
"تعذر تسليم الرسالة. قد يكون المستلم قد حظرك أو حذف واتساب."

السبب:
المستخدم لم يعد متاحًا عبر واتساب.

الحل:

• تجاهل الرقم في المراسلات المستقبلية.

• نظّف وتحقق من قوائم جهات الاتصال بشكل دوري.

أفضل الممارسات لتجنب الأخطاء

• استخدم القوالب المعتمدة فقط عند الحاجة.

• تأكد من حصول جميع المستخدمين على خيار الاشتراك (Opt-in) قبل المراسلة.

• اضغط وحقق من جميع ملفات الوسائط قبل الإرسال.

• تجنّب الوصول البارد (Cold Outreach) أو الحملات الدعائية العشوائية.

• راقب أداء القوالب وصحة الحساب من خلال لوحة تحكم Meta.