اطّلع بنظرة سريعة على ما إذا كانت كل رسالة ترسلها قد أُرسلت أو سُلّمت أو شوهدت، وعلى سبب فشل أي رسالة لم تصل.
لم تعد بحاجة إلى التخمين أو إعادة الإرسال؛ فكل رسالة صادرة من صندوق الوارد (Inbox) تعرض حالتها مباشرة.
حالة الرسالة
تعرض كل رسالة ترسلها من صندوق الوارد، سواء كانت رسالة عادية أو قالباً، حالةً مباشرة على واتساب وفيسبوك ماسنجر وإنستغرام والويب شات (Webchat). تتحدّث الحالة تلقائياً، فلا حاجة إلى تحديث الصفحة.
| الحالة | الأيقونة | المعنى |
|---|---|---|
| تم الإرسال (Sent) | علامة صح رمادية واحدة | قبلت القناة الرسالة. |
| تم التسليم (Delivered) | علامتا صح رماديتان | وصلت الرسالة إلى جهاز العميل أو نافذة الدردشة لديه. |
| تمت المشاهدة (Seen) | علامتا صح زرقاوان | قرأ العميل الرسالة. |
| فشل (Failed) | علامة X حمراء | تعذّر تسليم الرسالة؛ ومرفق معها السبب. مرّر المؤشر فوق علامة X لمعرفة السبب. |
- الحالة تتقدم للأمام فقط. لا تؤدي إشعارات webhook المتأخرة أو المكررة إلى خفض حالة الرسالة أو تغيير وقتها.
- الفجوات تُعرض بصدق. إذا تعذّر على القناة تأكيد خطوة ما، تظهر عبارة «غير متاح»، وتبقى الرسالة عند آخر حالة صحيحة بدلاً من التخمين.
- مصطلحات موحّدة في كل مكان. يحوّل ربط قابل للتهيئة، ويمكن للمسؤولين فقط تعديله، حالات كل قناة إلى: تم الإرسال، تم التسليم، تمت المشاهدة، فشل، مع تسميات مترجمة تشمل اللغة العربية.
مرجع الأخطاء
ابحث أدناه عن الرمز الذي ظهر على الرسالة الفاشلة لتعرف معناه والخطوة التالية. أزرار الإجراءات الخاصة بكل خطأ مخطط لها في المرحلة القادمة.
أخطاء القنوات (Meta)
| الرمز | ما يظهر للموظف | السبب | كيفية التجنب |
|---|---|---|---|
| 131047 | انتهت نافذة المراسلة | مرّت أكثر من 24 ساعة منذ آخر رد من العميل. | تحقق من النافذة أولاً؛ وخارجها أرسل قالباً معتمداً. |
| 10-2018278 | لم يتم إرسال الرسالة | أُرسلت الرسالة خارج نافذة المراسلة المسموح بها على ماسنجر أو إنستغرام. | ردّ سريعاً، ولا تُعد التواصل في المحادثات القديمة عبر واجهة API. |
| 2534022 | لم يتم إرسال الرسالة | أُرسلت الرسالة خارج نافذة المراسلة المسموح بها (نفس حالة 10-2018278). | ردّ سريعاً وتحقق من النافذة قبل الإرسال. |
| 10-2018065 | الإذن مطلوب | أُرسلت الرسالة خارج النافذة دون الحصول على إذن News Messaging. | ابقَ داخل النافذة. |
| 131049 | لم يتم تسليم الرسالة | حجبت Meta الرسالة لحماية تفاعل المستخدمين، وغالباً بسبب حد الرسائل التسويقية. | انتظر 24 ساعة على الأقل وباعد بين الرسائل التسويقية. |
| 131056 | رسائل كثيرة جداً | أُرسل عدد كبير من الرسائل إلى المستلم نفسه خلال فترة قصيرة. | حدّد معدل الإرسال لكل مستلم ثم أعد المحاولة. |
| 131050 | الرسائل التسويقية معطّلة | اختار العميل إيقاف استلام الرسائل التسويقية. | لا تُعد المحاولة؛ وتابع webhook الخاص بـ user_preferences. |
| 131026 | لم يتم تسليم الرسالة | الرقم غير مسجّل على واتساب، أو لم يوافق العميل على الشروط، أو أن تطبيق واتساب قديم. | تحقق من صحة الأرقام وتواصل مع العميل بوسيلة أخرى. |
| 131045 | رقم الهاتف غير مسجّل | رقم الهاتف المرسِل غير مسجّل. | سجّل الرقم ثم أعد المحاولة. |
| 131031 | حساب واتساب مقيّد | مخالفة للسياسات، أو أن بيانات الطلب لم تتطابق (مثل إدخال رمز PIN خاطئ للتحقق بخطوتين). | التزم بسياسات Meta وتحقق من واجهة Health Status API. |
| 368 | حساب واتساب مقيّد | الحساب مقيّد أو معطّل بسبب مخالفة لسياسات المنصة. | التزم بسياسات Meta وحافظ على جودة عالية للرسائل. |
| 130497 | قيود على الدولة | لا يُسمح للحساب بإرسال رسائل إلى هذه الدولة. | راجع الدول المسموح بها لفئة نشاطك التجاري. |
| 10-1893063 | المراسلة مقيّدة | الصفحة مقيّدة مؤقتاً بسبب نشاط مخالف للسياسات. | التزم بسياسات المراسلة وانتظر حتى يُرفع التقييد. |
| 2388019 | تم بلوغ حد القوالب | تم تجاوز الحد الأقصى البالغ 250 قالباً. | احذف القوالب غير المستخدمة. |
| 2593107 | تم بلوغ حد المزامنة | يمكن تشغيل المزامنة مرة واحدة فقط لكل رقم. | ألغِ ربط العميل ثم أعد ربطه (Offboard ثم Re-onboard). |
| 132018 | خطأ في التحقق من القالب | معاملات القالب غير صالحة. | أرسل المتغيرات التي يحددها القالب بالضبط ودون فواصل أسطر، وطابق اسم القالب ولغته. |
| 131008 | معامل مطلوب مفقود | الطلب لا يتضمن معاملاً مطلوباً. | تحقق من البيانات المرسلة وفق مرجع نقطة الاتصال (endpoint). |
| 131009 | معاملات غير صالحة | قيمة أحد المعاملات غير مقبولة. | راجع القيم المدعومة في مرجع نقطة الاتصال (endpoint). |
| 131062 | مستلم BSUID غير مدعوم | أُرسل قالب مصادقة إلى BSUID بدلاً من رقم هاتف. | أرسل إلى رقم الهاتف متى توفر. |
| 190-463 | منتهي الصلاحية | انتهت صلاحية حالة تسجيل الدخول أو الرمز، أو تم إلغاؤه. | أعد ربط القناة وفعّل تنبيهاً لانتهاء الصلاحية. |
| 190-467 | رمز وصول غير صالح | انتهت صلاحية الرمز أو تم إلغاؤه أو أنه غير صالح لسبب آخر. | استخدم رموزاً طويلة الأمد وفعّل التنبيه مبكراً. |
| 551-1545041 | لم يتم إرسال الرسالة | المستلم غير متاح. | لا يمكن إصلاحه؛ تجاوز جهة الاتصال. |
| 551-1893047 | لم يتم إرسال الرسالة | المستلم غير متاح. | لا يمكن إصلاحه؛ تجاوز جهة الاتصال. |
| 10903-1893062 | لم يتم إرسال الرسالة | إعدادات الخصوصية لدى صاحب التعليق تمنع الردود الخاصة. | لا يمكن إصلاحه؛ تجاوز جهة الاتصال. |
| 130472 | لم يتم إرسال الرسالة | تم حجب الرسالة ضمن تجربة تجريها Meta. | سلوك متوقع؛ لا تُعد المحاولة. |
أخطاء المنصة (ERR-*)
ملاحظة
رموز ERR-* خاصة بالمنصة نفسها، لذلك استُنتجت أسبابها من نص الرسالة.
| الرمز | ما يظهر للموظف | السبب | كيفية التجنب |
|---|---|---|---|
| ERR-A4 | الإرسال غير متاح | دور المستخدم لا يسمح بإرسال القوالب. | امنح الصلاحية أو اطلب من المسؤول الإرسال. |
| ERR-B1 | لم يتم العثور على البوت | لا يوجد بوت مرتبط بالمحادثة. | تحقق من ربط البوت وتواصل مع الدعم. |
| ERR-B2 | واتساب غير متصل | واتساب غير متصل بالبوت. | اربطه من قسم القنوات (Channels). |
| ERR-C1 | القالب غير متاح | تمت إزالة القالب أو أنه غير معتمد. | زامن القوالب واختر قالباً آخر. |
| ERR-C2 | القالب غير مدعوم | فئة القالب غير مدعومة. | استخدم فئة مدعومة. |
| ERR-C3 | معلومات ناقصة | متغيرات القالب المطلوبة فارغة. | املأ جميع المتغيرات قبل الإرسال. |
| ERR-C4 | الوسائط مطلوبة | يتطلب القالب وسائط لم يتم إرفاقها. | أرفق الوسائط. |
| ERR-D1 | مراسلة الأعمال معطّلة | خاصية الدفع حسب الاستخدام (Pay-as-you-go) غير مفعّلة لواتساب. | فعّلها من الفواتير (Billing). |
| ERR-D2 | الرصيد غير كافٍ | رصيد المحفظة منخفض جداً. | اشحن الرصيد وفعّل تنبيهات انخفاض الرصيد. |
| ERR-D3 | الفوترة غير متاحة | الفوترة غير متاحة مؤقتاً. | أعد المحاولة بعد قليل. |
| ERR-D4 | المحفظة غير متاحة | تعذّر تحميل محفظة مساحة العمل. | أعد المحاولة؛ وتواصل مع الدعم إذا استمرت المشكلة. |
| ERR-D5 | المحفظة غير متاحة | تعذّر تحميل محفظة مساحة العمل. | أعد المحاولة؛ وتواصل مع الدعم إذا استمرت المشكلة. |
| ERR-D6 | مشكلة في الفوترة | تعذّرت معالجة إعدادات الفوترة. | تواصل مع الدعم. |
| ERR-D7 | التسعير غير متاح | لم يتم تحديد سعر للوجهة. | تواصل مع الدعم لإضافة التسعير. |
| ERR-D8 | مشكلة في الفوترة | لا توجد خطة فوترة صالحة لمساحة العمل. | اشترك في خطة أو أصلح الخطة الحالية. |
| ERR-D9 | تم بلوغ حد واتساب | تم استهلاك حصة رسائل واتساب في الخطة. | قم بترقية الخطة أو انتظر إعادة ضبط الحصة. |
| ERR-G1 | الفوترة غير متاحة | الفوترة غير متاحة مؤقتاً. | أعد المحاولة بعد قليل. |
| ERR-E1 | الحالة غير متاحة | تعذّر تأكيد حالة المحادثة. | أعد المحاولة أو أعد فتح المحادثة. |
| ERR-G3 | حالة الرسالة غير معروفة | من غير المعروف ما إذا كانت الرسالة قد أُرسلت. | تحقق من المحادثة قبل إعادة الإرسال. |
| ERR-F2 | الفوترة قيد المعالجة | تم تسليم الرسالة؛ والفوترة قيد المعالجة. | لا يلزم أي إجراء. |
| ERR-F3 | الاستخدام قيد المعالجة | تم تسليم الرسالة؛ ومعالجة الاستخدام قيد التنفيذ. | لا يلزم أي إجراء. |
دليل سريع للموظفين والمسؤولين
استخدم هذا الدليل لتحديد خطوتك التالية.
- القواعد: أخطاء النافذة والحد التسويقي وإلغاء الاشتراك هي قواعد Meta. استخدم القوالب خارج النافذة والتزم بقرارات إلغاء الاشتراك.
- أصلح ثم أعد المحاولة: أخطاء التسجيل والقوالب والفوترة والاتصال.
- انتظر ثم أعد المحاولة: حدود المعدل والحدود التسويقية.
- لا تُعد المحاولة: القيود وإلغاء الاشتراك والمستلمون غير المتاحين.
- تحقق قبل إعادة الإرسال عندما تكون الحالة غير معروفة، لتفادي التكرار.
ما زلت بحاجة إلى مساعدة؟ تواصل مع فريق الدعم وشاركنا الرمز الذي يظهر لك.