دليل ChatAman لـ Odoo

ماذا يوفر هذا التكامل؟

تضيف وحدات ChatAman صفحة Team Inbox متعددة الوكلاء والمحادثات والرسائل وجهات الاتصال وتشغيل Webhooks والحملات الدائمة وفرص CRM وعروض الأسعار والفواتير داخل Odoo. الإصدار الموقّع الحالي هو 1.17.0، ويدعم Odoo 16 و17 و18 على نسختي Community وEnterprise. جعل الإصدار 1.4.2 Automatic stable updates السياسة الافتراضية، وأضاف 1.5.0 صندوق الفريق، وأضاف 1.6.0 التحويل والتوفر والرد والتوجيه والتفاعلات وCRM والمتابعة. يضيف 1.7.0 ربط الترخيص بنسخة التثبيت وتوقيع طلبات API ومكان Production ومكان Staging ومهلة Offline مدتها 72 ساعة وتنزيلات محمية، ويصلح 1.7.1 الترتيب القياسي لمعاملات Query في طلبات GET الموقعة. ويضيف 1.8.0 تشخيص جاهزية صندوق الوارد وترقيم الرسائل الأقدم وإعادة المحاولة بمفتاح ثابت وفلاتر غير المقروءة والمؤجلة وتأجيلًا مخصصًا وردودًا سريعة من ChatAman ومسودات لكل محادثة وتأكيدًا غير حاجب عند تزامن الكتابة، ويصلح 1.8.1 مقارنة تواريخ الرسائل غير المقروءة. يضيف 1.9.0 البحث داخل Forward، وتأجيل Tomorrow وNext week، وتحذير انتهاء الوسائط، وتحديث Odoo Bus اللحظي مع بديل Polling، وتنبيهات المتصفح الاختيارية، ومؤشرات SLA وضغط العمل، ومسودات متعددة الأجهزة، وعمليات Bulk، وإحصاءات ردود سريعة بلا محتوى، وردودًا شخصية محكومة بالصلاحيات. يضيف 1.10.0 طبقة idempotency موحدة لعمليات Bulk بمفتاح Idempotency-Key رسمي، وقياس استخدام الردود السريعة بمنع تكرار آمن وخيار تعطيل لكل مؤسسة، ومسودات بصلاحية 30 يومًا مع مهلة استرداد 24 ساعة، وصندوق فريق مدمج للجوال يعمل من 320 بكسل. يضيف 1.11.0 منع أحداث SLA دون تغيير حقيقي، وسجل تدقيق قبل/بعد يوضح من غيّر السياسة والقيم التي تغيرت، ومراقبة DLQ مع إعادة نشر آمنة للحدث المتعطل، ومنع تكرار إبطال cache عند تسليم الحدث نفسه إلى Odoo، وشرطًا موحدًا لقائمة الإجراءات الإضافية في صندوق الفريق. يستطيع المسؤول تغيير سياسة التحديث بعد ذلك، ولن تعيد ترقية لاحقة فرضها. تبقى بيئات Odoo.sh على Notify only لأن نشر الكود فيها يجب أن يمر عبر فرع Git المتصل.

يجب أن يستخدم اتصال الإنتاج هذا العنوان بالضبط:

https://chataman.com

لا تستخدم dev.chataman.com مع قاعدة بيانات إنتاج خاصة بعميل.

قبل البدء

ستحتاج إلى:

• صلاحية مدير Odoo ووصول SSH إلى سيرفر Odoo في الاستضافة الذاتية.
• رابط HTTPS عام لـOdoo يستطيع ChatAman الوصول إليه.
• نسخة احتياطية من قاعدة البيانات قبل تثبيت الوحدات أو ترقيتها.
• مالك أو مدير لمؤسسة ChatAman لاعتماد الربط الآمن.
• اشتراك ChatAman أو فترة تجريبية نشطة؛ فهي التي تسمح بأول تنزيل موقّع وتجديد الترخيص كل 6 ساعات.
• الحزمة المطابقة للإصدار الرئيسي من Odoo. لا تثبّت حزمة 16 على 17 أو 18.

1. تثبيت الإضافات لأول مرة

