استكشاف أخطاء حملات WhatsApp الشائعة وإصلاحها

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

1. تعذر تسليم الرسالة: رقم غير قابل للتسليم

إذا فشلت رسالة في الحملة وأظهر السجل إخفاق تسليم لجهة اتصال محددة، فمن المرجح أن رقم المستلم يعاني من إحدى هذه المشكلات:

• الرقم غير مسجل في WhatsApp أو أن حساب WhatsApp المرتبط به قد عُطِّل.
• رمز الدولة (+91 للهند وغيره) مفقود أو غير صحيح في قائمة جهات الاتصال لديك.
• يستخدم المستلم نسخة قديمة من WhatsApp لا تستطيع استقبال رسائل Business API.
• لم يقبل المستلم أحدث شروط الخدمة من WhatsApp: يجب عليه فتح WhatsApp وقبول الشروط المحدّثة قبل أن يمكن تسليم الرسائل.

1. 1

   تحقق من تنسيق جهة الاتصال

   في SparkTG → Contacts، افتح جهة الاتصال المتأثرة وتأكد من أن الرقم يتضمن رمز الدولة كاملاً، دون مسافات أو رموز خاصة. مثال: 919876543210 (وليس 09876543210).

2. 2

   أزل الأرقام غير الصالحة من الحملة

   استخدم خيار Validate Numbers قبل إرسال الحملة. ستضع SparkTG علامة على الأرقام غير المسجلة في WhatsApp لتتمكن من استبعادها قبل الإرسال.

3. 3

   اطلب من المستلم تحديث WhatsApp

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

2. رسالة تسويقية محجوبة بسبب قيود الجودة من Meta

تراقب Meta بنشاط جودة رسائل التسويق المرسلة عبر Business API. فإذا كان تقييم جودة قوالبك منخفضاً (عادةً لأن المستلمين يحظرون رسائلك أو يبلغون عنها)، ستقيّد Meta التسليم مؤقتاً وتطلب منك إعادة المحاولة بعد فترة انتظار.

• راجع محتوى قالبك: تأكد من أنه ذو صلة ومخصص ومتوقع من المستلم.
• دقّق قائمة جهات الاتصال: أزل من لم يمنح opt-in صريحاً لتلقي رسائل WhatsApp من نشاطك.
• انتظر انتهاء فترة التهدئة (عادةً 24–48 ساعة) قبل إعادة محاولة الحملة.
• افحص تقييم جودة قالبك في Meta Business Manager → WhatsApp Manager → Message Templates.

3. جهة اتصال غير قابلة للوصول: قيد تجربة Meta

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

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

4. الحملة متوقفة: بلوغ حد المراسلة

يفرض WhatsApp حدوداً يومية متدرجة للمراسلة على جميع حسابات Business API: 1,000 → 10,000 → 100,000 جهة اتصال فريدة كل 24 ساعة. فإذا تجاوزت حملتك حد مستواك الحالي، ستتوقف الرسائل عن الإرسال حتى تُعاد نافذة الـ 24 ساعة.

1. 1

   افحص مستوى المراسلة الحالي

   SparkTG Dashboard → WhatsApp → Channel Status. يعرض هذا حدك الحالي واستخدام نافذة الـ 24 ساعة المتحركة.

2. 2

   انتظر إعادة ضبط النافذة

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

3. 3

   ارفع مستوى المراسلة مع مرور الوقت

   ترقّي Meta مستواك تلقائياً بناءً على إرسال منتظم بحجم مرتفع وتقييم جودة جيد. لا يوجد طلب ترقية يدوي: حافظ على معدلات تسليم عالية ومعدلات حظر منخفضة للارتقاء بين المستويات بسرعة أكبر.

5. حساب محظور أو مقيَّد من Meta

إذا وُسم حساب WhatsApp Business Account (WABA) الخاص بك بسبب مخالفات للسياسات، فقد تقيّده Meta أو تعطله بالكامل. وعند حدوث ذلك، تعرض SparkTG خطأً على مستوى الحساب في جميع الحملات.

1. 1

   افحص حالة الحساب في Meta Business Manager

   سجّل الدخول إلى business.facebook.com → Settings → WhatsApp Accounts. إذا كان الحساب مقيداً، سترى شريطاً يوضح السبب مع خيار للاستئناف.

2. 2

   قدّم استئنافاً إلى Meta

   انقر على Request Review في Meta Business Manager. تستغرق المراجعات عادةً 24–48 ساعة. وستتلقى إشعاراً بالبريد الإلكتروني عند صدور القرار.

3. 3

   تواصل مع دعم SparkTG إذا رُفع القيد لكن الخطأ ما زال قائماً

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

6. أخطاء القوالب: التنسيق والمتغيرات ومشكلات الموافقة

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

