التوثيق / الإعداد والتشغيل
استكشاف الأخطاء
الأعراض والأسباب والحلول لأكثر المشكلات شيوعاً.
| العرَض | السبب المحتمل والحل |
|---|---|
| The agent does not reply | افحص بالترتيب: الوكيل منشور ومسند للرقم؛ والرقم نشط وليس موقوفاً؛ واشتراكك وحصتك الشهرية سليمان؛ والمحادثة ليست بيد موظف (أعدها للذكاء الاصطناعي)؛ والعميل لم يلغِ الاشتراك؛ وwebhook مضبوط (انظر أدناه). |
| No messages arrive at all | webhook في Meta غير مضبوط أو رمز التحقق خاطئ. في Meta ثم WhatsApp ثم Configuration افحص رابط الاستدعاء (/v1/whatsapp/webhook) ورمز التحقق واشتراك messages. وفي الربط المضمّن افحص webhook تطبيق المنصة أيضاً. |
| The agent says a team member will follow up | لم يجد إجابة مسندة. افتح اللوحة ثم غير المُجاب وساحة الاختبار ثم أضف المعرفة الناقصة. اخفض حد الصلة فقط إن كانت الإجابات تفوت. |
window_closed when replying | مضت أكثر من 24 ساعة على آخر رسالة للعميل. أرسل قالباً معتمداً. |
Template stuck on pending or rejected | اضغط مزامنة مع Meta. المرفوض: اقرأ السبب وأزل الصياغة الترويجية من قالب خدمي أو صحّح المتغيرات وأنشئ قالباً جديداً. |
| Campaign paused by itself | نفدت الحصة الشهرية أو الاشتراك غير نشط. رقِّ ثم استأنف. |
| A recipient was skipped | يعرض صف المستلم السبب: not_opted_in أو opted_out أو blocked. سجّل الموافقة بشكل صحيح أو اتركه. |
plan_feature error | باقتك لا تشمل تلك الوحدة. رقِّ أو اسأل مالك المنصة. |
| Store connection fails | تذكر الرسالة السبب: بيانات مرفوضة أو عنوان خاطئ أو تحديد معدل. أعد إدخال البيانات ثم اختبار الاتصال. في Shopify استخدم عنوان .myshopify.com. |
Document shows requires_attention | تعذّرت قراءة الملف (صور ممسوحة أو تالف أو نوع خاطئ). افتحه لترى السبب ثم استبدله أو أعد معالجته. |
| No reset email arrives | افحص الرسائل غير المرغوبة. على الخادم MAIL_PROVIDER=log يطبع الرسائل في السجل فقط: اضبطه smtp. يرى مالك المنصة نتائج التسليم في التسويق ثم سجل تسليم البريد. |
| Locked out of two-step verification | استخدم رمز استرداد في خانة الرمز (بصيغة xxxx-xxxx). إن لم يكن لديك فاطلب من مالك المنصة إعادة ضبطه. |
| Nothing is being processed | WORKER_ENABLED يساوي false أو الـ API متوقف. راجع صحة النظام في اللوحة. |
ما زلت عالقاً؟ استخدم نموذج التواصل في الموقع أو زر محادثة واتساب.