واتساب
حل مشاكل واتساب
الأخطاء الأكثر شيوعاً وحلولها.
الويبهوك لا يستقبل
| العَرَض | السبب المحتمل | الحل |
|---|
| Meta تظهر “Verification failed” | Verify Token غير مطابق | تأكّد WHATSAPP_VERIFY_TOKEN في .env = نفس ما أدخلته في Meta |
| الرسائل لا تصل النظام رغم نجاح verification | لم تشترك بحدث messages | Meta Dashboard → Webhook → Subscribe |
503 / 502 من /webhook/whatsapp | Backend متوقف أو SSH tunnel مكسور | تحقّق lsof -nP -iTCP:3010 + أعد التشغيل |
| Signature verification يرفض | WHATSAPP_APP_SECRET خاطئ أو فاضي | انسخه من Meta App Settings → Basic. إذا فاضي، التحقّق يُتخطّى — للتطوير فقط. |
الإرسال يفشل
| الخطأ من Meta | السبب | الحل |
|---|
Invalid OAuth access token | الـ token منتهي (24h temp) | ولّد System User token دائم من Business Settings |
Recipient phone number not in allowed list | الرقم الاختباري بحدود 5 أرقام مسموحة | أضف الرقم في WhatsApp → API Setup → Recipient phone numbers، أو اربط رقم production |
Re-engagement required | تجاوزت 24 ساعة من آخر رسالة العميل | استخدم template معتمد (راجع قوالب) |
الـ AI لا يردّ
| العَرَض | السبب | الحل |
|---|
| الرسالة وصلت لكن لا ردّ | aiMode = OFF | غيّره من Inspector في صفحة WhatsApp |
| HYBRID لا يقترح ردّاً | Ollama متوقف أو لا يستجيب | ollama list + تأكّد النموذج محمّل + أعد تشغيل Ollama |
| الرد يصل بعد دقائق | الـ queue مزدحم أو LLM بطيء | /automation/queues لرؤية الحالة الفعلية |
💡نصيحة
كل الأحداث + الأخطاء تُسجَّل في backend.log. شغّلtail -f /tmp/operix-backend.log | grep -i whatsapp أثناء الاختبار للحصول على معلومات تفصيلية فوراً.