مدیریت پیام‌های ورودی

یک پیام ورودی ایمیلی است که به پایگاه داده اودو ارسال شده است. هر کسی می‌تواند به یک نام مستعار ایمیل ایجاد شده در پایگاه داده ایمیل ارسال کند یا به ایمیلی که قبلاً از پایگاه داده بر اساس سربرگ پاسخ به ارسال شده است، پاسخ دهد.

نام‌های مستعار ایمیل

نام‌های مستعار خاص مدل

برخی از برنامه‌ها دارای نام‌های مستعار خاص خود هستند (تیم‌های فروش، تیم‌های پشتیبانی، پروژه‌ها و غیره). این نام‌های مستعار برای موارد زیر استفاده می‌شوند:

  • یک رکورد ایجاد کنید زمانی که یک ایمیل مستقیماً به نام مستعار ارسال می‌شود،

  • دریافت پاسخ‌ها به ایمیلی که در ابتدا از یک رکورد ارسال شده است.

Example

بخش محلی "info" برای نام مستعار تیم فروش استفاده می‌شود.

در مثال نمایش داده شده در بالا، ارسال یک ایمیل به info@company-name.odoo.com به طور خودکار یک فرصت جدید یا یک سرنخ جدید ایجاد می‌کند که به تیم فروش مربوطه اختصاص داده می‌شود. اگر ایمیلی از چتر یک فرصت موجود ارسال شود، پاسخ به به info@company-name.odoo.com خواهد بود. پاسخ بر اساس هدر message-id در چتر مربوطه ارسال خواهد شد.

گیرنده عمومی

اگر یک برنامه دارای نام مستعار نباشد، یک نام مستعار عمومی به عنوان جایگزین استفاده می‌شود: نام مستعار عمومی. ایمیلی که از یک چتر ارسال می‌شود، دارای آدرس پاسخ تنظیم شده به این نام مستعار عمومی است. پاسخی که به نام مستعار عمومی ارسال می‌شود، به لطف سربرگ message-id به چتر صحیح ارسال می‌شود.

به‌صورت پیش‌فرض، بخش محلی catchall استفاده خواهد شد. حالت حالت توسعه‌دهنده (حالت اشکال‌زدایی) را فعال کنید و به مسیر تنظیمات ‣ فنی ‣ ایمیل‌ها: دامنه‌های مستعار بروید تا به تنظیمات دسترسی پیدا کنید.

یک ایمیل به آدرس عمومی همیشه باید پاسخی به یک ایمیل قبلی ارسال شده از پایگاه داده باشد. اگر ایمیلی مستقیماً به آدرس عمومی ارسال شود، فرستنده پیام زیر را دریافت خواهد کرد:

ایمیل برگشتی از "MAILER-DEAMON" که توضیح می‌دهد چگونه با پایگاه داده تماس بگیرید.

توجه

آدرس ایمیل info@company-name.com که در تصویر بالا نمایش داده شده است، آدرس ایمیلی است که برای شرکت تنظیم شده است. با ورود به حالت توسعه‌دهنده در پروفایل شرکت، گزینه‌های پیکربندی اضافی (مانند catchall و bounce) قابل مشاهده می‌شوند. این گزینه‌ها را می‌توان با کلیک بر روی لینک داخلی دامنه ایمیل تغییر داد. به طور کلی توصیه نمی‌شود این گزینه‌ها را تغییر دهید مگر اینکه نیازهای خاصی وجود داشته باشد، زیرا این تغییرات بر تمام پاسخ‌های ایمیل‌های ارسال‌شده قبلی تأثیر خواهد گذاشت.

Example

یک نام مستعار می‌تواند در یک تیم فروش در برنامه CRM تنظیم شود. زمانی که یک مشتری به ایمیلی که از برنامه CRM ارسال شده پاسخ دهد، پاسخ به به صورت info@company-name.odoo.com خواهد بود.

هنگامی که یک ایمیل از برنامه تماس ارسال می‌شود، آدرس پاسخ catchall@company-name.odoo.com است زیرا هیچ نام مستعاری روی مدل تماس وجود ندارد.

توجه

توصیه می‌شود بخش محلی (local-part) از catchall و bounce بدون تغییر باقی بماند. اگر این مقدار تغییر کند، ایمیل‌های قبلی ارسال‌شده از پایگاه داده همچنان دارای مقادیر بخش محلی قبلی خواهند بود. این موضوع می‌تواند منجر به عدم دریافت صحیح پاسخ‌ها در پایگاه داده شود.

