پرش به مطلب اصلی

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 بخش Preferences › Account Security کاربری را که برنامه از طرف او کار می‌کند باز کنید و New API Key را بزنید. Odoo کلید را فقط یک بار نشان می‌دهد: آن را کپی کنید. Odoo برای یکپارچه‌سازی‌ها کاربری جداگانه با فقط دسترسی‌های لازم را توصیه می‌کند.
  3. برنامه‌هایی که در Odoo استفاده می‌کنید. مخاطبان همیشه همگام می‌شوند. سرنخ‌ها به برنامه CRM، سفارش‌ها به برنامه فروش و فاکتورها به برنامه صدور فاکتور یا حسابداری نیاز دارند.
  4. یک سامانه پرداخت در MonoChat برای فرستادن لینک پرداخت. برنامه از سامانه پرداخت پیش‌فرض شما استفاده می‌کند.

اتصال Odoo​

  1. برنامه را از MonoStore نصب کنید.
  2. تنظیمات › Odoo را باز کنید.
  3. Odoo address (مثلاً https://yourcompany.odoo.com) و نام Database را وارد کنید.
  4. در Odoo 18 و نسخه‌های قدیمی‌تر، در Login (Odoo 18 and earlier) نام ورود کاربری را که کلید API متعلق به اوست وارد کنید. Odoo 19 و جدیدتر به آن نیاز ندارند.
  5. API key را جای‌گذاری کنید، Save و سپس Test connection را بزنید.

برنامه در Odoo 19 و جدیدتر از JSON-2 API و در نسخه‌های قدیمی‌تر از JSON-RPC استفاده می‌کند؛ صفحه نشان می‌دهد از کدام راه متصل شده است. کلید API دوباره نمایش داده نمی‌شود؛ برای نگه داشتن کلید ذخیره‌شده، خالی بگذارید. فقط مالک یا مدیر می‌تواند این تنظیمات را تغییر دهد. اگر نشانی یا پایگاه داده را تغییر دهید، کلید API را دوباره وارد کنید.

چه چیزی همگام می‌شود​

تنظیمکارکرد
Sync customers withجایی که مشتری MonoChat ساخته می‌شود وقتی Odoo رکوردی برای او ندارد: Contacts یا CRM leads.
Add new Odoo records with a phone number as MonoChat customersمخاطب یا سرنخی که پس از اتصال در Odoo ساخته شود و شماره تلفن داشته باشد، مشتری MonoChat می‌شود که تیم شما می‌تواند به او پیام دهد.
Post each closed conversation to the record’s chatterوقتی گفتگو بسته می‌شود، پیام‌های آن از آخرین یادداشت (حداکثر 100 پیام آخر) به‌صورت یادداشت در چتر ثبت می‌شوند. یادداشت‌های داخلی کنار گذاشته می‌شوند.
Journalدفتر روزنامه بانک یا نقدی که پرداخت لینک پرداخت‌شده در آن ثبت می‌شود. اگر انتخاب نکنید، Odoo انتخاب می‌کند.
Field mappingحداکثر پنج فیلد پروفایل، هر کدام با نام فنی یک فیلد Odoo (Odoo آن را در حالت توسعه‌دهنده نشان می‌دهد) و یک جهت: Both ways، To Odoo only یا From Odoo only. نام، شماره تلفن و نشانی ایمیل همیشه همگام می‌شوند.
  • از MonoChat به Odoo: وقتی پروفایل مشتری تغییر کند، برنامه مخاطب یا سرنخ او را با نشانی ایمیل یا شماره تلفن پیدا می‌کند یا می‌سازد و فقط مقدارهای تغییرکرده را می‌فرستد.
  • از Odoo به MonoChat: برنامه هر 10 دقیقه مخاطبان و سرنخ‌های تغییرکرده در Odoo را می‌خواند و مشتریان پیوندشده، یا مشتری با همان شماره تلفن یا نشانی ایمیل، را به‌روز می‌کند. مقداری که از Odoo آمده دوباره به آن فرستاده نمی‌شود.
  • وقتی مشتری یک سرنخ بعداً به‌عنوان مخاطب Odoo ظاهر شود، مشتری به آن مخاطب پیوند می‌خورد.
  • تنظیمات › Odoo زمان آخرین خواندن و در صورت شکست، خطای آن را نشان می‌دهد.
  • رکوردی که در MonoChat اعمال نشود خواندن را متوقف نمی‌کند: صفحه نشان می‌دهد چند رکورد رد شد، همراه با آخرین آن‌ها و دلیلش.

کنار گفتگو​

کارت Odoo کنار گفتگو آخرین فاکتورهای مشتری را همراه با مبلغ باقی‌مانده و وضعیت پرداخت، و آخرین سفارش‌های فروش او را نشان می‌دهد. روی فاکتور پرداخت‌نشده، Send payment link پیامی با لینک پرداخت مبلغ باقی‌مانده برای مشتری می‌فرستد.

استفاده در جریان‌ها​

در تنظیمات › اتوماسیون › جریان‌ها یک گره تابع به جریان اضافه کنید و یکی از گره‌های برنامه را انتخاب کنید. جریان‌ها را ببینید.

گرهکارکردخروجی‌ها
Odoo · Send orders or invoicesفاکتورهای پرداخت‌نشده یا آخرین سفارش‌های فروش مشتری (شماره، مبلغ و تاریخ) را زیر عنوانی که می‌نویسید برای او می‌فرستد.Sent، None، Not in Odoo
Odoo · Send invoice payment linkبرای قدیمی‌ترین فاکتور پرداخت‌نشده مشتری، به مبلغ باقی‌مانده، لینک پرداخت می‌سازد و با پیام شما می‌فرستد. {invoice}، {amount} و {link} را در جای مناسب پیام بنویسید.Sent، No invoice، Not in Odoo، No payment system

Not in Odoo یعنی برنامه برای مشتری مخاطبی در Odoo پیدا نکرد. اگر Odoo درخواست را رد کند، گره به شاخه خطا می‌رود.

استفاده با عامل هوش مصنوعی​

ابزارهای برنامه را به عامل هوش مصنوعی خود اضافه کنید:

  • Odoo · Read the customer's orders and invoices آخرین سفارش‌های فروش و فاکتورهای مشتری را با مبلغ، تاریخ و باقی‌مانده به عامل می‌دهد.
  • Odoo · Get an invoice payment link لینک پرداخت فاکتوری را که مشتری نام می‌برد، یا قدیمی‌ترین فاکتور پرداخت‌نشده، به عامل می‌دهد تا در پاسخ خود به اشتراک بگذارد.

وقتی مشتری پرداخت می‌کند​

لینک پرداخت به ارز فاکتور است. وقتی مشتری آن را پرداخت کند، برنامه پرداخت را روی فاکتور در Odoo، در دفتر روزنامه‌ای که انتخاب کرده‌اید، با MonoChat و شماره پرداخت به‌عنوان یادداشت ثبت می‌کند. فاکتوری که از قبل در Odoo پرداخت شده، دست‌نخورده می‌ماند.

خوب است بدانید​

  • Odoo هنوز نمی‌تواند به MonoChat اطلاع دهد، بنابراین تغییرات Odoo ظرف 10 دقیقه به MonoChat می‌رسند.
  • رکوردهایی که پیش از اتصال در Odoo تغییر کرده‌اند خوانده نمی‌شوند. مشتری وقتی به Odoo پیوند می‌خورد که پروفایلش تغییر کند، گفتگویی بسته شود یا برنامه تغییری را در Odoo بخواند.
  • برنامه در Odoo به‌عنوان کاربر کلید API عمل می‌کند: هر چه آن کاربر اجازه دارد ببیند و تغییر دهد، می‌بیند و تغییر می‌دهد.