شرح الإضافة
بتعمل إيه
FM WhatsApp بتدخّل الواتساب جوه EspoCRM. كل موظف بيربط رقمه بنفسه بالـ QR (زي WhatsApp Web)، وفيه رقم مشترك للشركة (الرسبشن) بيستقبل العملاء الجداد. كل المحادثات بتتربط أوتوماتيك بالـ Lead أو الـ Contact أو الـ Account برقم التليفون، والمدير بيشوف كل الأرقام من مكان واحد.
أهم المميزات
- Inbox بشكل واتساب ويب: بحث بالاسم والرقم وجوه الرسايل، فلاتر (غير مقروء، مستني رد، جديد، ليا، توظيف، مستني موافقة)، تاجز، صور وملفات وصوت، علامات التسليم والقراية.
- رقم الرسبشن: أي رقم جديد بيتعمله Lead، والرسبشن بتحوّله لمندوب (يدوي أو بالدور) مع ملخص للمندوب، والعميل بيوصله رسالة فيها اسم ورقم المندوب. قفل المحادثة على اللي بيرد علشان مايردش اتنين.
- منيو ترحيب للأرقام الجديدة (استثمار / عميل حالي / توظيف) بيتسجل على الليد.
- فرز التوظيف: رسايل الشغل والـ CV مابتبقاش ليدز، بتروح للـ HR وبتتسجل في كيان المتقدمين عندك مع الـ CV.
- أرقام الموظفين: الأرقام الجديدة اللي مش على السيستم بتستنى موافقة المدير (أو Lead تلقائي)، والموظف يقدر يعلّم المحادثة شخصية. أرقام الزملاء والموردين بتتسجل داخلي.
- تنبيهات: عميل مستني رد على الرسبشن بعد X دقيقة ثم تصعيد للمشرف، رقم فصل، عميل رجع كلم الشركة — على السيستم والموبايل والإيميل.
- تقرير يومي للمدير: المحادثات والليدز، متوسط وقت الرد لكل موظف، العملاء المستنيين، الأرقام الفاصلة، الإعلانات.
- ردود سريعة بمتغيرات وملفات، جدولة رسالة، بث آمن من Target List بحد يومي وفواصل وإلغاء اشتراك.
- إعلانات Click-to-WhatsApp: اسم الإعلان بيتسجل على الليد وتقرير بالليدز والتحويل لكل إعلان.
- بانل واتساب على صفحة الليد/الكونتاكت/الأكونت، داشلت، Formula:
ext\whatsapp\send، وربط مع Sales Dialer وإضافة الانضباط. - نسخة احتياطية مشفّرة للجلسات: لو السيرفر وقع الأرقام بترجع من غير QR.
التسطيب
- Administration ← Extensions ← ارفع الملف ← Install، وفعّل اللايسنس.
- Administration ← WhatsApp Settings ← تحميل الـ Gateway: ملف جاهز ومظبوط على الـ CRM بتاعك.
- ارفعه على سيرفر Linux (ممكن نفس سيرفر الـ CRM)، فك الضغط، وجوه الفولدر شغّل
bash install.sh(بيسطّب Node.js و pm2 ويشغّله). - في الإعدادات اكتب لينك الـ Gateway
http://127.0.0.1:3100← Save ← اختبار الاتصال. - Administration ← WhatsApp Numbers ← اعمل رقم الرسبشن (Type = Reception) وحدد الموظفين بتوعه ← Connect وامسح الـ QR من موبايل الشركة.
- كل موظف: تاب WhatsApp ← اربط رقمي ← يمسح الـ QR من واتساب موبايله (الأجهزة المرتبطة).
إزاي بيشتغل
الـ Gateway برنامج Node.js صغير بيفضل شغال على السيرفر وماسك اتصال كل الأرقام. الرسايل الجاية بتتبعت للـ CRM بـ Webhook موقّع، والـ CRM بيبعت عن طريقه بمفتاح سري. الإرسال بيمشي بفواصل عشوائية علشان يقلل خطر الحظر.
الإعدادات والصلاحيات
- كل الإعدادات في WhatsApp Settings: الـ Gateway، الرسبشن والتوزيع، المنيو، التنبيهات والتقارير، الأرقام والخصوصية، التوظيف، الربط مع السيلز، مواعيد العمل.
- صلاحية WhatsApp Chat → Read في الـ Role بتحدد مين يشوف إيه: all = كل الأرقام، team = أرقام الفريق، own = رقمه بس. موظفين الرسبشن بيتحددوا على رقم الرسبشن.
ملاحظات
- الربط بالـ QR مش WhatsApp Business API الرسمي — ابعد عن الرسايل الجماعية الكتير، الرقم ممكن يتحظر.
- محتاج سيرفر Linux عليه Node.js 20+ والـ CRM لازم يكون واصل للـ Gateway والعكس.
- الإيميلات محتاجة إعدادات SMTP في الـ CRM.
التثبيت والتفعيل
- نزّل ملف الإضافة من اللينك اللي هيوصلك مع مفتاح الترخيص.
- من EspoCRM: Administration ← Extensions ← Upload ← Install.
- من Administration ← Integrations افتح ترخيص الإضافة، فعّله، والصق المفتاح، واحفظ.
- هتلاقي شرح الإضافة وحالة الترخيص في صفحة الإضافة جوه الـ Administration.
سجل التغييرات
v1.4.0 Minor 2026-10-11
- جديد WhatsApp gateway bundled: Administration → WhatsApp Settings → Download gateway (pre-configured .env) → bash install.sh
- جديد Gateway setup box with "Test gateway" button in WhatsApp Settings
- جديد Welcome menu for new numbers on reception (investment / existing client / jobs)
- جديد Reception SLA alerts with escalation to supervisors
- جديد Alert when a WhatsApp number stays disconnected (bell, mobile, e-mail)
- جديد Daily manager report (chats, leads, response time per employee, waiting clients, ads)
- جديد Careful broadcasts from Target Lists (daily caps, random gaps, opt-out)
- جديد Click-to-WhatsApp ads tracking on chats and leads + ads report
- جديد Chat tags, scheduled messages and quick replies with files
- جديد Encrypted session backup in the CRM — restore a number without a new QR
- تحسين Inbox: unified filter bar, search inside message text, bulk actions
- تحسين Handoff summary from reception saved on the lead and sent to the rep
- تحسين Faster inbox refresh (pulse + WebSocket when enabled)