إنتقل إلى المحتوى الرئيسي

Odoo Sync

يربط Odoo Sync مساحة عمل MonoChat بقاعدة بيانات Odoo الخاصة بك، على Odoo Online أو Odoo.sh أو خادمك الخاص. يقوم التطبيق بما يلي:

  • يرسل اسم عملائك ورقم هاتفهم وبريدهم الإلكتروني وحقول الملف الشخصي المربوطة إلى جهة الاتصال أو العميل المحتمل في CRM الخاص بهم في Odoo، وينشئ سجلًا عندما لا يوجد،
  • يقرأ كل 10 دقائق جهات الاتصال والعملاء المحتملين الذين تغيّروا في Odoo ويحدّث العملاء المطابقين في MonoChat،
  • ينشر كل محادثة مغلقة كملاحظة في سجل المحادثات (chatter) الخاص بجهة الاتصال أو العميل المحتمل،
  • يعرض فواتير العميل وأوامر البيع الخاصة به بجانب المحادثة، ويرسل رابط دفع لفاتورة غير مدفوعة،
  • يسجّل الدفعة على الفاتورة في Odoo عندما يدفع العميل عبر الرابط.

قبل أن تبدأ​

تحتاج إلى:

  1. Odoo 17 أو أحدث مع صلاحية الوصول إلى API. يتيح Odoo الوصول إلى API في خطة Custom؛ وOdoo الذي تستضيفه بنفسك يتيحه أيضًا.
  2. مفتاح API. في Odoo، افتح التفضيلات › أمان الحساب للمستخدم الذي سيعمل التطبيق باسمه واضغط New API Key. يعرض Odoo المفتاح مرة واحدة: انسخه. يوصي Odoo بمستخدم مخصص للتكاملات بالصلاحيات التي يحتاجها فقط.
  3. التطبيقات التي تستخدمها في Odoo. تتم مزامنة جهات الاتصال دائمًا. يحتاج العملاء المحتملون إلى تطبيق CRM، والطلبات إلى تطبيق المبيعات، والفواتير إلى تطبيق الفوترة أو المحاسبة.
  4. نظام دفع في MonoChat لإرسال روابط الدفع. يستخدم التطبيق نظام الدفع الافتراضي لديك.