• متغيرات فارغة أو مفقودة: يجب أن تكون لكل عنصر نائب {{variable}} في قالبك قيمة وقت الإرسال. وإذا كان أي متغير فارغاً، ستفشل الرسالة. راجع بيانات جهات الاتصال للتأكد من اكتمال جميع الحقول المطلوبة.
• وسائط مفقودة أو غير صالحة: إذا كان في قالبك ترويسة صورة أو فيديو أو مستند، فيجب توفير ملف وسائط صالح عند كل إرسال. وPDF هو الصيغة الوحيدة المدعومة لترويسات المستندات.
• فواصل أسطر أو علامات جدولة في المتغيرات: لا تضمّن فواصل أسطر أو علامات جدولة أو أكثر من أربع مسافات متتالية داخل قيمة أي متغير في القالب؛ فسترفض Meta الرسالة.
• قالب أوقفته Meta: توقف Meta القوالب ذات تقييم الجودة المنخفض تلقائياً. انتقل إلى WhatsApp Manager → Message Templates وافحص الحالة. ويمكنك إعادة تقديم المحتوى كقالب جديد إذا عُطِّل الأصلي نهائياً.
• اسم القالب غير موجود: إذا كنت ترسل عبر API الخاص بـ SparkTG، فتحقق من أن اسم القالب يطابق تماماً؛ فهو يراعي حالة الأحرف. وقد تستغرق القوالب المعتمدة حديثاً حتى 30 دقيقة لتصبح متاحة عبر API.

7. رسائل تفشل بسبب مشكلات الدفع أو الفوترة

يحاسب WhatsApp لكل محادثة (وليس لكل رسالة). فإذا تعذر على Meta تحصيل المبلغ من وسيلة الدفع الخاصة بك، ستفشل الرسائل الصادرة على مستوى API مع رمز خطأ متعلق بالدفع.

1. 1

   افحص وسيلة الدفع في Meta Business Manager

   انتقل إلى business.facebook.com → Settings → Payments. تحقق من وجود وسيلة دفع صالحة مسجلة ومن عدم وجود فواتير متأخرة.

2. 2

   تحقق من رصيد حساب SparkTG

   SparkTG Dashboard → Billing. تأكد من أن رصيد حساب SparkTG كافٍ لحجم الحملة. فلن تُرسَل الحملات إذا انخفض رصيد الحساب عن الحد الأدنى.

3. 3

   أعد التحقق من عملية الإعداد إذا كنت قد نقلت رقمك مؤخراً

   إذا نقلت رقم WhatsApp مؤخراً من مزود آخر إلى SparkTG، فتأكد من اكتمال خطوات Business Verification وإعداد الدفع في Meta Business Manager بالكامل. فقد تتسبب عمليات النقل غير المكتملة في أخطاء دفع مستمرة.

8. أخطاء رفع ملفات الوسائط

إذا كان قالبك يتضمن ترويسة وسائط وفشل الرفع، فسيتوقف إرسال الحملة بالكامل. ولدى WhatsApp متطلبات صارمة للصيغة والترميز (codec) لملفات الوسائط.

• الصور: يجب أن تكون JPEG أو PNG، بلون 8 بت، في وضع RGB أو RGBA. الحجم الأقصى للملف: 5 MB.
• الفيديو: يجب أن يستخدم ترميز الفيديو H.264 وترميز الصوت AAC. يُسمح بمسار صوتي واحد فقط. الحجم الأقصى للملف: 16 MB.
• المستندات: صيغة PDF فقط مدعومة في ترويسات رسائل القوالب. الحجم الأقصى للملف: 100 MB.
• إذا كان الفيديو ضمن حد الحجم لكنه يفشل مع ذلك، فالمشكلة غالباً في الترميز (codec). أعد ترميز الفيديو بأداة مثل HandBrake (H.264 + AAC) ثم ارفعه من جديد.

9. نص الرسالة أطول من المسموح

يفرض WhatsApp حدوداً صارمة لعدد الأحرف على كل جزء من القالب. وإذا تجاوز أي قسم حده، فلن تُرسَل الرسالة.

• نص الترويسة: 60 حرفاً كحد أقصى.
• نص المتن: 1,024 حرفاً كحد أقصى.
• نص التذييل: 60 حرفاً كحد أقصى.
• رابط زر الإجراء (CTA): 2,000 حرف كحد أقصى.
• تُحتسب رموز التنسيق (*، _، ~) ضمن حد الأحرف.

10. الحملة محجوبة: رصيد غير كافٍ

• انتقل إلى SparkTG Dashboard → Billing وافحص رصيدك المتاح.
• اشحن حسابك قبل إعادة إطلاق الحملة.
• تحقق من أن جميع جهات الاتصال في قائمة حملتك لها رموز دول صالحة: فالأرقام غير الصالحة تستهلك الرصيد في محاولات التسليم الفاشلة.