سجّل الدخول إلى ChatAman وافتح Settings ← Integrations Hub ← Odoo، ثم نزّل الحزمة المطابقة لـOdoo 16 أو 17 أو 18. تنزيل ZIP مرخص ويستخدم رابطًا موقّعًا ينتهي بعد 15 دقيقة، بينما يعرض الفهرس العام بيانات التحقق فقط ولا يعرض رابط ملف قابلًا لإعادة الاستخدام.

ثم نفّذ الآتي:

1. ثبّت حزم Python الموجودة في ملف requirements.txt داخل نفس بيئة Python التي يستخدمها Odoo.

2. فك هذه المجلدات الخمسة داخل مجلد إضافات مخصص وموجود في addons_path: ‏chataman_connector وchataman_crm وchataman_sale وchataman_account وchataman_stock.

3. أنشئ مفتاح تشفير مخصصًا على سيرفر Odoo:

   openssl rand -hex 48
   

   أضف القيمة الناتجة أسفل [options] في ملف الإعداد الذي تستخدمه خدمة Odoo الفعلية، واحفظ الملف خارج Git:

   chataman_encryption_key = REPLACE_WITH_A_LONG_RANDOM_SECRET
   

   استبدل النص التجريبي بالقيمة الناتجة ولا تنسخه كما هو، ثم أعد تشغيل خدمة Odoo الفعلية بعد حفظ الملف.

4. فعّل وضع المطور، افتح Apps ثم اختر Update Apps List.

5. ثبّت ChatAman Connector أولًا. ثبّت ChatAman CRM أو Sales أو Accounting فقط عند وجود تطبيق Odoo المقابل.

6. امنح المشغلين صلاحية ChatAman User، وامنح مسؤولي الإعداد صلاحية ChatAman Manager.

إذا لم يظهر التطبيق، أزل فلتر Apps الافتراضي وابحث عن chataman، ثم حدّث Apps List مرة أخرى وتأكد أن المجلد الأب، وليس مجلد ZIP متداخلًا، موجود داخل addons_path.

2. إنشاء اتصال الإنتاج

أسرع مسار في Connector 1.2.7 وما بعده هو ChatAman ← Configuration ← Setup Assistant:

1. اترك ChatAman URL مضبوطًا على https://chataman.com.
2. اختر شركة Odoo وحدد Production أو Staging / Testing ثم عدد أيام سجل الرسائل المطلوب استيراده. ثلاثون يومًا بداية مناسبة.
3. اترك مزامنة جهات الاتصال واستقبال الأحداث مفعّلين ما لم تتطلب سياسة البيانات نطاقًا أضيق.
4. اضغط Connect securely. ينشئ المساعد الاتصال ويفتح مسار اعتماد ChatAman.

يمكنك الاستمرار في استخدام Configuration ← Connections لإعداد سياسة التحديث ونافذة الصيانة وخيارات المزامنة المتقدمة أو لإضافة اتصال شركة آخر. تبدأ الاتصالات الجديدة ذاتية الاستضافة بسياسة Automatic stable updates، بينما تظل Odoo.sh على Notify only.

3. ربط Odoo مع ChatAman بأمان

1. اضغط Connect securely داخل Odoo.
2. إذا طُلب منك ذلك، سجل الدخول إلى ChatAman بحساب مالك أو مدير المؤسسة.
3. اختر مؤسسة العميل الصحيحة. يعيدك ChatAman تلقائيًا إلى صفحة اعتماد طلب Odoo المعلّق.
4. راجع اسم نطاق Odoo وإصداره ونسخته وإصدار الموصل ومؤسسة ChatAman.
5. فعّل مربع التفويض ثم اضغط اعتماد الاتصال الآمن. يعيدك ChatAman تلقائيًا إلى Odoo وتصبح الحالة Connected.

ينشئ الربط مفتاح API محدود الصلاحيات وسر Webhook تلقائيًا. لا ترسل أيًا منهما عبر البريد أو المحادثات ولا تضعهما في تذاكر الدعم. تنتهي صلاحية طلب الربط إذا لم يكتمل بسرعة؛ ابدأ طلب ربط جديدًا عند حدوث ذلك.

