محصول
امکانات قیمت‌گذاری
منابع
مستندات آموزش ابزارهای رایگان سؤالات متداول وضعیت سرویس
شرکت
درباره تماس با ما
خانه ‹ مستندات

مستنداتِ میلرینو

هرچه برای اتصال و ارسالِ ایمیل لازم داری — از تنظیماتِ SMTP و کلیدِ API تا احرازِ دامنه و وب‌هوک. همه با نمونه‌کدِ آماده.

شروعِ سریع

در چهار قدم، اولین ایمیلت را بفرست.

۱
حساب بساز و وارد شودر app.mailerino.com ثبت‌نام کن. ۱۰۰۰ ایمیلِ اول رایگان است.
۲
دامنه‌ات را تأیید کنسه رکوردِ DNS (SPF، DKIM، DMARC) را اضافه کن تا از آدرسِ دامنهٔ خودت بفرستی.
۳
اعتبارنامه یا کلید بسازبرای SMTP یک «اعتبارنامهٔ SMTP» و برای API یک «کلیدِ فقط‌ارسال» بساز.
۴
اولین ایمیل را بفرستبا نمونه‌کدهای پایین، با SMTP یا API ارسال کن.
یادت باشد: آدرسِ فرستنده باید روی دامنه‌ای باشد که در «دامنه‌های ارسال» تأیید کرده‌ای؛ وگرنه ارسال رد می‌شود.

ارسال با SMTP

این مقادیر را در هر برنامه‌ای که SMTP می‌پذیرد (وردپرس، لاراول، اسکریپت‌ها و…) وارد کن.

پارامترمقدار
سرور (Host)smtp.mailerino.com
پورت587 (STARTTLS) — یا 2525
نام کاربرینام‌کاربریِ اعتبارنامهٔ SMTP
گذرواژهگذرواژهٔ اعتبارنامهٔ SMTP
رمزنگاریSTARTTLS
بعضی هاست‌های ایرانی پورتِ ۵۸۷ را می‌بندند — اگر وصل نشد، پورتِ ۲۵۲۵ را امتحان کن.

نمونه‌کد

import nodemailer from "nodemailer";

const t = nodemailer.createTransport({
  host: "smtp.mailerino.com",
  port: 587,
  auth: { user: "YOUR_SMTP_USER", pass: "YOUR_SMTP_PASS" },
});

await t.sendMail({
  from: "no-reply@yourdomain.ir",
  to:   "user@example.com",
  subject: "کد ورود",
  text: "کد شما: ۸۴۲۱۹",
});
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = "smtp.mailerino.com";
$mail->Port = 587;
$mail->SMTPAuth = true;
$mail->Username = "YOUR_SMTP_USER";
$mail->Password = "YOUR_SMTP_PASS";
$mail->setFrom("no-reply@yourdomain.ir");
$mail->addAddress("user@example.com");
$mail->Subject = "کد ورود";
$mail->Body = "کد شما: ۸۴۲۱۹";
$mail->send();
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "no-reply@yourdomain.ir"
msg["To"] = "user@example.com"
msg["Subject"] = "کد ورود"
msg.set_content("کد شما: ۸۴۲۱۹")

with smtplib.SMTP("smtp.mailerino.com", 587) as s:
    s.starttls()
    s.login("YOUR_SMTP_USER", "YOUR_SMTP_PASS")
    s.send_message(msg)
# فایل .env پروژهٔ لاراول
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailerino.com
MAIL_PORT=587
MAIL_USERNAME=YOUR_SMTP_USER
MAIL_PASSWORD=YOUR_SMTP_PASS
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=no-reply@yourdomain.ir

ارسال با API

برای ارسالِ مستقیم با HTTP، یک کلیدِ فقط‌ارسال از پنل بساز و در هدرِ Authorization بگذار.

POST  https://api.mailerino.com/v1/send

فیلدهای بدنه

فیلدنوعتوضیح
from الزامیstringآدرسِ فرستنده روی دامنهٔ تأییدشده.
to الزامیstringایمیلِ گیرنده.
subject الزامیstringموضوعِ ایمیل.
text اختیاریstringمتنِ ساده.
html اختیاریstringنسخهٔ HTML.
replyTo اختیاریstringآدرسِ پاسخ.

درخواست

