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

في عالم اليوم الرقمي سريع الخطى ، يعد التسويق عبر البريد الإلكتروني أداة أساسية للشركات للوصول إلى عملائها بشكل فعال. ومع ذلك ، يمكن أن يكون تنفيذ نظام البريد الإلكتروني عملية معقدة وتستغرق وقتًا طويلاً ، خاصة بالنسبة للمطورين الجدد في المهمة.

لحسن الحظ ، مع Sendinblue ، يعد إرسال رسائل البريد الإلكتروني مهمة سهلة للغاية. كمنصة برمجية كخدمة (SaaS) ، توفر Sendinblue كل ما تحتاجه كمالك أعمال أو مطور لتوصيل رسائل البريد الإلكتروني إلى المستخدمين بسهولة بالغة.

ما هو Sendinblue؟

SendinBlue عبارة عن نظام أساسي للبرامج كخدمة (SaaS) يوفر حلًا سهل الاستخدام لتسويق البريد الإلكتروني للشركات الصغيرة والمتوسطة والكبيرة. توفر SendinBlue منصة تساعد الشركات على تنمية علاقاتها مع عملائها ، بشكل أساسي من خلال خدمات البريد الإلكتروني والرسائل النصية القصيرة.

تقدم SendinBlue أيضًا واجهات برمجة التطبيقات والأدوات التي تسمح للمطورين بأتمتة وإرسال رسائل البريد الإلكتروني والرسائل النصية القصيرة. هذه الأدوات سهلة الدمج مع Node.js ولغات البرمجة الأخرى لإنشاء حملات بريد إلكتروني ورسائل SMS مخصصة.

instagram viewer

باستخدام SendinBlue ، يمكن للشركات تبسيط عمليات الاتصال والوصول إلى المستخدمين أو العملاء بشكل أكثر كفاءة.

كيفية الحصول على بيانات اعتماد SendinBlue API

لاستخدام SendinBlue APIs و SDKs ، فإن الشرط الأول هو حساب 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
مقدار ثابت صريح = يتطلب('يعبر');
// إنشاء الخادم
مقدار ثابت الخادم = صريح () ؛
مقدار ثابت المنفذ = 3333;


server.listen (المنفذ ، () => {
وحدة التحكم.سجل(`الخادم يستمع على المنفذ $ {منفذ}`);
})


