כיצד לשלוח אימיילים ב-Node.js באמצעות ממשק ה-API של Sendinblue

בעולם הדיגיטלי המהיר של היום, שיווק בדוא"ל הוא כלי חיוני לעסקים כדי להגיע ללקוחות שלהם ביעילות. עם זאת, הטמעת מערכת אימייל יכולה להיות תהליך מורכב וגוזל זמן, במיוחד עבור מפתחים שחדשים במשימה.

למרבה המזל, עם Sendinblue, שליחת מיילים היא משימה קלה מאוד. כפלטפורמת תוכנה כשירות (SaaS), Sendinblue מספקת את כל מה שאתה צריך כבעל עסק או מפתח כדי להעביר את האימיילים שלך למשתמשים שלך בקלות רבה.

מה זה Sendinblue?

SendinBlue היא פלטפורמת תוכנה כשירות (SaaS) המציעה פתרון שיווקי דוא"ל קל לשימוש לעסקים קטנים, בינוניים וגדולים. SendinBlue מספקת פלטפורמה המסייעת לחברות להצמיח את מערכות היחסים שלהן עם הלקוחות שלהן, בעיקר באמצעות שירותי דואר אלקטרוני ו-SMS.

SendinBlue מציעה גם ממשקי API וכלים המאפשרים למפתחים לבצע אוטומציה ולשלוח מיילים ו-SMS. כלים אלה קלים לשילוב עם Node.js ושפות תכנות אחרות כדי ליצור קמפיינים מותאמים אישית של דואר אלקטרוני ו-SMS.

עם SendinBlue, עסקים יכולים לייעל את תהליכי התקשורת ולהגיע למשתמשים או ללקוחות בצורה יעילה יותר.

כיצד לקבל אישורי SendinBlue API

כדי להשתמש בממשקי API ו-SDK של SendinBlue, התנאי הראשון הוא חשבון SendinBlue. SendinBlue מספק תהליך הרשמה קל, ותוכל ליצור חשבון ב- עמוד ההרשמה של SendinBlue.

צור חשבון, הזן את הפרטים הנדרשים ובחר תוכנית מתאימה בתהליך ההצטרפות. לאחר מכן, SendinBlue יפנה אותך ללוח המחוונים שלך, שם תוכל לקבל את אישורי ה-API שלך.

כדי להשיג את אישורי ה-API שלך, בצע את השלבים הבאים.

1. לחץ על שם הארגון שלך בפינה השמאלית העליונה של לוח המחוונים.
2. בחר SMTP & API מהתפריט שנפתח.
3. עבור אל מפתחות API לשונית ולחץ עלצור מפתח API חדש לַחְצָן.
4. בחלון הקופץ שמופיע, תן למפתח שלך שם, העתק את המחרוזת שנוצרה ואז אחסן אותה בבטחה.

מחרוזת זו היא מפתח ה-API שלך ותעודת הזהות שלך שאותה עליך לאחסן בזהירות כדי שלא תיפול לידיים הלא נכונות.

כיצד לבנות מערכת שליחת דוא"ל ב-Node.js

ל-Node.js אין א חבילת אימייל מובנית כמו Golang. כדי לשלוח מיילים, אתה צריך חבילה חיצונית כמו nodemailer או זה ש-SendinBlue מספק.

תזדקק גם לידע בעבודה של Node.js וסביבת פיתוח של Node.js במחשב שלך.

שקול את אפליקציית Node/Express הפשוטה הזו עם א /waitlist נקודת קצה:

// server.js
const express = לִדרוֹשׁ('אֶקְסְפּרֶס');
// צור שרת
const שרת = express();
const יציאה = 3333;
server.listen (יציאה, () => {
לְנַחֵם.עֵץ(`שרת מאזין ביציאה ${port}`);
})
// צור נקודת קצה של רשימת המתנה
server.use('/רשימת המתנה', אסינכרון (req, res) => {
לְנַסוֹת {
const user = req.body;
לְנַחֵם.עֵץ(`${user.fullname} הצטרף לרשימת ההמתנה`);
 res.status(200).json({ הוֹדָעָה: 'הצטרפה לרשימת ההמתנה בהצלחה' })
 } לתפוס (שגיאה) {
לְנַחֵם.error (שגיאה)
 res.status(500).json({ הוֹדָעָה: 'התרחשה שגיאה' })
 }
})

