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

يتيح ترحيل SMTP في Banger لأي تطبيق لا يستطيع الإرسال إلا عبر SMTP، مثل Supabase Auth أو Auth0 أو WordPress أو مرسِل إطار العمل، الإرسال عبر Banger. يسجّل تطبيقك الدخول بمفتاح Banger API، وتخرج كل رسالة من نطاقك وتظهر في السجلات.

قبل البدء

تحتاج إلى شيئين:

1. مسار المنتج. يجب أن يكون عنوان From على نطاق أو نطاق فرعي بمسار المنتج جاهز. افتح النطاقات › إضافة مسار، واختر المنتج، وأضف سجلات DNS المعروضة. راجع إضافة نطاقك. لا يمكن لمسار البريد (صناديق فريقك) أو مسار الحملة إرسال بريد التطبيق، فلا يؤثر بريد تطبيقك في سمعة صناديق فريقك.
2. مفتاح API يستطيع الإرسال. افتح مفاتيح API › إنشاء مفتاح API، وسمّه باسم التطبيق (مثل “Supabase Auth”)، وحدد mail:send فقط، واختر إنشاء مفتاح. انسخه فورًا: يظهر مرة واحدة.

يمكنك أيضًا الوصول إلى مفاتيح API من الإعدادات › المطوّرون › إدارة مفاتيح API.

إعدادات SMTP

يعرض مربع SMTP في صفحة مفاتيح API هذه الإعدادات، مع زر نسخ للمضيف.

إذا طلب تطبيقك “SSL” أو “TLS”، استخدم المنفذ 465. إذا طلب “STARTTLS”، استخدم 587.

ربط Supabase Auth

1. في Supabase، افتح Authentication › Emails › SMTP Settings وفعّل SMTP المخصص.
2. Sender email: عنوان على مسار المنتج، مثل noreply@app.example.com.
3. Sender name: اسم منتجك. يحتفظ به Banger كما كُتب.
4. Host submit.bangermail.com، Port 465، Username banger، Password مفتاح API لديك.
5. احفظ، ثم أرسل لنفسك رابطًا سحريًا من Authentication › Users.

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

التحقق من نجاحه

افتح السجلات. تظهر كل رسالة يرسلها تطبيقك مع SMTP كمصدر وحالة التسليم. يسجّل Banger أيضًا كل محاولة رفضها وما يجب إصلاحه.

يتلقى تطبيقك 250 2.0.0 Queued as … عندما يقبل Banger رسالة.

ما الذي يفعله Banger بكل رسالة؟

• يرسلها كما كتبها تطبيقك، باسم From لديك وموقّعة بمفتاح DKIM لنطاقك.
• يزيل Bcc وReturn-Path، ويضيف Reply-To يحمل عنوان From إذا لم يكن موجودًا.
• يتخطى المستلمين المحظورين ويرسل إلى البقية.
• يعامل إعادة محاولة الرسالة نفسها كالإرسال نفسه، فلا يسبب انتهاء المهلة إرسالها مرتين.
• يحتسب كل رسالة ضمن خطتك، مثل أي إرسال آخر.

يمكن أن يصل حجم كل رسالة إلى 10 MiB وعدد المستلمين إلى 50.

عند رفض رسالة

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

حماية المفتاح

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

جرّب مع الذكاء الاصطناعي

أنشئ مفتاح API يستطيع إرسال البريد فقط، وتحقق من جاهزية مسار المنتج لديّ، وأعطني إعدادات SMTP للصقها في Supabase.