// إنشاء نقطة نهاية قائمة الانتظار
server.use ("/ قائمة الانتظار", غير متزامن (مطلوب ، الدقة) => {
يحاول {
مقدار ثابت المستخدم = 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 كما يلي:

مقدار ثابت SibApi = يتطلب("sib-api-v3-sdk");
// إنشاء عميل SendinBlue API الجديد
مقدار ثابت SibClient = SibApi. ApiClient.instance ؛
// المصادقة
تصديق SibClient. ['مفتاح API'] .apiKey = process.env. SIB_API_KEY
 || "YOUR_API_KEY_HERE";

بعد ذلك ، قم بإعداد بعض التكوين وإنشاء وظيفة لإرسال رسائل البريد الإلكتروني الترحيبية:

مقدار ثابت transactionEmailApi = جديد SibApiSDK.TransactionalEmailsApi () ،
يترك smtpMailData = جديد SibApiSDK.SendSmtpEmail () ،


مقدار ثابت المرسل = {
 بريد إلكتروني: "sendinbluemail@example.com", // عنوان بريدك الإلكتروني
 اسم: "مثال المرسل",
};
مقدار ثابت SendWaitlistEmail = غير متزامن (بيانات المستخدم) => {
}

ال معاملةمتغير يخزن كائنًا يتيح لك إرسال رسائل بريد إلكتروني للمعاملات (كما يطلق عليه في SendinBlue). ال smtpMailData المتغير سيخزن بيانات البريد الإلكتروني للمعاملة التي ستحتاجها لإرسال كل بريد إلكتروني: المستلم والمحتوى وما إلى ذلك.

الآن إلى جسد إرسال قائمة الانتظار وظيفة. يوضح الكود التالي الشكل الذي يجب أن يبدو عليه جسم الوظيفة.

مقدار ثابت SendWaitlistEmail = غير متزامن (بيانات المستخدم) => {
يحاول {
 smtpMailData.sender = المرسل ؛
 smtpMailData.to = [{
 البريد الإلكتروني: userData.email ،
 الاسم: userData.fullname
 }];


 smtpMailData.subject = "أنت في قائمة الانتظار!";


 smtpMailData.params = {
'اسم': userData.fullname،
'تويتر': "makeuseof"
 };


 smtpMailData.htmlContent = "
مرحبًا {{params.name}} ، "

 + "مرحبًا بك في قائمة انتظار makeuseof.com. سنقوم بإخطارك "
 + "عندما نطلق. ارجو متابعتنا على تويتر "
 + "{{params.twitter}}.
";
// ارسل بريد الكتروني
انتظر transactionEmailApi.sendTransacEmail (smtpMailData)
 .ثم((بيانات) => { 
وحدة التحكم.تسجيل البيانات) // سجل معرف البريد الإلكتروني
 })
 .يمسك((خطأ) => {
وحدة التحكم. Error (خطأ)
يرميجديدخطأ(خطأ) // معالجة الأخطاء
 })
 } يمسك (خطأ) {
وحدة التحكم.سجل('حدث خطأ...')
وحدة التحكم. Error (خطأ)
يرميجديدخطأ(خطأ) // معالجة الأخطاء
 }
}

يملأ معظم هذا الرمز الخصائص الرئيسية لملف smtpMailData هدف. بالترتيب ، هذه هي:

  • مرسل: كائن يحتوي على خاصيتين: البريد الإلكتروني والاسم. يستخدم الكود أعلاه عنوان بريد إلكتروني وهمي ، ولكن يجب عليك استخدام عنوان بريد إلكتروني حقيقي وفعال لتطبيقات الإنتاج.
  • ل: هذه مجموعة من مستلمي البريد الإلكتروني. عناصر هذه المصفوفة هي كائنات محددة بالبيانات (البريد الإلكتروني والاسم) لمستلم البريد الإلكتروني. يمكن أن يكون لديك ما يصل إلى 50 مستلمًا لكل رسالة. من الناحية الفنية ، من الممكن إرسال رسالتك إلى أكثر من 50 مرة في وقت واحد ، ولكن القيام بذلك يزيد من مخاطر تعامل وكلاء البريد الإلكتروني معها على أنها رسائل غير مرغوب فيها.
  • موضوع: هذا هو موضوع البريد الإلكتروني لإرساله.
  • المعلمات: هذه بيانات إضافية يمكنك استخدامها في أجزاء مختلفة من بريدك الإلكتروني (بشكل أساسي الموضوع والمحتوى). يمكنك استخدام القيم من هذا بارامز كائن من خلال إحاطةهم بأقواس مزدوجة متعرجة (على سبيل المثال ، {{params.name}}).
  • محتوى html: تحدد هذه الخاصية نص الرسالة. يساعد في تحديد نص رسالة البريد الإلكتروني ، والذي يمكنك تنسيقه باستخدام HTML. كما أن لها بديلًا ، محتوى النص، مما يجعل نص الرسالة عاديًا.

يمكن أن يحتوي البريد الإلكتروني على المزيد من الخصائص ، ويمكنك اكتشافها جميعًا وثائق مطور SendinBlue.

وأخيرا، فإن SendTransacEmail طريقة معاملة يرسل البريد الإلكتروني ويعيد معرف البريد الإلكتروني.

بعد تنفيذ إرسال قائمة الانتظار وظيفة ، يمكنك تسميتها في نقطة نهاية قائمة الانتظار. ستبدو نقطة نهاية قائمة الانتظار أعلاه كما يلي:

server.use ("/ قائمة الانتظار", غير متزامن (مطلوب ، الدقة) => {
يحاول {
مقدار ثابت المستخدم = req.body ؛
وحدة التحكم.سجل(`$ {user.fullname} انضم إلى قائمة الانتظار`);
// استدعاء وظيفة مرسل البريد الإلكتروني 
انتظر إرسال قائمة الانتظار
 res.status (200) .json ({ رسالة: "انضمت إلى قائمة الانتظار بنجاح" })
 } يمسك (خطأ) {
وحدة التحكم. Error (خطأ)
 res.status (500) .json ({ رسالة: "حدث خطأ داخلي في الخادم" })
 }
})

يمكنك بدء تطبيقك واختبار نقطة نهاية قائمة الانتظار في عميل REST API ، أو من الواجهة الأمامية لتطبيقك. إليك مثال لطلب اختبار من Postman.

هذا ما يبدو عليه البريد الإلكتروني المستلم. لاحظ أن القيم من بارامز الكائن موجود.

إذا قمت بفحص جهازك الطرفي ، فسترى أيضًا ملف معرف الرسالة مطبوعة في وحدة التحكم. يمكنك تخزين هذه القيمة في قاعدة بيانات أو سجل لتعريف بريد إلكتروني معين.

قد تفكر أيضًا في التحقق من بعض نصائح لمنع رسائل البريد الإلكتروني من الذهاب إلى الرسائل غير المرغوب فيها للمستلمين.

على الرغم من أن نظام البريد الإلكتروني هذا يعمل بشكل صحيح ، إلا أن وجود نقطة النهاية تستدعي وظيفة مرسل البريد الإلكتروني بشكل مباشر ليس هو الأسلوب الأكثر فعالية. قد يتسبب ذلك في انتظار تطبيقك دون داعٍ أثناء إرسال البريد الإلكتروني. لتجنب هذا ، يجب عليك تحسين العملية من خلال تنفيذ قائمة انتظار المهام للتعامل مع عبء عمل البريد الإلكتروني.

لم يكن إرسال رسائل البريد الإلكتروني في Node.js أسهل من أي وقت مضى

إنه لمن دواعي سرورنا أن ندرك أنه يمكنك إنشاء خدمة لإرسال رسائل البريد الإلكتروني في Node.js بسهولة بالغة.

خارج نطاق هذا الدليل ، هناك الكثير الذي يمكنك فعله باستخدام SendinBlue. يمكنك إرسال إصدارات مختلفة من البريد الإلكتروني إلى مستلمين مختلفين في وقت واحد ، واستخدام قوالب البريد الإلكتروني التي يوفرها SendinBlue ، قم بتكوين webhooks لاكتشاف الإجراءات التي يتخذها مستلمو البريد الإلكتروني ، وعرض الوقت الفعلي التحليلات.

يمكنك استكشاف هذه الميزات عن طريق التحقق منها في بوابة المطور وتنفيذها في تطبيقات Node.js الخاصة بك.