بازگشت

به همان روشی که از نام مستعار کلی برای ساختن آدرس پاسخ استفاده می‌شود، از نام مستعار بازگشت نیز برای ساختن مسیر بازگشت ایمیل استفاده می‌شود. مسیر بازگشت زمانی استفاده می‌شود که ایمیل‌ها به گیرنده تحویل داده نمی‌شوند و یک خطا به فرستنده بازگردانده می‌شود.

به طور پیش‌فرض نام bounce استفاده خواهد شد. حالت حالت توسعه‌دهنده (حالت اشکال‌زدایی) را فعال کنید و به تنظیمات ‣ فنی ‣ ایمیل‌ها: دامنه‌های مستعار بروید تا به تنظیمات دسترسی پیدا کنید.

توجه

در Odoo Online، هنگام استفاده از سرور ایمیل خروجی پیش‌فرض، آدرس مسیر بازگشت به صورت اجباری به مقدار bounce@company-name.odoo.com تنظیم می‌شود، بدون توجه به مقداری که به عنوان نام مستعار بازگشت تنظیم شده است.

هنگامی که خطایی رخ می‌دهد، یک اعلان دریافت شده و در یک پاکت قرمز در چتر نمایش داده می‌شود. در برخی موارد، پاکت قرمز ممکن است فقط حاوی پیام بدون خطا باشد، به این معنی که خطایی وجود دارد که اودو نتوانسته آن را مدیریت کند.

یک اعلان نیز در آیکون گفتگو در نوار ناوبری نمایش داده خواهد شد.

یک ایمیل ارسال شده به یک مخاطب با مشکلی مواجه شده و خطا در نوار ناوبری گزارش شده است.

Example

اگر نشانی ایمیل گیرنده نادرست باشد، با کلیک بر روی پاکت قرمز در بخش گفتگو، پیام خطایی که دلیل شکست را توضیح می‌دهد نمایش داده خواهد شد.

یک ایمیل ارسال شده به دامنه اشتباه باعث ایجاد بازگشت می‌شود که به صورت یک پاکت قرمز نمایش داده می‌شود.

دریافت ایمیل‌ها با تنظیمات پیش‌فرض اودو

در Odoo Online و Odoo.sh، نشانی‌های ایمیل مستعار، پاسخ و برگشتی به‌صورت پیش‌فرض تنظیم شده‌اند. این نشانی‌ها از دامنه مستعاری استفاده می‌کنند که به‌طور خودکار به یک پایگاه داده استاندارد اضافه شده است.

Example

فرض کنید آدرس پایگاه داده https://mydatabase.odoo.com است، دامنه مستعار mydatabase.odoo.com به‌صورت خودکار ایجاد می‌شود. از Catchall و Bounce می‌توان استفاده کرد و آدرس آن‌ها به‌ترتیب catchall@mydatabase.odoo.com و bounce@mydatabase.odoo.com است.

اگر برنامه CRM نصب شده باشد و یک تیم فروش با نام مستعار info ایجاد شود، آدرس info@mydatabase.odoo.com می‌تواند بلافاصله استفاده شود. همین موضوع برای هر نام مستعار دیگری که در برنامه‌های دیگر ایجاد شود نیز صدق می‌کند.

دامنه پایگاه داده آماده استفاده برای دریافت ایمیل‌ها بدون نیاز به تنظیمات اضافی است.

استفاده از چندین زیر دامنه اودو

در اودو آنلاین، تنها زیر دامنه اودو همان است که در زمان ایجاد پایگاه داده تعریف شده است.

در Odoo.sh امکان استفاده از چندین زیر دامنه اودوو وجود دارد. در تنظیمات شاخه، می‌توان زیر دامنه‌های اضافی اودوو را اضافه کرد، به شرطی که هنوز در شاخه دیگری استفاده نشده باشند. این دامنه‌ها باید به دامنه‌های مستعار اضافه شوند تا توسط یک شرکت استفاده شوند.

راه‌اندازی یک زیر دامنه اودو بر روی یک شعبه.

استفاده از دامنه سفارشی برای پیام‌های ورودی

دامنه alias domain باید در تنظیمات عمومی انتخاب شود. اگر چندین شرکت دارید، هر کدام باید پیکربندی شوند.

دامنه مستعار در تنظیمات عمومی.

