ارائه دهنده خدمات ابری PaaS و DBaaS

ایمیل

(Transactional Email)

با استفاده از سرویس ایمیل لیارا، می‌توانید اقدام به ارسال ایمیل‌های تراکنشی، در برنامه‌های خود، از طریق دسترسی SMTP کنید.
ایمیل های تراکنشی Transactional Email، به ایمیل‌هایی گفته می‌شود که در پاسخ به یک عمل ارسال می‌گردد. به‌طور مثال ایمیل تأیید ثبت نام، فراموشی رمز عبور، فاکتور و سایر موارد مشابه. به‌طورکلی ایمیل‌هایی که درنتیجه یک عمل و تراکنش و به خواست دریافت‌کننده ارسال شود و محتوای هر ایمیل برای هر شخص متفاوت باشد، ایمیل تبادلی گفته می‌شود.

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

برای ایجاد سرویس ایمیل، با مراجعه به بخش «برنامه‌ها» و بعد از انتخاب برنامه مورد نظر، از فهرست سمت راست، بر روی گزینه ایمیل کلیک کنید.

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

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

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

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

بعد از ایجاد رکوردهای ارائه شده، بر روی دکمه "بروزرسانی وضعیت رکوردها" کلیک کنید. در صورتی که تمامی رکوردها را به درستی ایجاد کرده باشید، به صندوق ورودی سرویس ایمیل، منتقل می‌شوید. اگر هم از ایجاد سرویس ایمیل منصرف شدید، انتخاب دامنه اشتباه و یا هر دلیل دیگری، می‌توانید بر روی دکمه انصراف کلیک کنید.

در فهرست سمت راست، چهار گزینه وجود دارد:

۱. ارسال ایمیل

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

۲. صندوق ورودی

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

۳. ارسال شده‌ها

این قسمت شامل لیست ایمیل‌های ارسال شده از سرویس ایمیل، به همراه درصد اسپم بودن این ایمیل و وضعیت ارسال ایمیل است، که با کلیک بر روی هر کدام می‌توانید محتویات آن، به همراه اطلاعات بیشتر در رابطه با وضعیت ارسال ایمیل، مشاهده کنید.

۴. تنظیمات

این بخش نیز به چندین قسمت تقسیم می‌شود که هرکدام را جداگانه بررسی می‌کنیم:

۱. افزودن نشانی

در این قسمت می‌توانید برای سرویس ایمیل‌تان، نشانی‌های بیشتری ایجاد کنید. در حال حاضر تعداد مجاز نشانی، ۱۰ عدد است.

۲. دسترسی SMTP

این قسمت شامل اطلاعات لازم برای استفاده از دسترسی SMTP می‌شود. در ادامه نحوه استفاده از این دسترسی را در برنامه‌های مختلف را خواهیم گفت.

۳. رکوردهای DNS

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

۴. حذف سرویس ایمیل

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

درصد اسپم بودن ایمیل

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

استفاده از دسترسی SMTP

توجه داشته باشید که مقادیر موجود برای متغیر‌های محیطی مثال هستند و نیاز است تا آن‌ها را با مقادیر ارائه شده در تنظیمات سرویس ایمیل‌تان، جایگزین کنید.
برای استفاده از دسترسی SMTP سرویس ایمیل، برای ENCRYPTION تنها باید از tls استفاده کنید. به عبارتی به تنها به صورت ایمن می‌توانید از این دسترسی استفاده کنید و هیچ جای نگرانی برای شما، باقی نمی‌ماند.
در ارسال ایمیل توسط SMTP، فیلد from تنها می‌تواند یکی از نشانی‌هایی باشد که برای سرویس ایمیل ایجاد کرده‌اید.

NodeJS

برای استفاده از دسترسی SMTP در NodeJS، ابتدا توسط دستور زیر پکیج nodemailer را نصب کنید.

npm install nodemailer

بعد از نصب این پکیج، می‌توانید متغیر‌های محیطی مربوط به دسترسی SMTP را در قسمت تنظیمات برنامه اضافه کنید.

MAIL_HOST=smtp.liara.ir
MAIL_PORT=587
MAIL_USER=my-app
MAIL_PASSWORD=87b9307a-dae9-410e-89a2-e77de60e4885

سپس همانند مثال زیر می‌توانید اقدام به ارسال ایمیل، توسط دسترسی SMTP کنید:

const nodemailer = require("nodemailer");
const MAIL_HOST = process.env.MAIL_HOST;
const MAIL_PORT = process.env.MAIL_PORT;
const MAIL_USER = process.env.MAIL_USER;
const MAIL_PASSWORD = process.env.MAIL_PASSWORD;

const transporter = nodemailer.createTransport({
  host: MAIL_HOST,
  port: MAIL_PORT,
  tls: true,
  auth: {
    user: MAIL_USER,
    pass: MAIL_PASSWORD,
  }
});

await transporter.sendMail({
  from: 'from@example.com',
  to: 'to@example.com',
  subject: 'Test Email Subject',
  html: '<h1>Example HTML Message Body</h1>'
});

برای اطلاعات بیشتر به مستندات پکیج nodemailer مراجعه کنید.

Laravel

برای استفاده از دسترسی SMTP در برنامه‌های Laravel، نیاز است که متغیر‌های محیطی زیر را در قسمت تنظیمات برنامه، ایجاد کنید، تا بتوانید از این دسترسی در برنامه‌تان استفاده کنید.

MAIL_DRIVER=smtp
MAIL_HOST=smtp.liara.ir
MAIL_PORT=587
MAIL_USERNAME=my-app
MAIL_PASSWORD=87b9307a-dae9-410e-89a2-e77de60e4885
MAIL_ENCRYPTION=tls

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

Django

برای استفاده از دسترسی SMTP در برنامه‌های Django نیاز است که متغیر‌های محیطی زیر را در قسمت تنظیمات برنامه، ایجاد و از آن‌ها در فایل settings.py استفاده کنید، تا بتوانید از این دسترسی در برنامه‌تان بهره ببرید.

EMAIL_BACKEND = ‘django.core.mail.backends.smtp.EmailBackend’
EMAIL_HOST=smtp.liara.ir
EMAIL_PORT=587
EMAIL_HOST_USER=my-app
EMAIL_HOST_PASSWORD=87b9307a-dae9-410e-89a2-e77de60e4885
EMAIL_USE_TLS=True

تکه کد زیر، نمونه ارسال ایمیل توسط Django است:

from django.core.mail import send_mail
send_mail('Subject here', 'Here is the message.', 'from@example.com', ['to@example.com'], fail_silently=False)

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

پیوست‌ها

به زودی این قابلیت به ایمیل‌ها اضافه می‌شود.