إرسال البريد عبر SMTP

الإعدادات

قبل البدء

1. أنشئ مفتاح API. في تطبيق Banger، افتح الإعدادات → المطورون → إدارة مفاتيح API، واختر إنشاء مفتاح API، وحدد mail:send وانسخ المفتاح: يظهر مرة واحدة. تعرض الصفحة إعدادات SMTP هذه بجوار مفاتيحك.
2. أرسل من مسار منتج. يجب أن يكون عنوان From على اسم مضيف ذي مسار منتج نشط، وهو مسار الإيصالات والتنبيهات والبريد الآخر من تطبيقك. في النطاقات، اختر إضافة مسار ثم المنتج وأضف سجلات DNS المدرجة. لا يحمل مسار Mail (صناديق فريقك) أو مسار حملة بريد التطبيقات، لذا لا يستطيع بريد تطبيقك التأثير في سمعة صندوق وارد فريقك.

مثال: Supabase Auth

في مشروع Supabase، افتح Authentication → Emails → SMTP Settings وفعّل SMTP المخصص:

احفظ، ثم أرسل رابط دخول من Authentication → Users للتحقق من وصوله.

مثال: Node.js

import nodemailer from "nodemailer";

const transport = nodemailer.createTransport({
  host: "submit.bangermail.com",
  port: 465,
  secure: true,
  auth: { user: "banger", pass: process.env.BANGER_API_KEY },
});

await transport.sendMail({
  from: "Acme <noreply@app.example.com>",
  to: "person@example.com",
  subject: "Your receipt",
  html: "<p>Thanks for your order.</p>",
});

للاختبار من طرفية باستخدام swaks:

swaks --server submit.bangermail.com:465 --tls-on-connect \
  --auth PLAIN --auth-user banger --auth-password "$BANGER_API_KEY" \
  --from noreply@app.example.com --to you@example.com

ما يحدث لكل رسالة

• يسلّم Banger الرسالة كما كتبها تطبيقك، باسم From الخاص بك، موقّعة بمفتاح DKIM لنطاقك ومرسلة من نطاق الارتداد لمسار المنتج لديك.
• يزيل Bcc وReturn-Path وترويسات Banger الخاصة، ويضيف Reply-To يحدد عنوان From عند غيابه.
• يُفحص كل مستلم عند RCPT TO: يُرفض العنوان المستبعد وحده ويُرسل إلى الآخرين.
• يمكن أن تصل الرسالة إلى 10 MiB مع حتى 50 مستلمًا.
• تجعل ترويسة Idempotency-Key إعادة المحاولة الإرسال نفسه. وبدونها تُعرَف أيضًا إعادة محاولة الرسالة والمستلمين أنفسهم.
• تظهر كل رسالة في السجلات مع SMTP كمصدر، وتُحتسب ضمن خطتك كأي إرسال آخر.

الردود والأخطاء

يذكر الرفض سببه ويحمل مرجعًا، (ref …)، يطابق الإدخال في السجلات. الرموز التي تبدأ بـ4 مؤقتة: يمكن لتطبيقك إعادة المحاولة لاحقًا.

الأمان

• يخزن Banger بصمة كل مفتاح فقط. اسحب مفتاحًا أو دوّره في إدارة مفاتيح API؛ تُرفض عملاء SMTP التي تستخدمه عند دخولها التالي.
• خصص لـSMTP مفتاحًا مستقلًا مع mail:send فقط، كي لا تستطيع كلمة مرور مسرّبة قراءة مساحتك.
• تُحدّ محاولات الدخول الفاشلة لكل شبكة عميل ولكل مفتاح، ويُسجّل الدخول المرفوض بأحد مفاتيحك في السجلات.

تفضّل HTTP؟ يتوفر الإرسال نفسه عبر Banger API.