ينشئ الربط مفتاح API محدود الصلاحيات وسر Webhook وسر توقيع خاص بنسخة التثبيت، ويربطها ببصمة قاعدة Odoo وعنوانها العام. لكل مؤسسة مكان Production واحد ومكان Staging / Testing إضافي. أدِر النسخ من Settings ← Integrations Hub ← Odoo؛ ينقل Transfer license المكان إلى الربط المعتمد التالي، بينما يلغي Revoke النسخة الحالية. يتحقق Odoo من الترخيص كل 6 ساعات، ويستمر حتى 72 ساعة عند انقطاع ChatAman ثم يتحول إلى القراءة فقط دون تعطيل CRM أو Sales أو Accounting داخل Odoo. تحصل اتصالات 1.6.x الحالية على نافذة انتقال 30 يومًا لتفعيل الربط الجديد دون قطع حركة API الحالية عند تحديث السيرفر.

اختيار إلغاء ورجوع لا ينشئ بيانات اعتماد، ويعيد Odoo إلى حالة Disconnected نظيفة حتى تستطيع بدء طلب جديد بأمان.

4. الاختبار والمزامنة

بعد أن تصبح الحالة Connected:

1. اضغط Test connection وتأكد من ظهور نتيجة ناجحة.
2. اضغط Refresh channels and templates لتحميل القنوات النشطة والقوالب المعتمدة ومستخدمي شات أمان.
3. اضغط Synchronize existing data مرة واحدة لجدولة جهات الاتصال والمحادثات وسجل الرسائل المحدد.
4. افتح ChatAman ← Operations ← Synchronization Jobs وتأكد أن المهام تكتمل.
5. أرسل رسالة اختبار مضبوطة واستقبل ردًا واحدًا قبل دعوة الفريق بالكامل.

أزرار صفحة الاتصال

5. استخدام لوحة المتابعة

ابدأ من ChatAman ← Dashboard. تعرض البطاقات الثماني المحادثات المفتوحة والإجمالية ورسائل اليوم وجهات الاتصال المتزامنة والحملات النشطة والحملات التي تحتاج تدخلًا والعمليات المنتظرة والعمليات الفاشلة. تفتح كل بطاقة السجلات الأصلية المطابقة مباشرة. تعرض Synchronization health نسبة العمليات الناجحة وآخر نشاط والمؤسسة المتصلة وقناة الإرسال الافتراضية.

استخدم Message volume وSynchronization outcomes وWebhook delivery لفتح رسوم Graph/Pivot الأصلية في Odoo. تظل كل قيمة قابلة للمراجعة من خلال قائمة السجلات الأصلية.

إذا كانت Failed operations أكبر من صفر، افتح البطاقة وأصلح أول سبب قابل للتنفيذ ثم استخدم Retry failed operations. لا تكرر محاولة خطأ إعداد أو صلاحية قبل إصلاح سببه.

6. عمل الفريق داخل Team Inbox

افتح ChatAman ← Team Inbox. يمنح الإصدار 1.6.0 أكثر من وكيل Odoo ووكلاء ChatAman شاشة شات تشغيلية منسقة بدل العمل من سجلات منفصلة. تعرض الأعمدة الثلاثة قائمة المحادثات المفلترة، ومحادثة العميل الحية، وبيانات العميل والتحكم التشغيلي. على الموبايل يتحول كل عمود إلى خطوة كاملة واضحة مع أزرار الرجوع والتفاصيل.

يستطيع الوكلاء من Team Inbox:

