Wakeelوكيل
موظف ذكاء اصطناعي يردّ على عملاء النشاط التجاري عبر واتساب وإنستغرام وماسنجر — بلهجتهم العربية.
- الحالة
- المراحل من ٠ إلى ٨ منفّذة ومُتحقَّق منها محلياً؛ يتبقى التشغيل على رقم حقيقي والنشر الإنتاجي.
- الفترة
- 2026
- المنصات
- Web · WhatsApp · Instagram · Messenger
- المستودع
- خاص — متاح عند الطلب
- منشور
- —

01نظرة عامة
منصة SaaS متعددة المستأجرين: يربط النشاط التجاري قنوات المراسلة، فيردّ موظف ذكي على مدار الساعة نصاً وبالرسائل الصوتية، ويرسل صور المنتجات، ويسجّل العملاء المحتملين بعد تأكيدهم، ويحوّل المحادثة للفريق البشري. ويعمل الفريق من لوحة تحكم عربية فاخرة من اليمين لليسار.
بالأرقام
- إيداعاً
- 121
- إيداعاً
- git history
- مراحل تسليم
- 9
- مراحل تسليم
- docs/BACKLOG.md
- دولة ولهجة عربية
- 22
- دولة ولهجة عربية
- README
- شاشة موثّقة
- 65
- شاشة موثّقة
- docs/screens
02المشكلة
تبيع المشاريع الصغيرة والمتوسطة في العالم العربي عبر المحادثات. يكتب العملاء منتصف الليل، باللهجة، وغالباً برسائل صوتية — وصاحب العمل هو الوحيد الذي يرد. فتبرد الفرص، وتتكرر الأسئلة، وتردّ روبوتات المحادثة العامة بعربية رسمية جامدة أو تختلق الإجابات.
03الرؤية
موظف لا ينام ولا ينسى ولا يختلق: يجيب فقط مما علّمه إياه النشاط التجاري، بلهجة العميل، ويتنحّى حين يجب أن يتدخل إنسان.
04الحل
تُتحقَّق رسائل الويب هوك من Meta وتُخزَّن ويُرد عليها فوراً، ثم تعالجها سلسلة عمل غير مكررة (idempotent). يقوم وكيل LangGraph بالتوجيه والاسترجاع من فهرس بحث هجين خاص بكل مستأجر، واستدعاء الأدوات (المنتجات، الصور، بيانات العميل، التحويل للبشر) ثم الرد — نصاً، أو برسالة صوتية بلهجة العميل.
05الميزات الرئيسية
- 01
إجابات موثّقة بالمصادر
بحث هجين (pgvector مع البحث النصي العربي، مدموجان بـ RRF) في ملفات PDF وWord وExcel وصفحات الويب والأسئلة الشائعة والمنتجات. كل رد يعرض مصادره في صندوق الوارد، والأسئلة التي لم تُجب تتحول إلى أسئلة شائعة بنقرة.
- 02
تأكيد العميل في الكود، لا في النموذج
يقرأ الموظف اسم العميل ورقمه عليه بلهجته، ويُصنَّف التأكيد في الكود، فلا يُنشأ العميل المحتمل إلا بعد موافقة العميل على هذه التفاصيل بعينها. ثم لوحة كانبان وجدول وتصدير CSV وتنبيهات بالبريد والإشعارات.
- 03
رسائل صوتية في الاتجاهين
تُفرَّغ الرسائل الصوتية الواردة ويُرد عليها، ويمكن أن تكون الردود رسائل صوتية بلهجة الموظف وصوته المختار، بترميز Ogg/Opus الذي يتطلبه واتساب — دون ffmpeg.
- 04
أي نشاط، أي بلد عربي
نوع مساحة العمل (متجر، عيادة، مطعم، عقارات…) والبلد يحددان الشخصية والعملة والمنطقة الزمنية واللهجة في الدول العربية الـ٢٢ كلها.
- 05
صندوق وارد حيّ مع الاستلام اليدوي
صندوق وارد لحظي عبر SSE؛ يمكن لأي فرد من الفريق استلام المحادثة وإعادتها. ومحاكي عميل مدمج يتيح للنشاط تجربة موظفه قبل الإطلاق.
- 06
الباقات والاستهلاك والفوترة
قياس الاستهلاك لكل مستأجر وشهر (الرموز، ثواني الكلام، أحرف تحويل النص لكلام)، مع الباقات وشاشات الفوترة ولوحة إدارة داخلية.
06الشاشات
07معمارية النظام
- L1القنوات
- WhatsApp Cloud API
- Messenger
- Web simulator
- L2الويب
- Next.js App Router
- next-intl (ar / en)
- SSE inbox
- RTL design system
- L3الواجهة البرمجية
- FastAPI
- JWT + rotating refresh
- RBAC
- Signed webhooks
- L4العامل
- ARQ on Redis
- Per-conversation lock
- LangGraph agent
- Retries → dead-letter
- L5البيانات
- PostgreSQL 16
- pgvector
- Row-level security
- MinIO / S3
- L6المزوّدون
- LLM
- Speech-to-text
- Text-to-speech
- Embeddings
08قرارات هندسية
عزل المستأجرين في قاعدة البيانات لا في الكود فقط
أمان مستوى الصفوف في PostgreSQL مفروض على جداول المستأجرين مع اختبارات للعزل. وتصل الويب هوك إلى مستأجرها عبر دالة SECURITY DEFINER تُرجع المعرّفات فقط، فلا حاجة لتجاوز RLS أبداً.
عدم التكرار بحكم التصميم
تُخزَّن الحمولات الخام قبل المعالجة؛ معرّفات الرسائل فريدة لكل قناة فتصبح التسليمات المكررة بلا أثر؛ وقفل Redis لكل محادثة يمنع الرد المزدوج؛ والإخفاقات تُعاد بتأخير متزايد ثم تُحال لقائمة الرسائل الميتة.
واجهات مزوّدين مع بدائل صادقة
بدون مفتاح API يحوّل الموظف كل محادثة للفريق بلطف؛ ويوجد مزوّد «مُبرمَج» حتمي للعروض واختبارات CI، ويُرفض تشغيله في الإنتاج.
09تحديات تقنية
منع النموذج من اختلاق العملاء
قد «يسمع» النموذج تأكيداً لم يحدث. لذا يحفظ مسار العميل مسودة على المحادثة، وتُصنَّف رسالة العميل التالية في الكود (نعم / لا / غير واضح)، ولا يُنشأ العميل إلا عند «نعم» — ومعرّف المسودة يصبح معرّف العميل، فلا تُنشئ إعادة المحاولة عميلاً ثانياً أبداً.
الاسترجاع باللغة العربية
البحث المتجهي وحده يفوّت أسماء المنتجات والأسعار الدقيقة، والبحث بالكلمات وحده يفوّت صياغات اللهجة. دمج pgvector مع البحث النصي العربي عبر الدمج التبادلي للترتيب أعطى مقاطع دقيقة قابلة للاستشهاد.
10دروس مستفادة
دع النموذج يكتب، ودع الكود يقرر كل ما له عواقب.
موثوقية خط الويب هوك تساوي قدرته على إعادة التشغيل.
مساهمتي
تعريف المنتج والمعمارية والخادم وتصميم الوكيل ولوحة التحكم العربية أولاً، والتسليم مرحلةً بمرحلة كما هو موثق في المستودع (١٢١ إيداعاً).
التقنيات
- Python
- FastAPI
- SQLAlchemy
- PostgreSQL
- pgvector
- Redis
- ARQ
- LangGraph
- OpenAI
- Next.js
- TypeScript
- Tailwind CSS
- next-intl
- Docker
- GitHub Actions
- RAG
كيف تم التحقق
تمت مراجعة الكود والمعمارية وسجل المهام. الشاشات لقطات المشروع نفسه من التطبيق أثناء التشغيل، محفوظة لكل مرحلة في docs/screens.
مشاريع ذات صلة
- W
WaCRM
- TanStack Start
- React
- TypeScript
- Supabase
- PostgreSQL
WaCRM
نظام إدارة عملاء مبكر عبر واتساب للتجار — بذرة «وكيل».
أساسويبSaaS 
NOVA
نظام تشغيل شخصي بالذكاء الاصطناعي يعتمد على الصوت أولاً — وطبقة الصلاحيات، لا النموذج، هي التي تقرر ما يُسمح بتنفيذه.
قيد التطويرأندرويدذكاء اصطناعيسطح المكتب
Sanad
سندكل مهارة إلها قيمة — منصة ثنائية اللغة تربط المواهب بالوظائف والعمل الحر والتطوع.
منشورويب
المشروع التالي
NUR