تمام نام‌های مستعار از این دامنه سفارشی استفاده خواهند کرد. پاسخ‌ها به مدل‌هایی که برای آن‌ها یک نام مستعار تنظیم شده است، به [alias]@my-custom-domain.com ارسال می‌شوند. پاسخ‌ها به سایر مدل‌ها از طریق catchall@my-custom-domain.com به صندوق دریافت عمومی ارسال می‌شوند.

طرح فنی مسیر ارسال ایمیل هنگام استفاده از دامنه سفارشی در Odoo.

مهم

اگر ایمیل‌ها با استفاده از سرورهای ایمیل اودو و با دامنه سفارشی ارسال می‌شوند، دستورالعمل‌های "استفاده از دامنه سفارشی با سرور ایمیل اودو" را دنبال کنید.

از آنجایی که این دامنه سفارشی استفاده می‌شود، تمام ایمیل‌هایی که از یک نام مستعار استفاده می‌کنند (پاسخ‌ها، برگشتی‌ها و ارسال‌های مستقیم) به آدرسی از دامنه ارسال می‌شوند. بنابراین، این ایمیل‌ها به سرور ایمیلی که به دامنه متصل است (رکورد MX) تحویل داده می‌شوند. برای نمایش آن‌ها در چتر یا ایجاد رکوردهای جدید، لازم است این ایمیل‌های ورودی در پایگاه داده Odoo بازیابی شوند.

روش

مزایا

معایب

تغییر مسیرها

راه‌اندازی آسان، ایمیل‌ها مستقیماً به پایگاه داده ارسال می‌شوند.

هر نام مستعار یک پایگاه داده باید پیکربندی شود.

سرورهای ایمیل ورودی

امکان نگهداری یک نسخه از ایمیل در صندوق پستی شما (با استفاده از IMAP) را فراهم می‌کند. امکان ایجاد رکوردها در مدل انتخاب‌شده را فراهم می‌کند.

بستگی به یک CRON دارد، به این معنی که ایمیل‌ها بلافاصله در پایگاه داده بازیابی نمی‌شوند. هر نام مستعار یک پایگاه داده باید پیکربندی شود.

رکورد MX

تنها یک رکورد باید ایجاد شود تا تمام نام‌های مستعار به درستی کار کنند.

استفاده از زیر دامنه الزامی است. نیاز به دانش فنی پیشرفته دارد.

مهم

برای پایگاه‌های داده محلی، روش‌های تغییر مسیر و رکورد MX همچنین نیاز به پیکربندی اسکریپت دروازه ایمیل دارند. استفاده از این اسکریپت نیازمند دانش فنی و زیرساختی پیشرفته است.

مهم

برای اطلاعات دقیق‌تر در مورد نحوه مدیریت روش‌های ذکر شده در زیر، به مستندات ارائه‌دهنده خود مراجعه کنید.

تغییر مسیرها

اگر پایگاه داده روی Odoo Online یا Odoo.sh میزبانی شده باشد، استفاده از تغییر مسیرها توصیه می‌شود. این تغییر مسیرها امکان دریافت پیام‌ها بدون تأخیر در پایگاه داده را فراهم می‌کنند.

هدایت آدرس‌های عمومی و بازگشتی به زیر دامنه اودو مربوط به پایگاه داده الزامی است. هر آدرس مستعار دیگری که استفاده می‌شود نیز باید هدایت شود.

Example

با یک تیم فروش، تغییر مسیرهای زیر مورد نیاز است:

  • catchall@company-name.comcatchall@company-name.odoo.com

  • bounce@company-name.combounce@company-name.odoo.com

  • info@company-name.cominfo@company-name.odoo.com

مهم

برخی از ارائه‌دهندگان درخواست می‌کنند که تغییر مسیر را با ارسال یک لینک به آدرس ایمیل مقصد تأیید کنند. این رویه برای ایمیل‌های کلی (catchall) و برگشتی (bounce) مشکل‌ساز است زیرا از آن‌ها برای ایجاد رکورد استفاده نمی‌شود.

  1. مقدار catchall را در دامنه‌ی نام مستعار ایمیل تغییر دهید. برای دسترسی به این منو باید حالت توسعه‌دهنده فعال باشد. به عنوان مثال، می‌توان آن را از catchall به temp-catchall تغییر داد. این تغییر امکان استفاده از catchall به عنوان بخش محلی یک نام مستعار دیگر را فراهم می‌کند.

  2. یک برنامه‌ای را باز کنید که از یک نام مستعار استفاده می‌کند. به عنوان مثال، CRM شامل نام‌های مستعار برای هر تیم فروش است. قسمت محلی نام مستعار یک تیم فروش را به catchall تنظیم کنید.

  3. ایمیل تأیید یک رکورد در برنامه CRM ایجاد خواهد کرد. ایمیل ارسال‌شده در بخش چتر قابل مشاهده خواهد بود و به شما امکان می‌دهد تغییر مسیر را تأیید کنید.

  4. فراموش نکنید که نام مستعار تیم فروش و مقدار کلی در دامنه نام مستعار ایمیل را به حالت قبل از این فرآیند تغییر دهید.