• البحث والتصفية بين All وMine وUnassigned وUnread وSnoozed، والتصفية بالحالة النشطة أو النهائية. ويوضح شريط الجاهزية مشاكل الاتصال أو الترخيص أو الربط أو القناة قبل بدء العمل.
• معرفة وكلاء Odoo وChatAman الذين يشاهدون المحادثة أو يكتبون فيها، مع تأكيد غير حاجب قبل الإرسال إذا كان وكيل آخر يكتب.
• استخدام Assign to me أو Transfer لاختيار وكيل أو قسم في ChatAman وتسجيل سبب إلزامي، ثم مراجعة سجل الإسناد والتحويل في تبويب Operations.
• عرض وضع الإسناد التلقائي والاستراتيجية وحدود السعة وساعات العمل والأقسام وحالة الوكيل (Online أو Busy أو Offline أو Outside working hours) مباشرة من ChatAman للقراءة فقط.
• تغيير الحالة بين Open وPending وIn Progress وResolved وClosed وتغيير الأولوية، أو استخدام Snooze بتاريخ مخصص أو إلغائه من لوحة التفاصيل، إضافة إلى إجراء الساعة الواحدة السريع.
• إرسال نص أو قالب معتمد أو صورة أو صوت أو فيديو أو مستند حتى 25 ميجابايت، مع وصف اختياري للملف.
• الرد على رسالة بعينها، وإعادة توجيه رسالة مدعومة إلى محادثة أخرى على الاتصال نفسه، وإرسال Emoji Reaction عبر القناة الأصلية عندما تدعمها.
• متابعة Queued وSent وDelivered وRead وFailed، وإعادة محاولة الرسالة الفاشلة بأمان، وتحميل الرسائل الأقدم دون فقد موضع التمرير، وتحديد المحادثة كغير مقروءة للمتابعة الشخصية. يُحتفظ بالنص غير المُرسل لكل محادثة عند التنقل، وتُستعاد المسودة والرد والتسمية عند فشل الإرسال.
• تحديد Follow-up date لإنشاء أو تحديث Odoo Activity حقيقي للوكيل، مع إبراز المتابعات المتأخرة في القائمة.
• إنشاء أو ربط CRM Lead من بيانات العميل عند تثبيت ChatAman CRM، وإنشاء عرض سعر مباشرة عند تثبيت ChatAman Sales.
• كتابة ملاحظات داخلية يراها وكلاء Odoo فقط ولا تُرسل إلى العميل أو قناة ChatAman.
• جلب ملخص ورد مقترح بالذكاء الاصطناعي عند إعداد AI للمؤسسة. يجب أن يراجع الوكيل الاقتراح قبل استخدامه وإرساله.
• اختيار رد سريع من ChatAman بالبحث أو الاختصار وإدخاله كنص قابل للتحرير. لا يُرسل أي شيء تلقائيًا، وتظل الردود السريعة مُدارة في ChatAman.
• البحث داخل نافذة Forward في كل المحادثات المؤهلة؛ تقيد النتائج بالمؤسسة والقناة نفسها وصلاحية الوكيل.
• التأجيل إلى Tomorrow أو Next week أو وقت مخصص، ويحسب ChatAman الموعد وفق المنطقة الزمنية وساعات عمل المؤسسة.
• فتح مدير الردود السريعة مباشرة عند خلو القائمة، مع تحذير قبل انتهاء رابط الوسائط وإجراء آمن لتجديده.
• تفعيل تنبيهات المتصفح اختياريًا، واختيار الصوت الافتراضي أو الوضع الصامت، وفتح المحادثة الصحيحة عند الضغط على التنبيه.
• متابعة مؤقتي الرد الأول والحل وبطاقات ضغط العمل من ChatAman، بصورة مستقلة عن Odoo Activities.
• حفظ مسودة بإصدار موثّق عبر المتصفحات والأجهزة، مع عرض نسخة السيرفر عند التعارض واختيار النسخة المطلوبة.
• تحديد حتى 50 محادثة لتنفيذ Assign أو Resolve أو Snooze جماعيًا، مع تأكيد ونتيجة لكل عنصر ومنع التكرار وإعادة محاولة الأخطاء القابلة للتكرار فقط.
• استخدام ردود المؤسسة أو الردود الشخصية؛ يبقى محتوى الرد الشخصي داخل ChatAman فقط ولا يراه إلا مالكه، مع سياسة مؤسسة وأدوات امتثال للمدير.

