การอนุมัติ บันทึก และการส่ง
ส่งอีเมลผ่าน SMTP
เชื่อมต่อ Supabase Auth, WordPress หรือแอปที่ใช้ SMTP กับ Banger เพื่อส่งจากโดเมนของคุณและดูในบันทึก
ในคู่มือนี้ 8 ส่วน
SMTP relay ของ Banger ให้แอปที่ส่งได้เฉพาะ SMTP เช่น Supabase Auth, Auth0, WordPress หรือตัวส่งอีเมลของเฟรมเวิร์ก ส่งผ่าน Banger แอปเข้าสู่ระบบด้วยคีย์ API ของ Banger ทุกข้อความส่งจากโดเมนของคุณและปรากฏใน บันทึก
ก่อนเริ่ม
ต้องมีสองอย่าง:
- ช่องทางผลิตภัณฑ์ ที่อยู่ From ต้องอยู่บนโดเมนหรือโดเมนย่อยที่มีช่องทางผลิตภัณฑ์พร้อม เปิด โดเมน › เพิ่มช่องทางการส่ง เลือก ผลิตภัณฑ์ แล้วเพิ่มระเบียน DNS ที่แสดง ดูเพิ่มโดเมน ช่องทางอีเมล (กล่องจดหมายทีม) หรือแคมเปญส่งอีเมลแอปไม่ได้ จึงไม่กระทบชื่อเสียงกล่องจดหมายทีม
- คีย์ API ที่ส่งได้ เปิด คีย์ API › สร้างคีย์ API ตั้งชื่อตามแอป (เช่น “Supabase Auth”) เลือกเฉพาะ
mail:sendแล้ว สร้างคีย์ คัดลอกทันที เพราะแสดงครั้งเดียว
เข้า คีย์ API จาก การตั้งค่า › นักพัฒนา › จัดการคีย์ API ได้ด้วย
การตั้งค่า SMTP
กล่อง SMTP บนหน้า คีย์ API แสดงการตั้งค่าเหล่านี้ พร้อมปุ่มคัดลอกโฮสต์
| การตั้งค่า | ค่า |
|---|---|
| โฮสต์ | submit.bangermail.com |
| พอร์ต | 465 (TLS) หรือ 587 (STARTTLS) |
| พอร์ต หากพอร์ตข้างต้นถูกบล็อก | 2465 (TLS) หรือ 2587 (STARTTLS) |
| ชื่อผู้ใช้ | banger (ใช้ค่าใดก็ได้ คีย์ระบุพื้นที่ทำงาน) |
| รหัสผ่าน | คีย์ API ของคุณ |
| การเข้ารหัส | TLS 1.2 ขึ้นไป เข้าสู่ระบบได้หลังเริ่ม TLS เท่านั้น |
| การยืนยันตัวตน | PLAIN หรือ LOGIN |
หากแอปถาม “SSL” หรือ “TLS” ใช้พอร์ต 465 หากถาม “STARTTLS” ใช้ 587
เชื่อมต่อ Supabase Auth
- ใน Supabase เปิด Authentication › Emails › SMTP Settings แล้วเปิด SMTP แบบกำหนดเอง
- อีเมลผู้ส่ง: ที่อยู่บนช่องทางผลิตภัณฑ์ เช่น
noreply@app.example.com - ชื่อผู้ส่ง: ชื่อผลิตภัณฑ์ Banger เก็บตามที่เขียน
- Host
submit.bangermail.com, Port465, Usernamebanger, Password คีย์ API - บันทึก แล้วส่ง magic link ถึงตัวเองจาก 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 เป็นปัญหาชั่วคราว แอปลองใหม่ภายหลังได้
| คำตอบ | สิ่งที่ต้องทำ |
|---|---|
535 5.7.8 | รหัสผ่านไม่ใช่คีย์ API ที่ใช้งานได้ ตรวจว่าไม่ถูกเพิกถอนและมี mail:send |
421 4.7.0 | เข้าสู่ระบบล้มเหลวสามครั้งในการเชื่อมต่อเดียวจึงปิด แก้คีย์ก่อนลองใหม่ |
454 4.7.0 | เข้าสู่ระบบล้มเหลวมากเกินจากเครือข่าย แก้คีย์แล้วรอได้ถึงหนึ่งชั่วโมง |
550 5.7.1 | โดเมน From ไม่มีช่องทางผลิตภัณฑ์พร้อม (คำตอบระบุสิ่งที่ขาด) ผู้รับถูกระงับ หรือหยุดส่ง ดูอัตราการส่งถึงและการหยุดส่ง |
553 5.1.3 | ที่อยู่ผู้รับไม่ถูกต้อง |
552 5.3.4 | ข้อความใหญ่กว่า 10 MiB |
554 5.6.0 | ข้อความผิดรูปแบบ เช่น มีส่วนหัว From สองรายการ หรือ From มีหลายที่อยู่ |
451 4.7.0 | ใช้โควตาการส่งหรือขีดจำกัดรายวันหมดแล้ว ต่ออายุในรอบหรือวันถัดไป หรือทันทีเมื่ออัปเกรด |
451 4.3.0 | Banger รับข้อความตอนนี้ไม่ได้ แอปควรลองใหม่ |
เก็บคีย์ให้ปลอดภัย
- ให้แต่ละแอปมีคีย์ของตัวเองที่มีเฉพาะ
mail:sendรหัสผ่าน SMTP ที่รั่วจึงอ่านพื้นที่ทำงานไม่ได้ - เปลี่ยนคีย์โดยสร้างใหม่ อัปเดตแอป แล้ว เพิกถอน คีย์เก่า แอปที่ยังใช้คีย์เก่าถูกปฏิเสธเมื่อเข้าสู่ระบบครั้งถัดไป
- Banger เก็บเฉพาะแฮชของคีย์ และบันทึกการเข้าสู่ระบบที่ปฏิเสธใน บันทึก
ลองใช้กับ AI
สร้างคีย์ API ที่ส่งอีเมลได้อย่างเดียว ตรวจช่องทางผลิตภัณฑ์ว่าพร้อม และให้การตั้งค่า SMTP เพื่อวางใน Supabase