رفتن به محتوای اصلی

ارسال ایمیل با SMTP

سرویس ایمیل نجوا از طریق AhaSend ارائه می‌شود. آدرس سرور، تنظیمات اتصال و کدهای خطای SMTP را اینجا ببینید.


سرویس ایمیل نجوا روی زیرساخت AhaSend پیاده شده — یعنی برای ارسال ایمیل تراکنشی، مستقیماً به سرور SMTP آن‌ها وصل می‌شوید، نه سروری با دامنهٔ najva.com.

این یعنی چه؟

فعلاً امکان ساخت مستقیم حساب در AhaSend برای مشتریان نجوا وجود ندارد. دسترسی به این سرویس از طریق پنل اصلی نجوا داده می‌شود — برای فعال‌سازی با پشتیبانی نجوا تماس بگیرید تا Credential لازم (نام‌کاربری و رمز SMTP) در اختیارتان قرار بگیرد.

آدرس سرورها

AhaSend دو سرور SMTP در دو منطقه دارد؛ نزدیک‌ترین را بر اساس محل عمدهٔ گیرندگان انتخاب کنید:

سرورهاستمنطقه
اروپا (پیش‌فرض)send.ahasend.comآلمان
آمریکاsend-us.ahasend.comاورگان

هر دو سرور از نظر امکانات و کیفیت تحویل یکسان‌اند؛ فقط تأخیر شبکه فرق می‌کند.

تنظیمات اتصال

موردمقدار
پورت‌ها25، 587، 2525
رمزنگاریSTARTTLS (اجباری)
احراز هویتPLAIN، روی همان اتصال STARTTLS-شده
پورت ۴۶۵ (SMTPS) پشتیبانی نمی‌شود

AhaSend فقط STARTTLS را می‌پذیرد، نه SMTPS مستقیم. اگر کتابخانهٔ شما به‌صورت پیش‌فرض روی پورت ۴۶۵ و SSL implicit تنظیم شده، آن را به STARTTLS روی یکی از پورت‌های بالا تغییر دهید.

نام‌کاربری و رمز عبور SMTP را پشتیبانی نجوا در اختیارتان می‌گذارد — این‌ها با API Key متفاوتند (برای ارسال از طریق API به API Key نیاز دارید، نه این نام‌کاربری/رمز).

نمونهٔ کد

Python

import smtplib
from email.mime.text import MIMEText
message = MIMEText("این ایمیل با SMTP نجوا/AhaSend ارسال شده است.")
message["Subject"] = "تست ارسال ایمیل"
message["From"] = "no-reply@yourdomain.com"
message["To"] = "user@example.com"
with smtplib.SMTP("send.ahasend.com", 587) as server:
server.starttls()
server.login("YOUR_SMTP_USERNAME", "YOUR_SMTP_PASSWORD")
server.send_message(message)

Node.js (با nodemailer)

import nodemailer from 'nodemailer'
const transporter = nodemailer.createTransport({
host: 'send.ahasend.com',
port: 587,
secure: false, // چون از STARTTLS استفاده می‌کنیم، نه SMTPS
auth: {
user: process.env.SMTP_USERNAME,
pass: process.env.SMTP_PASSWORD,
},
})
await transporter.sendMail({
from: 'no-reply@yourdomain.com',
to: 'user@example.com',
subject: 'تست ارسال ایمیل',
text: 'این ایمیل با SMTP نجوا/AhaSend ارسال شده است.',
})

کدهای پاسخ SMTP

کدمعنیکاری که باید بکنید
250پیام با موفقیت در صف تحویل قرار گرفت
421سرویس موقتاً در دسترس نیست (اتصال بی‌کار قطع شده یا بار زیاد سرور)با backoff نمایی دوباره تلاش کنید
451خطای موقت داخلی سروردوباره تلاش کنید
500نام‌کاربری یا رمز عبور نادرست استبا پشتیبانی نجوا تماس بگیرید تا Credential را بررسی کنند
521حساب غیرفعال یا اعتبار آن تمام شدهبا پشتیبانی نجوا تماس بگیرید
552فرمت پیام نامعتبر استساختار هدرها و بدنهٔ ایمیل را بررسی کنید
553دامنهٔ گیرنده مشکوک/موقتی تشخیص داده شده (فقط اگر «Recipient Shields» را در تنظیمات حساب روشن کرده باشید)صحت دامنهٔ گیرنده را بررسی کنید
556حساب یا دامنهٔ ارسال‌کننده هنوز تنظیم نشدهبا پشتیبانی نجوا تماس بگیرید تا دامنهٔ ارسال تأیید شود

نکات امنیتی

  • همیشه از STARTTLS استفاده کنید؛ اتصال رمزنگاری‌نشده، هم Credential و هم محتوای ایمیل را افشا می‌کند.
  • نام‌کاربری/رمز SMTP را در متغیر محیطی نگه دارید، نه داخل کد.
  • رکوردهای SPF، DKIM و DMARC دامنهٔ ارسال‌کننده را تنظیم کنید — بدون این‌ها، بسیاری از سرویس‌های ایمیل پیام شما را اسپم علامت می‌زنند.

گام بعدی

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