تنشر Webhooks التغييرات عبر Odoo Bus/WebSocket لتظهر فورًا. إذا لم يتوفر Bus تنتقل الصفحة تلقائيًا إلى Polling الآمن، مع مصالحة احتياطية كل 60 ثانية. يظل ChatAman مصدر الحقيقة للتوزيع والتوفر وتسليم القناة والتحويل وSnooze والرد وإعادة التوجيه والتفاعلات وSLA والردود السريعة، بينما يظل Odoo مصدر الحقيقة لسجلات CRM وعروض الأسعار والملاحظات الداخلية والأنشطة. تحافظ المزامنة الدائمة على تطابق الجانبين، لذلك لا يؤدي إغلاق المتصفح إلى فقد العمل الوارد.

الإجراءات السريعة

يعرض الشريط أعلى المحادثة Assign to me وTransfer وResolve وSnooze 1 hour وCreate/Open Lead وCreate Quotation. لا تظهر أزرار حزم الأعمال الاختيارية إلا عند تثبيت تطبيق Odoo والإضافة المقابلة.

تحويل المحادثة بأمان

1. افتح المحادثة واضغط Transfer.
2. اختر Agent أو Department؛ تعرض قائمة الوكلاء حالة التوفر المباشرة من ChatAman.
3. اختر الوجهة، واكتب سبب التحويل الإلزامي، ثم اضغط Transfer now.
4. افتح Details ← Operations للتأكد من قواعد التوزيع الحالية وظهور الحركة الجديدة في السجل الموثّق.

إنشاء متابعة داخل Odoo

افتح Details ← Contact وحدد Follow-up date ثم اضغط Schedule activity. ينشئ Odoo نشاط To Do للمالك المعيّن، أو للمستخدم الحالي عند عدم وجود مالك. يؤدي مسح التاريخ إلى حذف النشاط الذي أنشأه الموصل.

لإرسال قالب معتمد:

1. افتح محادثة مرتبطة بجهة اتصال متزامنة.
2. افتح تبويب Approved template واختر قالبًا من المكتبة المتزامنة.
3. راجع المعاينة. إذا كان القالب يحتوي على متغيرات، أدخل قيمة واحدة في كل سطر وبترتيب عناصر القالب.
4. اضغط Send template. يستخدم Odoo قناة القالب أولًا، ثم قناة الاتصال الافتراضية عند عدم وجودها.

صفحة Channels مرجع تشغيلي للقراءة. اضبط القناة الافتراضية من سجل الاتصال، واستخدم User mapping لربط كل عضو فريق شات أمان بمستخدم Odoo المقابل؛ لا يظهر في قائمة الإسناد داخل Team Inbox إلا الوكيل المرتبط. حدّث القنوات والقوالب بعد تغيير أعضاء الفريق.

7. تشغيل حملة قابلة للمراجعة

يستطيع مستخدم ChatAman Manager فقط فتح Campaigns. أنشئ مسودة واختر الاتصال ووسم جهات الاتصال الاختياري وقناة قابلة للإرسال، ثم اكتب نصًا أو اختر قالبًا معتمدًا. الحد الأقصى لكل حملة هو 200 جهة اتصال متزامنة. سجّل مصدر الموافقة ومرجع النموذج أو العقد أو التذكرة أو سجل التدقيق، ثم أكد موافقة كل مستلم على استقبال الرسائل.

اترك Scheduled start فارغًا للإضافة الفورية إلى قائمة الإرسال، أو اختر موعدًا مستقبليًا. استخدم قالبًا معتمدًا عندما تفرض القناة ذلك خارج نافذة خدمة العميل. أدخل قيمة واحدة في كل سطر لمتغيرات القالب. تُستبدل القيم الآمنة {{name}} و{{phone}} و{{email}} و{{company}} لكل مستلم بصورة مستقلة، وترفض الإضافة أي متغير غير معروف بدلًا من تنفيذه.

بعد الإضافة إلى القائمة تصبح الحملة سجلًا دائمًا. يمكنك إيقاف المستلمين الذين لم تُرسل رسائلهم مؤقتًا، ثم استئنافهم، أو إلغاء المتبقي، أو إعادة محاولة الفشل النهائي، أو نسخ الحملة إلى مسودة جديدة. تعرض البطاقات أعداد المستلمين وQueued وSent وDelivered وRead وFailed. تبقى نسبتا القبول والتسليم ظاهرتين بدون hover، بينما يفتح Open recipient analytics رسوم Odoo وجداول Pivot والسجلات الأصلية القابلة للتدقيق. تعتمد حالتا التسليم والقراءة على إيصالات المزود الواردة عبر Webhooks شات أمان.