توجه

یک جایگزین برای تغییر مسیرها، ارسال به جلو است. با ارسال به جلو، آدرس ارسال‌کننده ایمیل به عنوان فرستنده شناسایی می‌شود، در حالی که با تغییر مسیرها، فرستنده اصلی همیشه باقی می‌ماند.

سرورهای ایمیل ورودی

همانطور که قبلاً ذکر شد، استفاده از تغییر مسیرها روش توصیه‌شده برای دریافت ایمیل‌ها در Odoo است. با این حال، امکان تنظیم سرورهای ایمیل ورودی نیز وجود دارد. استفاده از این روش به معنای ایجاد یک سرور ایمیل ورودی برای هر صندوق پستی در سرور شما، صندوق عمومی، ایمیل‌های برگشتی و هر نام مستعار پایگاه داده است تا بتوانید تمام ایمیل‌های ورودی را دریافت کنید. سرورهای ایمیل ورودی با رفتن به مسیر زیر ایجاد می‌شوند: تنظیمات ‣ فنی ‣ ایمیل‌ها: سرورهای ایمیل ورودی.

مهم

ما توصیه می‌کنیم از پروتکل IMAP به جای پروتکل POP استفاده کنید، زیرا IMAP تمام ایمیل‌های خوانده‌نشده را دریافت می‌کند، در حالی که POP تمام تاریخچه ایمیل‌ها را دریافت کرده و سپس آن‌ها را در صندوق پستی شما به عنوان حذف‌شده علامت‌گذاری می‌کند.

نکته

همچنین امکان اتصال یک صندوق پستی از طریق Gmail با Google OAuth یا Outlook با Microsoft Azure OAuth وجود دارد.

صرف‌نظر از پروتکل انتخاب‌شده، ایمیل‌ها با استفاده از اقدام زمان‌بندی‌شده ایمیل: سرویس Fetchmail دریافت می‌شوند.

علاوه بر این، استفاده از سرور ایمیل ورودی در Odoo این امکان را فراهم می‌کند که رکوردهای جدیدی در یک مدل مشخص ایجاد شود. هر سرور ایمیل ورودی می‌تواند رکوردهایی در یک مدل متفاوت ایجاد کند.

Example

ایمیل‌های دریافت‌شده در task@company-name.com توسط پایگاه داده اودوو دریافت می‌شوند. تمام ایمیل‌های دریافت‌شده یک وظیفه جدید پروژه در پایگاه داده ایجاد خواهند کرد.

طرح فنی مسیر ارسال ایمیل هنگام استفاده از دامنه سفارشی در Odoo.

رکورد MX

گزینه سوم این است که یک رکورد MX در ناحیه DNS خود ایجاد کنید که سرور ایمیلی را که ایمیل‌های ارسالی به دامنه شما را مدیریت می‌کند مشخص کند. دانش فنی پیشرفته مورد نیاز است.

مهم

این تنظیم فقط با یک زیر دامنه در زیرساخت Odoo Online یا Odoo.sh کار می‌کند (مثلاً @mail.mydomain.com)

در زیر برخی مشخصات بسته به نوع میزبانی ارائه شده‌اند:

زیردامنه سفارشی باید به پورتال Odoo شما اضافه شود.

حلقه‌های بی‌پایان ایمیل

در برخی موارد، حلقه‌های بی‌پایان ارسال ایمیل ممکن است ایجاد شوند. اودوو برخی محافظت‌ها در برابر چنین حلقه‌هایی فراهم می‌کند و اطمینان حاصل می‌کند که یک فرستنده نمی‌تواند تعداد زیادی ایمیل که منجر به ایجاد رکوردها شوند را در یک بازه زمانی مشخص به یک نام مستعار ارسال کند.