curl -X POST https://api.mailerino.com/v1/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "no-reply@yourdomain.ir",
    "to": "user@example.com",
    "subject": "کد ورود",
    "text": "کد شما: ۸۴۲۱۹"
  }'
const res = await fetch("https://api.mailerino.com/v1/send", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    from: "no-reply@yourdomain.ir",
    to:   "user@example.com",
    subject: "کد ورود",
    text: "کد شما: ۸۴۲۱۹",
  }),
});
$ch = curl_init("https://api.mailerino.com/v1/send");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "from" => "no-reply@yourdomain.ir",
    "to" => "user@example.com",
    "subject" => "کد ورود",
    "text" => "کد شما: ۸۴۲۱۹",
  ]),
  CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);

پاسخ — 200 OK

{
  "id": "msg_8f2a91c4",
  "status": "queued"
}

کدِ id همان کدِ پیگیری است؛ وضعیتِ بعدیِ ایمیل را در «لاگِ رویدادها» یا با وب‌هوک دنبال کن.

احرازِ دامنه

تا از آدرسِ دامنهٔ خودت (مثلِ no-reply@yourdomain.ir) بفرستی، باید دامنه را تأیید کنی. در پنل به «دامنه‌ها» برو، دامنه را اضافه کن و سه رکوردِ زیر را در DNS بگذار:

رکوردکارکرد
SPFاعلام می‌کند ارسال از طرفِ میلرینو مجاز است.
DKIMامضای دیجیتالِ ایمیل‌ها برای صحت.
DMARCسیاستِ برخورد با ایمیل‌های جعلی.

بعد از افزودنِ رکوردها، تأیید به‌صورتِ خودکار انجام می‌شود (انتشارِ DNS گاهی تا چند ساعت طول می‌کشد).

تأییدِ SPF و DKIM به رسیدنِ ایمیل‌هایت کمک می‌کند. دامنه‌ای که تأیید نشده باشد، اجازهٔ ارسال ندارد.

وب‌هوک

با وب‌هوک، هر رویدادِ ایمیل همان لحظه به آدرسی که تعیین می‌کنی POST می‌شود تا سیستمت بلافاصله باخبر شود. رویدادها:

  • sent — ایمیل ارسال شد.
  • delivered — به سرورِ گیرنده تحویل شد.
  • opened / clicked — باز یا کلیک شد.
  • bounced / complained — بازگشت یا شکایت (خودکار به لیستِ تعلیق می‌رود).

نمونهٔ payload

{
  "event": "delivered",
  "email": "user@example.com",
  "messageId": "msg_8f2a91c4",
  "timestamp": "2026-06-17T12:04:21Z"
}

کدهای خطا

در صورتِ خطا، پاسخ با کدِ وضعیتِ مناسب و یک پیامِ فارسی برمی‌گردد.

وضعیتکدمعنی
400validationاطلاعاتِ ارسال‌شده معتبر نیست؛ مقادیر را بررسی کن.
401invalid_api_keyکلیدِ API نامعتبر است یا منقضی شده است.
402insufficient_creditsاعتبارِ حساب برای این عملیات کافی نیست.
403forbiddenاین کلید اجازهٔ این عملیات را ندارد.
422domain_not_verifiedدامنهٔ فرستنده هنوز تأیید نشده است.
429rate_limitedتعدادِ درخواست‌ها بیش از حدِ مجاز است؛ کمی بعد دوباره تلاش کن.
503server_errorسرویس موقتاً در دسترس نیست؛ کمی بعد دوباره تلاش کن.

محدودیت‌ها

  • سقفِ ارسالِ روزانه: به‌صورتِ پیش‌فرض ۱۰۰۰ ایمیل در روز؛ با رشدِ حساب قابلِ افزایش است.
  • محدودیتِ نرخ: درخواست‌های API نرخِ معقولی دارند؛ در صورتِ عبور، پاسخِ 429 می‌گیری.
  • فرستنده: آدرسِ فرستنده فقط روی دامنهٔ تأییدشده مجاز است.
  • اعتبار: برای هر ارسال باید اعتبارِ کافی در حساب باشد.
سؤالِ بیشتری داری؟ تیمِ پشتیبانیِ فارسی از طریقِ پنل و صفحهٔ تماس همراهت است.