بناء موديول أودو 18 لربط منصة مقسم (Maqsam) — اتصال مدمج + تعرّف تلقائي + سجل مكالمات

نبحث عن مطوّر أودو متخصص لبناء موديول مخصص من الصفر يربط منصة مقسم (maqsam.com) لمركز الاتصال السحابي بنظام أودو 18، بحيث يستطيع الموظف استقبال وإجراء المكالمات مباشرة من داخل واجهة أودو عبر واجهة مقسم المدمجة، مع التعرّف التلقائي على العميل وتسجيل كامل بيانات المكالمات في أودو.

ملاحظة: هذا التكامل مُطبّق فعلياً لدى عملاء آخرين لمقسم ولدينا فيديو يوضّح آلية عمله يمكن مشاركته مع المطوّر المختار.

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

أودو 18 مستضاف على سيرفر خاص داخل السعودية. منصة مقسم تدعم REST API و Webhooks و Callback URL و Web Dialer قابل للتضمين.

وثائق API مقسم متاحة على portal.maqsam.com/docs وسيتم مشاركتها مع المطوّر المختار.

صفحة واجهات مقسم البرمجية: https://maqsam.com/apis

المطلوب بناؤه:

أولاً — تضمين واجهة مقسم داخل أودو (Maqsam Web Dialer Embed):

تضمين Maqsam Web Dialer كنافذة منبثقة مدمجة داخل واجهة أودو، تظهر تلقائياً عند تسجيل دخول الموظف. تسجيل دخول تلقائي لمقسم (Auto-Login) بدون حاجة لإدخال بيانات مقسم منفصلة. الموظف يستقبل ويُجري المكالمات مباشرة من داخل أودو دون الحاجة لفتح تطبيق أو نافذة منفصلة. حالة الموظف (متاح، مشغول، غير متصل) تظهر وتُدار من داخل النافذة المدمجة.

ثانياً — الاتصال بواجهات مقسم البرمجية:

بناء طبقة اتصال مع REST API مقسم تشمل المصادقة باستخدام Access Key و Secret، مع تخزين المفاتيح بشكل آمن في إعدادات أودو. واستخدام Calls API لجلب بيانات المكالمات، و Agents API لمزامنة بيانات الموظفين، و Recordings API لجلب روابط التسجيلات الصوتية.

ثالثاً — استقبال Webhooks من مقسم:

بناء Controller (endpoint) في أودو يستقبل إشعارات من مقسم في الوقت الحقيقي عند كل حدث مكالمة (واردة، صادرة، مُجابة، منتهية، فائتة). تأمين الـ endpoint بمفتاح مصادقة لمنع الوصول غير المصرّح.

رابعاً — التعرّف التلقائي على العميل:

عند وصول مكالمة واردة، النظام يبحث عن رقم المتصل في جهات اتصال أودو (res.partner). إذا وجده يربط المكالمة بالعميل تلقائياً. إذا لم يجده يُنشئ جهة اتصال جديدة بالرقم.

خامساً — النافذة المنبثقة ببيانات العميل (Screen Pop):

عند وصول مكالمة من عميل مسجّل، تظهر نافذة منبثقة أو إشعار للموظف في واجهة أودو تعرض اسم العميل وآخر تعاملاته ورابط مباشر لبطاقته. يجب أن تعمل في الوقت الحقيقي بدون حاجة لتحديث الصفحة.

سادساً — موديل سجل المكالمات:

إنشاء موديل جديد (maqsam.call.log) يسجّل بيانات كل مكالمة يشمل: رقم المتصل، ربط بالعميل (res.partner)، الموظف الذي ردّ، نوع المكالمة (واردة أو صادرة)، المدة، الحالة (مُجابة أو فائتة أو مشغول)، رابط التسجيل الصوتي من مقسم، ملاحظات الموظف، والطابع الزمني.

سابعاً — تاب سجل المكالمات في بطاقة العميل:

إضافة تاب جديد في واجهة العميل (res.partner form view) يعرض جميع مكالماته مرتّبة من الأحدث، مع إمكانية الاستماع للتسجيل الصوتي مباشرة وفتح تفاصيل كل مكالمة.

ثامناً — إجراء مكالمات صادرة من أودو (Click-to-Call):

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

تاسعاً — لوحة إحصائيات بسيطة (Dashboard):

لوحة تعرض إحصائيات المكالمات اليومية: إجمالي الواردة، المُجابة، الفائتة، متوسط المدة، وأكثر الموظفين استقبالاً للمكالمات.

المخرجات المطلوبة:

موديول أودو جاهز للتثبيت (ملف zip) متوافق مع أودو 18. كود نظيف ومنظّم وموثّق بتعليقات واضحة. ملف شرح تقني يوضّح كيفية التثبيت والإعداد وضبط الـ Webhook في مقسم وتفعيل واجهة مقسم المدمجة. اختبار عملي في بيئة تجريبية قبل التسليم النهائي. دعم فني لمدة أسبوعين بعد التسليم لمعالجة أي مشاكل.

المهارات المطلوبة:

خبرة مثبتة في تطوير موديولات أودو إصدار 17 أو 18. إتقان بايثون و Odoo ORM. معرفة بـ OWL Framework و Odoo JavaScript لبناء الإشعارات والنوافذ المنبثقة وتضمين واجهات خارجية (iframe/widget). خبرة في التعامل مع REST APIs و Webhooks. يُفضَّل من لديه خبرة سابقة في تكامل أنظمة اتصالات أو VoIP مع أودو.

مرجع عملي:

يوجد لدينا فيديو من عميل حالي لمقسم يوضّح آلية عمل التكامل المطلوب (تضمين واجهة مقسم داخل أودو مع الاتصال المباشر). سيتم مشاركته مع المطوّر المختار كمرجع للمخرج النهائي المتوقع.

الجدول الزمني:

تسليم خلال 2 إلى 3 أسابيع من بدء العمل.

طريقة التقديم:

يرجى ذكر خبرتك في تطوير أودو وإصدارات أودو التي عملت عليها، مع إرفاق نماذج سابقة من موديولات طوّرتها (خصوصاً أي تكاملات مع APIs خارجية أو تضمين واجهات خارجية داخل أودو). يرجى تحديد المدة والتكلفة المتوقعة في عرضك.