8. تفعيل حزم الأعمال

Connector هو المنتج الظاهر، بينما تعمل CRM وSales وAccounting كحزم ميزات اختيارية يمكن لمدير Odoo تفعيل المتاح منها من لوحة المتابعة.

• CRM: إنشاء فرصة من المحادثة، مع خيار إنشاء فرصة جديدة أو إعادة استخدام فرصة مفتوحة لنفس جهة الاتصال عند وصول رسالة، وتسجيل تغير المرحلة في سجل محادثة Odoo، وإغلاق محادثة شات أمان اختياريًا عند ربح الفرصة أو أرشفتها. لا يخزن شات أمان مرحلة CRM كحقل مستقل حتى الآن.
• Sales: إنشاء عروض الأسعار وإرسال أحدث عرض PDF وتحديثات الطلب والتسليم، وفحص توفر المنتجات المخزنية على Odoo 16–18، مع خيار جدولة إشعار العميل عند تأكيد الطلب.
• Accounting: إنشاء فواتير العملاء وإرسال PDF أو تفاصيل الدفع وتذكير يدوي، مع خيار جدولة تذكيرات المتأخرات بفاصل مضبوط، وخيار شكر العميل عند تحول الفاتورة إلى Paid. تستخدم المبالغ دائمًا عملة الفاتورة/شركة Odoo.

رسائل الطلبات والمدفوعات التلقائية متوقفة افتراضيًا. لا تفعّلها قبل نجاح اختبار مضبوط وموافقتها لسياسة تشغيل العميل.

9. إنشاء أتمتة اختيارية

افتح ChatAman ← Automation وأنشئ القاعدة وهي غير نشطة أولًا. اختر Trigger: رسالة واردة أو محادثة جديدة أو محادثة مغلقة أو محادثة عاجلة أو تحديث جهة اتصال. ثم اختر إجراءً واحدًا: جدولة نشاط Odoo أو تعيين مسؤول Odoo أو إضافة وسم لجهة الاتصال. اضبط المستخدم أو نوع النشاط أو الوسم المطلوب، واحفظ واختبر ببيانات مضبوطة، ثم فعّل القاعدة.

تعرض كل قاعدة عدد مرات التشغيل وآخر تشغيل وآخر خطأ. يُعزل فشل القاعدة الاختيارية حتى لا يوقف استقبال Webhooks.

10. متابعة Webhooks والمزامنة

افتح ChatAman ← Operations لفحص Webhook Inbox ومهام المزامنة والتحديثات المُدارة وسجلات الاتصال.

يحفظ Webhook Inbox الأحداث الواردة الموقّعة بشكل موثوق، ويمنع المعالجة المكررة، ويعيد محاولة الأخطاء القابلة للتعافي. تكون Pending طبيعية حتى دورة Odoo cron التالية، وتؤكد Processed اكتمال المعالجة. تكرار Failed يشير غالبًا إلى مشكلة صلاحية أو شبكة أو تحقق بيانات يجب إصلاحها قبل إعادة المحاولة.

11. فصل الربط أو البدء من جديد بأمان

اضغط Disconnect، وراجع رسالة التأكيد، ثم اختر OK فقط عندما تريد إلغاء التكامل. يطلب Odoo من ChatAman إلغاء مفتاح API وWebhook، ويحذف بيانات الاعتماد المحلية المشفرة، ويلغي المهام غير المكتملة، ثم يعيد تحميل السجل بحالة Disconnected. استخدم Connect securely لإنشاء ربط جديد بعد ذلك.

12. تحديث تثبيت موجود على سيرفر خاص

افتح أولًا Settings ← Integrations Hub ← Odoo وانسخ رابط التنزيل الجديد لإصدار Odoo الصحيح، ثم شغّل هذا الأمر الواحد داخل جلسة SSH تفاعلية. يسأل الأمر عن الرابط بالإنجليزية ويمرره إلى أداة التحديث:

read -rsp "Paste the temporary ChatAman package URL: " CHATAMAN_PACKAGE_URL && echo && curl -fL https://chataman.com/installers/chataman-odoo-installer.py -o /tmp/chataman-odoo-installer.py && sudo python3 /tmp/chataman-odoo-installer.py --package-url "$CHATAMAN_PACKAGE_URL"

يكتشف المعالج الإنجليزي إصدار Odoo المثبت، ويسأل عن خدمة systemd وقاعدة البيانات، ويتحقق من توقيع الحزمة، ثم يعرض ملخصًا نهائيًا ويطلب كتابة UPDATE قبل تغيير أي شيء. ينشئ نسخة من قاعدة البيانات والإضافات، ويرقي الوحدات الأربع، ويعيد تشغيل Odoo ويفحص صحته ويحتفظ بمسار النسخة الاحتياطية. يتطلب أن يكون الموصل مثبتًا بالفعل، ويفترض المسار /usr/lib/python3/dist-packages/odoo/custom افتراضيًا؛ استخدم --addons-path إذا كان التثبيت في مكان آخر.

عملاء Odoo.sh يحدّثون Git revision أو submodule المستخدم داخل مشروع Odoo.sh بدلًا من تشغيل مشغّل الاستضافة الذاتية.

يمكن كذلك الفحص بأمان من صفحة الاتصال بالضغط على Check for updates:

حل المشكلات

تطبيق ChatAman غير ظاهر

تأكد أن مجلدات الوحدات الأربع موجودة مباشرة أسفل مسار مسجل في addons_path، وأعد تشغيل خدمة Odoo الصحيحة، وحدّث Apps List في وضع المطور، وأزل فلتر Apps الافتراضي ثم ابحث عن chataman.

الترقية تفشل أثناء تحميل الترجمة العربية

رقِّ إلى الإصدار الموقّع الحالي. يتضمن Connector 1.1.4 وما بعده تعافيًا محدودًا لملفات ترجمة ChatAman العربية القديمة غير السليمة بدون تعديل ترجمات Odoo الأساسية.

الاتصال يظل Disconnected

تأكد أن النظامين يستخدمان روابط HTTPS عامة، وأن رابط Odoo الأساسي صحيح، وأن جدار الحماية يسمح باتصالات HTTPS الداخلة والخارجة، وأن مؤسسة ChatAman الصحيحة اعتمدت الطلب، وأن طلب الربط لم تنتهِ صلاحيته.

زر Connect securely يطلب chataman_encryption_key

أنشئ مفتاحًا فريدًا بالأمر openssl rand -hex 48، وأضفه أسفل [options] في ملف الإعداد الذي تستخدمه خدمة Odoo الفعلية، ثم أعد تشغيل الخدمة وحاول مرة أخرى. احتفظ بالمفتاح نفسه طوال عمر قاعدة البيانات؛ تغييره أو فقدانه يجعل بيانات الاعتماد المخزنة غير قابلة للقراءة ويتطلب إعادة الربط.

مهام Webhook أو المزامنة لا تتحرك

تأكد أن Odoo cron يعمل باستمرار. بعد ذلك راجع Webhook Inbox وSynchronization Jobs وConnection Logs وابحث عن أول خطأ قابل للتنفيذ. أصلح السبب قبل إعادة محاولة دفعة كبيرة.

قائمة تحقق الإنتاج

• عنوان ChatAman هو https://chataman.com بالضبط.
• يستخدم Odoo رابط HTTPS عامًا مع تعطيل قائمة قواعد البيانات عند الحاجة.
• تم إعداد chataman_encryption_key مخصص وحفظه بأمان.
• ينجح Test connection، ويعالج Webhook Inbox حدث integration.test، وينجح اختبار رسالة صادرة وواردة.
• يعمل Odoo cron باستمرار وقوائم Operations سليمة.
• تم توثيق سياسة التحديث ونافذة الصيانة والنسخ الاحتياطي والمسؤول المعني.