אתה יכול להשתמש ב- SendinBlue כדי לשלוח הודעת קבלת פנים למשתמש שמצטרף לרשימת ההמתנה.

השלב הראשון הוא התקנת ה-SDK באמצעות npm או כל מנהל חבילות אחר. לָרוּץ npm להתקין sib-api-v3-sdk אוֹ חוט הוסף sib-api-v3-sdk בתיקיית הפרויקט שלך כדי להוסיף אותו לתלות של הפרויקט.

לאחר ההתקנה, אתה מוכן להתחיל לשלוח מיילים עם עוד כמה שורות קוד. בפרויקט גדול יותר, סביר להניח שתרצה לבודד את פונקציונליות הדוא"ל בקובץ נפרד. עם זאת, עבור הדגמה זו, אתה יכול להמשיך להשתמש באותו server.js קוֹבֶץ.

ייבא את sib-api-v3-sdk חבילה, והגדר את הלקוח SendinBlue כמו להלן:

const SibApi = לִדרוֹשׁ('sib-api-v3-sdk');
// הצג לקוח חדש של SendinBlue API
const SibClient = SibApi. ApiClient.instance;
// אימות
SibClient.authentications['מפתח API'].apiKey = process.env. SIB_API_KEY
 || 'YOUR_API_KEY_HERE';

לאחר מכן, הגדר תצורה כלשהי וצור פונקציה לשליחת הודעות הדוא"ל לקבלת הפנים:

const transactionEmailApi = חָדָשׁ SibApiSDK.TransactionalEmailsApi();
לתת smtpMailData = חָדָשׁ SibApiSDK.SendSmtpEmail();
const שולח = {
 אימייל: '[email protected]', // כתובת הדוא"ל שלך
 שֵׁם: 'שולח לדוגמה',
};
const SendWaitlistEmail = אסינכרון (UserData) => {
}

ה transactionEmailApiמשתנה מאחסן אובייקט המאפשר לשלוח אימייל עסקה (כפי שהם נקראים ב-SendinBlue). ה smtpMailData המשתנה יאחסן את נתוני הדוא"ל של העסקאות שתצטרך לשלוח לכל אימייל: הנמען, התוכן וכו'.

עכשיו לגופו של ה שלח אימייל לרשימת ההמתנה פוּנקצִיָה. הקוד הבא מראה איך גוף הפונקציה צריך להיראות.

const SendWaitlistEmail = אסינכרון (UserData) => {
לְנַסוֹת {
 smtpMailData.sender = שולח;
 smtpMailData.to = [{
 דוא"ל: userData.email,
 שם: userData.fullname
 }];
 smtpMailData.subject = 'אתה ברשימת ההמתנה!';
 smtpMailData.params = {
'שֵׁם': userData.fullname,
'טוויטר': '@לעשות שימוש ב'
 };
 smtpMailData.htmlContent = "
שלום {{ params.name }}, "

 + "ברוכים הבאים לרשימת ההמתנה של makeuseof.com. נודיע לך"
 + "כשאנחנו משיקים. אנא עקבו אחרינו בטוויטר "
 + "{{ params.twitter }}.
";
// שלח אימייל
לְהַמתִין transactionEmailApi.sendTransacEmail (smtpMailData)
 .לאחר מכן((נתונים) => { 
לְנַחֵם‎.log (נתונים) // רישום את מזהה האימייל
 })
 .לתפוס((שְׁגִיאָה) => {
לְנַחֵם.error (שגיאה)
לזרוקחָדָשׁשְׁגִיאָה(שְׁגִיאָה) // לטפל בשגיאות
 })
 } לתפוס (שגיאה) {
לְנַחֵם.עֵץ('חלה שגיאה...')
לְנַחֵם.error (שגיאה)
לזרוקחָדָשׁשְׁגִיאָה(שְׁגִיאָה) // לטפל בשגיאות
 }
}

רוב הקוד הזה מאכלס מאפייני מפתח של smtpMailData לְהִתְנַגֵד. לפי הסדר, אלה הם:

• שׁוֹלֵחַ: אובייקט המכיל שני מאפיינים: אימייל ושם. הקוד שלמעלה משתמש בכתובת דוא"ל דמה, אך עליך להשתמש בכתובת דוא"ל אמיתית ופועלת עבור יישומי ייצור.
• ל: זהו מערך של נמעני אימייל. האלמנטים של מערך זה הם אובייקטים המוגדרים עם הנתונים (דוא"ל ושם) של נמען הדוא"ל. אתה יכול לקבל עד 50 נמענים לכל הודעה. מבחינה טכנית, אפשר לשלוח את ההודעה שלך ליותר מ-50 בבת אחת, אך פעולה זו מגדילה את הסיכון שסוכני דואר אלקטרוני יתייחסו אליה כדואר זבל.
• נושא: זהו נושא המייל שיש לשלוח.
• פרמטרים: אלו נתונים נוספים שתוכלו להשתמש בהם בחלקים שונים של המייל שלכם (בעיקר הנושא והתוכן). אתה יכול להשתמש בערכים מתוך זה params חפץ על ידי סגירתם בפלטה מתולתלת כפולה (כלומר {{ params.name }}).
• htmlתוכן: מאפיין זה מגדיר את גוף ההודעה. זה עוזר להגדיר את גוף ההודעה של האימייל, אותו תוכל לעצב באמצעות HTML. יש לו גם אלטרנטיבה, textContent, מה ששומר על גוף ההודעה רגיל.

המייל יכול לכלול נכסים נוספים, ותוכל לגלות את כולם בפנים תיעוד המפתחים של SendinBlue.

סוף - סוף, ה sendTransacEmail שיטה של transactionEmailApi שולח את המייל ומחזיר את תעודת הזהות של המייל.

לאחר יישום ה שלח אימייל לרשימת ההמתנה פונקציה, אתה יכול לקרוא לה בנקודת הקצה ברשימת ההמתנה. נקודת הסיום של רשימת ההמתנה לעיל תיראה כעת כך:

server.use('/רשימת המתנה', אסינכרון (req, res) => {
לְנַסוֹת {
const user = req.body;
לְנַחֵם.עֵץ(`${user.fullname} הצטרף לרשימת ההמתנה`);
// פונקציית שולח דואר אלקטרוני 
לְהַמתִין SendWaitlistEmail (משתמש)
 res.status(200).json({ הוֹדָעָה: 'הצטרפה לרשימת ההמתנה בהצלחה' })
 } לתפוס (שגיאה) {
לְנַחֵם.error (שגיאה)
 res.status(500).json({ הוֹדָעָה: 'אירעה שגיאת שרת פנימית' })
 }
})

אתה יכול להתחיל את היישום שלך ולבדוק את נקודת הקצה שלך ברשימת ההמתנה בלקוח REST API, או מהקצה הקדמי של היישום שלך. הנה דוגמה לבקשת בדיקה מאת Postman.

כך נראה האימייל שהתקבל. שימו לב שהערכים מה- params חפץ נמצאים.

אם תבדוק את המסוף שלך, תראה גם את messageId מודפס בקונסולה. אתה יכול לאחסן ערך זה במסד נתונים או ביומן כדי לזהות דוא"ל מסוים.

אתה יכול גם לשקול לבדוק כמה טיפים למניעת העברת מיילים לספאם של הנמענים.

למרות שמערכת דוא"ל זו פועלת כהלכה, נקודת הקצה התקשרה ישירות לפונקציית שולח הדוא"ל אינה הגישה היעילה ביותר. זה עלול לגרום לאפליקציה שלך להמתין ללא צורך בזמן שהיא שולחת את האימייל. כדי להימנע מכך, עליך לייעל את התהליך על ידי יישום תור משימות לטפל בעומס העבודה באימייל.

שליחת אימיילים ב-Node.js מעולם לא הייתה קלה יותר

זה מספק להבין שאתה יכול לבנות שירות לשליחת אימיילים ב-Node.js בקלות רבה.

מעבר להיקף המדריך הזה, יש עוד הרבה שאתה יכול לעשות עם SendinBlue. אתה יכול לשלוח גרסאות דוא"ל שונות לנמענים שונים בבת אחת, השתמש בתבניות דוא"ל שסופקו על ידי SendinBlue, הגדר את webhooks כדי לזהות פעולות שננקטו על ידי נמעני הדוא"ל שלך, והצג בזמן אמת ניתוח.

אתה יכול לחקור את התכונות הללו על ידי בדיקתן בפורטל המפתחים והטמעתן ביישומי Node.js שלך.