تكامل SMTP

استخدم أي عميل أو تطبيق أو جهاز SMTP. انسخ قيم الاتصال من لوحة التحكم وفعّل TLS.

تفاصيل الاتصال

استخدم دائمًا اتصالًا مشفرًا. صادِق باسم مستخدم SMTP ومفتاح API ككلمة مرور. انسخ المضيف واسم المستخدم بدقة من صفحة SMTP في لوحة التحكم؛ والقيم أدناه توضح الشكل فقط.

Host:     YOUR_SMTP_HOST
Port:     587 (STARTTLS) or 465 (implicit TLS)
Username: YOUR_SMTP_USERNAME
Password: YOUR_API_KEY

أي منفذ تستخدم

المنفذ 587 مع STARTTLS هو منفذ الإرسال القياسي وأفضل خيار افتراضي. المنفذ 465 يستخدم TLS منذ أول بايت ويناسب العملاء الذين يتوقعون ذلك. تجنب المنفذ 25 للإرسال: فهو مخصص للبريد بين الخوادم وتحجبه شركات استضافة كثيرة.

اختبر من سطر الأوامر

تأكد من المصادقة قبل ربط تطبيقك. يرسل swaks رسالة اختبار؛ ويعرض openssl مصافحة TLS إن حدث خلل.

swaks --to you@example.com --from hello@example.com \
  --server YOUR_SMTP_HOST:587 --tls \
  --auth LOGIN --auth-user YOUR_SMTP_USERNAME

openssl s_client -starttls smtp -connect YOUR_SMTP_HOST:587

مثال: Node.js (Nodemailer)

يعمل Nodemailer مع أي خدمة SMTP. احتفظ ببيانات الاعتماد في متغيرات البيئة.

const nodemailer = require("nodemailer");
const transport = nodemailer.createTransport({
  host: process.env.SMTP_HOST,
  port: 587,
  secure: false, // STARTTLS
  auth: { user: process.env.SMTP_USER, pass: process.env.MIGOSMTP_KEY },
});
await transport.sendMail({ from, to, subject, text });

مثال: Python (smtplib)

تكفي المكتبة القياسية لإرسال بسيط.

import os, smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"], msg["To"], msg["Subject"] = "hello@example.com", "you@example.com", "Hello"
msg.set_content("It works.")
with smtplib.SMTP(os.environ["SMTP_HOST"], 587) as s:
    s.starttls()
    s.login(os.environ["SMTP_USER"], os.environ["MIGOSMTP_KEY"])
    s.send_message(msg)

ترويسات يُنصح بضبطها

عيّن Reply-To إذا كان يجب أن تذهب الردود إلى غير عنوان المرسل. للبريد الجماعي أو التسويقي أضف ترويسة List-Unsubscribe التي يبحث عنها مزودو صناديق البريد. استخدم عنوان مرسل على نطاق موثّق، وإلا قد تُرفض الرسالة.

نتائج التسليم

لا يخبرك SMTP إلا بأن الرسالة قُبلت. لمعرفة ما إذا سُلّمت أو ارتدّت أو أُبلغ عنها كبريد مزعج، استخدم webhooks أو عرض النشاط في لوحة التحكم.