به طور پیش‌فرض، یک آدرس ایمیل می‌تواند تا ۲۰ ایمیل در ۱۲۰ دقیقه ارسال کند. اگر ایمیل‌های بیشتری ارسال شوند، مسدود می‌شوند و فرستنده پیام زیر را دریافت می‌کند:

ایمیل برگشتی پس از تلاش‌های متعدد برای تماس با یک نام مستعار دریافت شد.

برای تغییر رفتار پیش‌فرض، حالت توسعه‌دهنده را فعال کنید، سپس به تنظیمات ‣ فنی ‣ پارامترها: پارامترهای سیستم بروید تا دو پارامتر اضافه کنید.

  • برای اولین پارامتر، mail.gateway.loop.minutes را به عنوان کلید وارد کنید و یک عدد به دقیقه به عنوان مقدار انتخاب کنید (120 رفتار پیش‌فرض است).

  • برای پارامتر دوم، mail.gateway.loop.threshold را به عنوان کلید وارد کنید و یک عدد برای تعداد ایمیل‌ها به عنوان مقدار انتخاب کنید (به طور پیش‌فرض 20 است).

مهم

این پارامترها فقط برای جلوگیری از ایجاد رکوردهای جدید استفاده می‌شوند. آن‌ها از اضافه شدن پاسخ‌ها به چتر جلوگیری نمی‌کنند.

اجازه دادن به پارامتر سیستم دامنه مستعار

نام‌های مستعار ورودی در پایگاه داده Odoo تنظیم شده‌اند تا با دریافت ایمیل‌های ورودی، رکوردها ایجاد کنند. برای مشاهده نام‌های مستعار تنظیم‌شده در پایگاه داده Odoo، ابتدا حالت توسعه‌دهنده را فعال کنید. سپس به برنامه تنظیمات ‣ فنی ‣ نام‌های مستعار بروید.

پارامتر سیستمی زیر، mail.catchall.domain.allowed، که با مقادیر دامنه‌های مجاز برای نام مستعار تنظیم شده و با کاما جدا شده‌اند، ایمیل‌های ارسال شده به نام‌های مستعار را به درستی فیلتر می‌کند. تنظیم دامنه‌هایی که نام مستعار می‌تواند برای آنها یک تیکت، سرنخ، فرصت و غیره ایجاد کند، موارد مثبت کاذب را حذف می‌کند، جایی که فقط پیشوند نام مستعار ایمیل وجود دارد و دامنه موجود نیست.

در برخی موارد، تطابق‌هایی در پایگاه داده Odoo ایجاد شده است زمانی که یک ایمیل با همان پیشوند نام مستعار و دامنه‌ای متفاوت در آدرس ایمیل ورودی دریافت می‌شود. این موضوع در آدرس‌های ایمیل فرستنده، گیرنده و CC ایمیل ورودی صدق می‌کند.

Example

هنگامی که اودو ایمیل‌هایی با پیشوند commercial در آدرس فرستنده، گیرنده یا CC دریافت می‌کند (مثلاً commercial@example.com)، پایگاه داده به اشتباه ایمیل را به عنوان یک پیشوند کامل commercial با دامنه‌ای متفاوت در نظر می‌گیرد و در نتیجه، یک تیکت/سرنخ/فرصت و غیره ایجاد می‌کند.

برای افزودن پارامتر سیستمی mail.catchall.domain.allowed، ابتدا حالت توسعه‌دهنده را فعال کنید. سپس به برنامه تنظیمات ‣ فنی ‣ پارامترهای سیستمی بروید. روی جدید کلیک کنید. سپس در قسمت کلید عبارت mail.catchall.domain.allowed را وارد کنید.

سپس، برای فیلد مقدار، دامنه‌ها را با کاما جدا کنید. به صورت دستی (ذخیره کنید)، و پارامتر سیستم بلافاصله اعمال می‌شود.

پارامتر سیستمی mail.catchall.domain.allowed تنظیم شد.

تشخیص ورودی بر اساس بخش محلی

هنگام ایجاد یک نام مستعار جدید، گزینه‌ای برای فعال کردن تشخیص ورودی بر اساس قسمت محلی وجود دارد. اگر فعال شود، اودو فقط نیاز دارد که قسمت محلی برای مسیریابی یک ایمیل ورودی مطابقت داشته باشد. اگر این ویژگی غیرفعال شود، اودو نیاز دارد که کل آدرس ایمیل برای مسیریابی یک ایمیل ورودی مطابقت داشته باشد.