مساعد المتجر الذكي عبر WhatsApp

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

المشكلة

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

الميزات الأساسية

• يتصل Baileys بخدمة WhatsApp ويحفظ حالة المصادقة في MongoDB.
• تُصفى الرسائل المكررة وتُجمع رسائل المرسل نفسه لفترة قصيرة قبل معالجتها بالذكاء الاصطناعي.
• تعرض رسالة البداية اختياراً بين الرد الآلي والدعم البشري.
• يمكن تحويل النصوص وصور المنتجات والملاحظات الصوتية إلى مدخلات لخدمة Gemini.
• تجمع مطابقة المنتجات بين حقول الكتالوج وتقييم الكلمات والبحث المتجهي عبر Qdrant.
• يبدأ البحث في الأسئلة الشائعة بالبحث الدلالي، ثم يعود إلى مطابقة النص في MongoDB عند الحاجة.
• يستطيع العميل الموافقة على حفظ تذكير بمنتج غير متوفر.
• يستقبل مشترك Redis أحداث المخزون ويرسل التذكيرات المطابقة عبر WhatsApp.

البنية التقنية

تستقبل خدمة Node.js الرسائل عبر Baileys. تحفظ Mongoose المحادثات والمنتجات والجلسات والتذكيرات في MongoDB. تجمع آلية تأخير قصيرة رسائل كل مرسل، ثم تدير قائمة عادية وجدول إعادة محاولات في Redis استدعاءات Gemini. يجري البحث عن المنتجات والأسئلة الشائعة عبر MongoDB وQdrant. تستطيع خدمة خارجية لمزامنة المخزون تحديث البيانات القديمة؛ وتنقل Redis Pub/Sub أحداث توفر المنتجات إلى معالج التذكيرات.

نقاط هندسية

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

دوري

بنيت اتصال WhatsApp وأوضاع المحادثة وتوليد الردود عبر Gemini ومطابقة الكتالوج ومعالجة إعادة المحاولة ومسار إشعارات عودة المخزون للعميل.