אישורים, יומנים ושליחה
שליחת דואר ב-SMTP
חברו Supabase Auth, WordPress או כל אפליקציה עם SMTP ל-Banger, כדי לשלוח מהדומיין שלכם ולהופיע ביומנים.
במדריך הזה 8 סעיפים
ממסר ה-SMTP של 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 מותאם אישית.
- Sender email: כתובת בנתיב המוצר, כמו
noreply@app.example.com. - שם השולח: שם המוצר. Banger שומר אותו כפי שנכתב.
- מארח
submit.bangermail.com, פורט465, שם משתמשbanger, סיסמה מפתח ה-API שלכם. - שמרו ואז שלחו לעצמכם קישור כניסה מ-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.