ارسال ایمیل با 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-شده |
AhaSend فقط STARTTLS را میپذیرد، نه SMTPS مستقیم. اگر کتابخانهٔ شما بهصورت پیشفرض روی پورت ۴۶۵ و SSL implicit تنظیم شده، آن را به STARTTLS روی یکی از پورتهای بالا تغییر دهید.
نامکاربری و رمز عبور SMTP را پشتیبانی نجوا در اختیارتان میگذارد — اینها با API Key متفاوتند (برای ارسال از طریق API به API Key نیاز دارید، نه این نامکاربری/رمز).
نمونهٔ کد
Python
import smtplibfrom email.mime.text import MIMETextmessage = 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 نگاه کنید.