ربط Odoo​

  1. ثبّت التطبيق من MonoStore.
  2. افتح الإعدادات › Odoo.
  3. أدخل عنوان Odoo (مثل https://yourcompany.odoo.com) واسم قاعدة البيانات.
  4. في Odoo 18 والإصدارات الأقدم، أدخل اسم تسجيل الدخول للمستخدم الذي يملك مفتاح API. لا يحتاج Odoo 19 والإصدارات الأحدث إليه.
  5. الصق مفتاح API واضغط حفظ، ثم اختبار الاتصال.

يستخدم التطبيق واجهة JSON-2 API في Odoo 19 والإصدارات الأحدث، وJSON-RPC في الإصدارات الأقدم؛ وتعرض الشاشة الطريقة التي اتصل بها. لا يُعرض مفتاح API مرة أخرى؛ اتركه فارغًا للإبقاء على المفتاح المحفوظ. يمكن للمالك أو المدير فقط تغيير هذه الإعدادات. عند تغيير العنوان أو قاعدة البيانات، أدخل مفتاح API مرة أخرى.

ما الذي تتم مزامنته​

الإعدادما الذي يفعله
مزامنة العملاء معالمكان الذي يُنشأ فيه عميل MonoChat عندما لا يوجد له سجل في Odoo: جهات الاتصال (Contacts) أو العملاء المحتملون في CRM (Leads).
أضف سجلات Odoo الجديدة التي تحتوي على رقم هاتف كعملاء في MonoChatجهة الاتصال أو العميل المحتمل الذي يُنشأ في Odoo بعد الربط ولديه رقم هاتف يصبح عميلًا في MonoChat يمكن لفريقك مراسلته.
انشر كل محادثة مغلقة في سجل المحادثات (chatter) الخاص بالسجلعند إغلاق محادثة، تُنشر رسائلها منذ آخر ملاحظة (حتى آخر 100 رسالة) كملاحظة في chatter. تُستبعد الملاحظات الداخلية.
الدفتردفتر البنك أو النقدية الذي تُسجَّل فيه دفعة الرابط المدفوع. إذا لم تختر دفترًا، يختار Odoo.
ربط الحقولحتى خمسة حقول من الملف الشخصي، لكل منها الاسم التقني لحقل في Odoo (يعرضه Odoo في وضع المطوّر) واتجاه: في الاتجاهين أو إلى Odoo فقط أو من Odoo فقط. تتم مزامنة الاسم ورقم الهاتف والبريد الإلكتروني دائمًا.
  • من MonoChat إلى Odoo: عندما يتغيّر الملف الشخصي للعميل، يجد التطبيق جهة الاتصال أو العميل المحتمل عبر البريد الإلكتروني أو رقم الهاتف، أو ينشئ سجلًا، ويرسل القيم التي تغيّرت فقط.
  • من Odoo إلى MonoChat: كل 10 دقائق يقرأ التطبيق جهات الاتصال والعملاء المحتملين الذين تغيّروا في Odoo ويحدّث العملاء المرتبطين بهم، أو العميل الذي له رقم الهاتف أو البريد الإلكتروني نفسه. القيمة التي جاءت من Odoo لا تُرسل إليه مرة أخرى.
  • عندما يظهر عميل مرتبط بعميل محتمل لاحقًا كجهة اتصال في Odoo، يُربط العميل بجهة الاتصال.
  • تعرض الإعدادات › Odoo موعد آخر قراءة وخطأها إن فشلت.
  • السجل الذي لا يمكن تطبيقه في MonoChat لا يوقف القراءة: تعرض الشاشة عدد السجلات التي تم تخطيها، وآخرها وسبب ذلك.

بجانب المحادثة​

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

استخدمه في التدفقات​

أضف عقدة الدالة إلى تدفق من الإعدادات › الأتمتة › التدفقات واختر إحدى عقد التطبيق. راجع التدفقات.

العقدةما الذي تفعلهالمخرجات
Odoo · Send orders or invoicesترسل إلى العميل فواتيره غير المدفوعة أو أحدث أوامر البيع (الرقم والمبلغ والتاريخ) تحت العنوان الذي تكتبه.تم الإرسال، لا يوجد، غير موجود في Odoo
Odoo · Send invoice payment linkتنشئ رابط دفع لأقدم فاتورة غير مدفوعة للعميل بالمبلغ المتبقي، وترسله مع رسالتك. اكتب {invoice} و{amount} و{link} في الرسالة حيث يجب أن تظهر.تم الإرسال، لا توجد فاتورة، غير موجود في Odoo، لا يوجد نظام دفع

يعني غير موجود في Odoo أن التطبيق لم يجد جهة اتصال للعميل في Odoo. عندما يرفض Odoo الطلب، تنتقل العقدة إلى فرع الفشل.

استخدمه مع وكيل الذكاء الاصطناعي​

أضف أدوات التطبيق إلى وكيل الذكاء الاصطناعي:

  • Odoo · Read the customer's orders and invoices تعطي الوكيل أحدث أوامر البيع والفواتير الخاصة بالعميل، مع المبالغ والتواريخ والمبلغ المتبقي.
  • Odoo · Get an invoice payment link تعطي الوكيل رابط دفع للفاتورة التي يذكرها العميل، أو لأقدم فاتورة غير مدفوعة، ليشاركه في ردّه.

عندما يدفع العميل​

يكون رابط الدفع بعملة الفاتورة. عندما يدفعه العميل، يسجّل التطبيق الدفعة على الفاتورة في Odoo، في الدفتر الذي اخترته، مع MonoChat ورقم الدفعة كمذكرة. الفاتورة المدفوعة مسبقًا في Odoo تبقى كما هي.

معلومات مفيدة​

  • لا يستطيع Odoo إشعار MonoChat بعد، لذلك تصل التغييرات من Odoo إلى MonoChat خلال 10 دقائق.
  • لا تُقرأ السجلات التي تغيّرت في Odoo قبل الربط. يُربط العميل بـ Odoo عندما يتغيّر ملفه الشخصي، أو تُغلق محادثة، أو يقرأ التطبيق تغييرًا في Odoo.
  • يعمل التطبيق في Odoo باسم مستخدم مفتاح API: يرى ما يُسمح لهذا المستخدم برؤيته ويغيّر ما يُسمح له بتغييره.