رابط برنامه‌نویسی Mailjet¶
اودو با API میل‌جت برای ارسال انبوه ایمیل سازگار است. یک سرور اختصاصی برای ارسال انبوه ایمیل از طریق میل‌جت با تنظیمات در حساب میل‌جت و پایگاه داده اودو راه‌اندازی کنید. در برخی موارد، تنظیمات باید در DNS دامنه سفارشی نیز پیکربندی شوند.
راه‌اندازی در Mailjet¶
ایجاد اطلاعات ورود API¶
برای شروع، به صفحه اطلاعات حساب Mailjet وارد شوید. سپس به بخش فرستندگان و دامنه‌ها بروید و روی تنظیمات SMTP و API ارسال کلیک کنید.
سپس تنظیمات پیکربندی SMTP را در یک نوت‌پد کپی کنید. این تنظیمات را می‌توانید در بخش پیکربندی (فقط SMTP) پیدا کنید. تنظیمات پیکربندی SMTP شامل آدرس سرور، گزینه امنیتی مورد نیاز (استفاده از SSL/TLS)، و شماره پورت است. این تنظیمات برای پیکربندی Mailjet در Odoo مورد نیاز هستند، که در بخش آخر پوشش داده شده است.
همچنین ببینید
میل‌جت: چگونه می‌توانم پارامترهای SMTP خود را تنظیم کنم؟ <https://documentation.mailjet.com/hc/articles/360043229473>
مهم
اودو پورت ۲۵ را مسدود می‌کند در پایگاه‌های داده اودو آنلاین و Odoo.sh.
سپس، روی دکمه‌ای با عنوان دریافت اطلاعات API شما کلیک کنید تا اطلاعات API Mailjet را دریافت کنید.
سپس، روی نماد چشم کلیک کنید تا کلید API نمایش داده شود. این کلید را در یک دفترچه یادداشت کپی کنید، زیرا این به عنوان نام کاربری در تنظیمات Odoo عمل می‌کند. سپس، روی دکمه تولید کلید محرمانه کلیک کنید تا کلید محرمانه تولید شود. این کلید را در یک دفترچه یادداشت کپی کنید، زیرا این به عنوان رمز عبور در تنظیمات Odoo عمل می‌کند.
افزودن نشانی‌های فرستنده تأیید شده¶
مرحله بعدی اضافه کردن یک آدرس فرستنده یا دامنه به تنظیمات حساب Mailjet است تا آدرس ایمیل یا دامنه برای ارسال ایمیل‌ها با استفاده از سرورهای Mailjet تأیید شود. ابتدا به صفحه اطلاعات حساب Mailjet بروید. سپس، روی لینک اضافه کردن دامنه یا آدرس فرستنده در بخش فرستندگان و دامنه‌ها کلیک کنید.
تعیین کنید که آیا نیاز است آدرس ایمیل فرستنده یا کل دامنه به تنظیمات Mailjet اضافه شود. اگر دسترسی به DNS وجود دارد، ممکن است پیکربندی کل دامنه آسان‌تر باشد. برای مراحل افزودن دامنه به بخش افزودن دامنه بروید.
توجه
یا باید تمام آدرس‌های ایمیل کاربران پایگاه داده Odoo که از سرورهای Mailjet برای ارسال ایمیل استفاده می‌کنند تنظیم شوند، یا دامنه(های) آدرس‌های ایمیل کاربران می‌تواند تنظیم شود.
به‌صورت پیش‌فرض، آدرس ایمیلی که در ابتدا در حساب Mailjet تنظیم شده است، به‌عنوان فرستنده مورد اعتماد اضافه می‌شود. برای افزودن آدرس ایمیل دیگر، روی دکمه با عنوان افزودن آدرس فرستنده کلیک کنید. سپس، آدرس ایمیلی را که برای ارسال از دامنه سفارشی تنظیم شده است، اضافه کنید.
حداقل آدرس‌های ایمیل زیر باید در ارائه‌دهنده تنظیم شده و در Mailjet تأیید شوند:
bounce@yourdomain.com
catchall@yourdomain.com
توجه
جایگزین کردن yourdomain با دامنه سفارشی برای پایگاه داده Odoo. اگر دامنه‌ای وجود ندارد، از پارامتر سیستمی mail.catchall.domain استفاده کنید.
سپس فرم اطلاعات ایمیل را پر کنید و مطمئن شوید که نوع ایمیل مناسب را انتخاب کرده‌اید: ایمیل تراکنشی یا ایمیل‌های انبوه. پس از تکمیل فرم، یک ایمیل فعال‌سازی به آدرس ایمیل ارسال می‌شود و فرستنده مورد اعتماد می‌تواند فعال شود.
توصیه می‌شود تنظیمات SPF/DKIM/DMARC را بر روی دامنه فرستنده تنظیم کنید.
همچنین ببینید
مستندات SPF/DKIM Mailjet <https://documentation.mailjet.com/hc/en-us/articles/360049641733-Authenticating-Domains-with-SPF-and-DKIM-A-Complete-Guide>
مستندات DMARC Mailjet <https://documentation.mailjet.com/hc/en-us/articles/20531905163419-Understanding-DMARC>`_
مهم
اگر پایگاه داده از دامنه سفارشی استفاده نمی‌کند، برای تأیید آدرس فرستنده، باید یک نام مستعار موقت (از سه آدرس ایمیل ذکر شده در بالا) در Odoo CRM تنظیم شود تا یک سرنخ ایجاد شود. سپس پایگاه داده قادر خواهد بود ایمیل تأیید را دریافت کرده و حساب‌ها را تأیید کند.
افزودن دامنه¶
با افزودن یک دامنه کامل به حساب کاربری Mailjet، تمامی آدرس‌های فرستنده مرتبط با آن دامنه به‌طور خودکار برای ارسال ایمیل از طریق سرورهای Mailjet تأیید می‌شوند. ابتدا به صفحه اطلاعات حساب کاربری Mailjet بروید. سپس روی لینک افزودن دامنه یا آدرس فرستنده در بخش فرستندگان و دامنه‌ها کلیک کنید. بعد از آن، روی افزودن دامنه کلیک کنید تا دامنه سفارشی اضافه شود.
توجه
دامنه باید به حساب Mailjet اضافه شود و سپس از طریق DNS تأیید شود.
سپس صفحه افزودن دامنه جدید در Mailjet را پر کنید و روی ادامه کلیک کنید.
پس از افزودن دامنه، صفحه اعتبارسنجی نمایش داده می‌شود. مگر اینکه پایگاه داده Odoo به صورت محلی باشد (در این صورت گزینه گزینه 1 را انتخاب کنید)، گزینه گزینه 2: ایجاد یک رکورد DNS را انتخاب کنید. اطلاعات رکورد TXT را کپی کرده و سپس به ارائه‌دهنده DNS دامنه بروید تا اعتبارسنجی را تکمیل کنید.
تنظیم در DNS دامنه¶
پس از دریافت اطلاعات رکورد TXT از حساب Mailjet، یک رکورد TXT به DNS دامنه اضافه کنید. این فرآیند بسته به ارائه‌دهنده DNS متفاوت است. برای فرآیندهای پیکربندی خاص با ارائه‌دهنده مشورت کنید. اطلاعات رکورد TXT شامل میزبان و مقدار است. این اطلاعات را در فیلدهای مربوطه در رکورد TXT وارد کنید.
بازگشت به اطلاعات حساب Mailjet¶
پس از افزودن رکورد TXT به DNS دامنه، به حساب Mailjet بازگردید. سپس به بروید، روی آیکون چرخ‌دنده کنار دامنه کلیک کنید و گزینه اعتبارسنجی را انتخاب کنید.
این اقدام همچنین می‌تواند با رفتن به صفحه دامنه‌ها و آدرس‌های فرستنده در اطلاعات حساب Mailjet و کلیک بر روی مدیریت انجام شود.
سپس روی اکنون بررسی کنید کلیک کنید تا رکورد TXT که به دامنه اضافه شده است، اعتبارسنجی شود. اگر دامنه به درستی پیکربندی شده باشد، صفحه موفقیت ظاهر خواهد شد.
پس از تنظیم موفقیت‌آمیز دامنه، گزینه‌ای وجود دارد به نام احراز هویت این دامنه (SPF/DKIM). این دکمه رکوردهای SPF و DKIM را برای وارد کردن در ارائه‌دهنده DNS ایجاد می‌کند.
همچنین ببینید
راه‌اندازی در Odoo¶
برای تکمیل تنظیمات، به پایگاه داده Odoo بروید و به تنظیمات مراجعه کنید. با فعال بودن حالت توسعه‌دهنده، به بروید. سپس با کلیک بر روی دکمه ایجاد، یک پیکربندی جدید برای سرور خروجی ایجاد کنید.
سپس، سرور SMTP (in-v3.mailjet.com)، شماره پورت (587 یا 465) و امنیت (SSL/TLS) که قبلاً از حساب Mailjet کپی شده بود را وارد کنید. این اطلاعات همچنین می‌توانند اینجا یافت شوند. توصیه می‌شود از SSL/TLS استفاده کنید، حتی اگر Mailjet ممکن است آن را الزامی نکند.
برای نام کاربری، کلید API را وارد کنید. برای رمز عبور، کلید SECRET را وارد کنید که قبلاً از حساب Mailjet به دفترچه یادداشت کپی شده است. این تنظیمات را می‌توانید در پیدا کنید.
سپس، اگر سرور Mailjet برای ارسال ایمیل‌های انبوه استفاده می‌شود، مقدار اولویت را بالاتر از هر سرور ایمیل تراکنشی تنظیم کنید. در نهایت، تنظیمات را ذخیره کرده و اتصال را آزمایش کنید.
