يقدم هذا الدليل أمثلة مفصلة حول كيفية التكامل مع خدمة SMTP من Forward Email باستخدام لغات برمجة وأطر عمل وبرامج بريد إلكتروني متنوعة. صُممت خدمة SMTP لتكون موثوقة وآمنة وسهلة التكامل مع تطبيقاتك الحالية.

قبل الخوض في أمثلة التكامل، من المهم فهم كيفية معالجة خدمة SMTP الخاصة بنا لرسائل البريد الإلكتروني:

نظام قائمة انتظار البريد الإلكتروني وإعادة المحاولة

عند إرسال بريد إلكتروني عبر SMTP إلى خوادمنا:

1. المعالجة الأولية:تم التحقق من صحة البريد الإلكتروني وفحصه بحثًا عن البرامج الضارة والتحقق منه باستخدام مرشحات البريد العشوائي
2. قائمة انتظار ذكية:يتم وضع رسائل البريد الإلكتروني في نظام انتظار متطور للتسليم
3. آلية إعادة المحاولة الذكية:إذا فشل التسليم مؤقتًا، فسوف يقوم نظامنا بما يلي:
   • تحليل استجابة الخطأ باستخدام getBounceInfo وظيفة
   • تحديد ما إذا كانت المشكلة مؤقتة (على سبيل المثال، "حاول مرة أخرى لاحقًا"، "مؤجلة مؤقتًا") أو دائمة (على سبيل المثال، "مستخدم غير معروف")
   • بالنسبة للمشكلات المؤقتة، قم بتحديد البريد الإلكتروني لإعادة المحاولة
   • بالنسبة للمشكلات الدائمة، قم بإنشاء إشعار ارتداد
4. فترة إعادة المحاولة لمدة 5 أيام:نحاول إعادة التسليم لمدة تصل إلى 5 أيام (على غرار معايير الصناعة مثل Postfix)، مما يمنح المشكلات المؤقتة وقتًا للحل
5. إشعارات حالة التسليم:يتلقى المرسلون إشعارات حول حالة رسائل البريد الإلكتروني الخاصة بهم (تم التسليم أو التأخير أو الارتداد)

[!ملاحظة] بعد نجاح التسليم، يُحذف محتوى بريد SMTP الصادر بعد فترة احتفاظ قابلة للتخصيص (30 يومًا افتراضيًا) حفاظًا على الأمان والخصوصية. تبقى رسالة مؤقتة فقط تُشير إلى نجاح التسليم.

مُثبَّتة ضد الأخطاء لضمان الموثوقية

تم تصميم نظامنا للتعامل مع مختلف الحالات الحدية:

• إذا تم اكتشاف قائمة حظر، سيتم إعادة إرسال البريد الإلكتروني تلقائيًا
• في حالة حدوث مشكلات في الشبكة، سيتم إعادة محاولة التسليم
• إذا كان صندوق بريد المستلم ممتلئًا، فسيحاول النظام مرة أخرى لاحقًا
• إذا كان الخادم المتلقي غير متاح مؤقتًا، فسنستمر في المحاولة

يؤدي هذا النهج إلى تحسين معدلات التسليم بشكل كبير مع الحفاظ على الخصوصية والأمان.

استخدام Nodemailer

نوداميلر هي وحدة شائعة لإرسال رسائل البريد الإلكتروني من تطبيقات Node.js.

const nodemailer = require('nodemailer');
// Create a transporter object
const transporter = nodemailer.createTransport({
host: 'smtp.forwardemail.net',
port: 465,
secure: true, // Use TLS
auth: {
user: 'your-username@your-domain.com',
pass: 'your-password'
}
});
// Send mail with defined transport object
async function sendEmail() {
try {
const info = await transporter.sendMail({
from: '"Your Name" <your-username@your-domain.com>',
to: 'recipient@example.com',
subject: 'Hello from Forward Email',
text: 'Hello world! This is a test email sent using Nodemailer and Forward Email SMTP.',
html: '<b>Hello world!</b> This is a test email sent using Nodemailer and Forward Email SMTP.'
});
console.log('Message sent: %s', info.messageId);
} catch (error) {
console.error('Error sending email:', error);
}
}
sendEmail();
استخدام Express.js
فيما يلي كيفية دمج Forward Email SMTP مع تطبيق Express.js:
const express = require('express');
const nodemailer = require('nodemailer');
const app = express();
const port = 3000;
app.use(express.json());
// Configure email transporter
const transporter = nodemailer.createTransport({
host: 'smtp.forwardemail.net',
port: 465,
secure: true,
auth: {
user: 'your-username@your-domain.com',
pass: 'your-password'
}
});
// API endpoint for sending emails
app.post('/send-email', async (req, res) => {
const { to, subject, text, html } = req.body;
try {
const info = await transporter.sendMail({
from: '"Your App" <your-username@your-domain.com>',
to,
subject,
text,
html
});
res.status(200).json({
  success: true,
  messageId: info.messageId
});
} catch (error) {
console.error('Error sending email:', error);
res.status(500).json({
success: false,
error: error.message
});
}
});
app.listen(port, () => {
console.log(Server running at http://localhost:${port});
});