Cara Mengirim Email di Node.js Menggunakan Sendinblue API

Di dunia digital yang serba cepat saat ini, pemasaran email adalah alat penting bagi bisnis untuk menjangkau pelanggan mereka secara efektif. Namun, menerapkan sistem email bisa menjadi proses yang rumit dan memakan waktu, terutama bagi pengembang yang baru dalam tugas tersebut.

Untungnya, dengan Sendinblue, mengirim email adalah tugas yang sangat mudah. Sebagai platform perangkat lunak sebagai layanan (SaaS), Sendinblue menyediakan semua yang Anda butuhkan sebagai pemilik bisnis atau pengembang untuk menyampaikan email Anda kepada pengguna dengan sangat mudah.

Apa itu sendinblue?

SendinBlue adalah platform perangkat lunak sebagai layanan (SaaS) yang menawarkan solusi pemasaran email yang mudah digunakan untuk bisnis kecil, menengah, dan besar. SendinBlue menyediakan platform yang membantu perusahaan untuk mengembangkan hubungan mereka dengan pelanggan mereka, terutama melalui layanan email dan SMS.

SendinBlue juga menawarkan API dan alat yang memungkinkan pengembang mengotomatisasi dan mengirim email dan SMS. Alat-alat ini mudah diintegrasikan dengan Node.js dan bahasa pemrograman lainnya untuk membuat kampanye email dan SMS yang disesuaikan.

Dengan SendinBlue, bisnis dapat merampingkan proses komunikasi dan menjangkau pengguna atau pelanggan dengan lebih efisien.

Cara Mendapatkan Kredensial API SendinBlue

Untuk menggunakan API dan SDK SendinBlue, prasyarat pertama adalah akun SendinBlue. SendinBlue menyediakan proses pendaftaran yang mudah, dan Anda dapat membuat akun di Halaman pendaftaran SendinBlue.

Buat akun, masukkan detail yang diperlukan, dan pilih paket yang sesuai dalam proses orientasi. SendinBlue kemudian akan mengarahkan Anda ke dasbor tempat Anda bisa mendapatkan kredensial API Anda.

Untuk mendapatkan kredensial API Anda, ikuti langkah-langkah di bawah ini.

1. Klik nama organisasi Anda di sudut kanan atas dasbor.
2. Pilih SMTP & API dari menu yang turun ke bawah.
3. Beralih ke Kunci API tab dan klik padaHasilkan kunci API baru tombol.
4. Di munculan yang muncul, beri nama kunci Anda, salin string yang dihasilkan, lalu simpan dengan aman.

String ini adalah kunci API Anda dan kredensial identitas Anda yang harus Anda simpan dengan hati-hati agar tidak jatuh ke tangan yang salah.

Cara Membangun Sistem Pengiriman Email di Node.js

Node.js tidak memiliki paket email bawaan seperti Golang. Untuk mengirim email, Anda memerlukan paket eksternal seperti nodemailer atau yang disediakan SendinBlue.

Anda juga memerlukan pengetahuan tentang Node.js dan lingkungan pengembangan Node.js di mesin Anda.

Pertimbangkan aplikasi Node/Express sederhana ini dengan a /waitlist titik akhir:

// server.js
const mengungkapkan = memerlukan('cepat');
// buat server
const server = ekspres();
const pelabuhan = 3333;
server.dengarkan (port, () => {
menghibur.catatan(`server mendengarkan di port ${port}`);
})
// buat titik akhir daftar tunggu
penggunaan server('/ daftar tunggu', asinkron (req, res) => {
mencoba {
const pengguna = req.tubuh;
menghibur.catatan(`${pengguna.nama lengkap} bergabung dengan daftar tunggu`);
 res.status(200).json({ pesan: 'Berhasil bergabung dengan Daftar Tunggu' })
 } menangkap (kesalahan) {
menghibur.error (kesalahan)
 res.status(500).json({ pesan: 'Terjadi kesalahan' })
 }
})

Anda dapat menggunakan SendinBlue untuk mengirimkan email sambutan kepada pengguna yang bergabung dalam daftar tunggu.

Langkah pertama adalah menginstal SDK menggunakan npm atau manajer paket lainnya. Berlari npm instal sib-api-v3-sdk atau benang tambahkan sib-api-v3-sdk di folder proyek Anda untuk menambahkannya ke dependensi proyek.

Setelah penginstalan, Anda siap untuk mulai mengirim email hanya dengan beberapa baris kode lagi. Pada proyek yang lebih besar, Anda mungkin ingin mengisolasi fungsionalitas email dalam file terpisah. Namun, untuk demonstrasi ini, Anda dapat terus menggunakan yang sama server.js mengajukan.

Impor sib-api-v3-sdk paket, dan atur klien SendinBlue seperti di bawah ini:

const SibApi = memerlukan('sib-api-v3-sdk');
// instantiate klien SendinBlue API baru
const SibClient = SibApi. ApiClient.instance;
// Autentikasi
SibClient.otentikasi['kunci API'].apiKey = proses.env. SIB_API_KEY
 || 'YOUR_API_KEY_HERE';

Selanjutnya, atur beberapa konfigurasi dan buat fungsi untuk mengirim email selamat datang:

const transaksiEmailApi = baru SibApiSDK.TransactionalEmailsApi();
membiarkan smtpMailData = baru SibApiSDK.SendSmtpEmail();
const pengirim = {
 surel: '[email protected]', // Alamat email anda
 nama: 'Contoh Pengirim',
};
const SendWaitlistEmail = asinkron (Datapengguna) => {
}

Itu transaksiEmailApivariabel menyimpan objek yang memungkinkan Anda mengirim email transaksi (sebagaimana namanya di SendinBlue). Itu smtpMailData variabel akan menyimpan data email transaksi yang Anda perlukan untuk mengirim setiap email: penerima, konten, dll.

Sekarang ke tubuh SendWaitlistEmail fungsi. Kode berikut menunjukkan seperti apa seharusnya badan fungsi.

const SendWaitlistEmail = asinkron (Datapengguna) => {
mencoba {
 smtpMailData.sender = pengirim;
 smtpMailData.to = [{
 email: datapengguna.email,
 nama: userData.nama lengkap
 }];
 smtpMailData.subjek = 'Anda berada di daftar tunggu!';
 smtpMailData.params = {
'nama': userData.nama lengkap,
'twitter': '@menggunakan'
 };
 smtpMailData.htmlKonten = "
Halo {{ params.name }}, "

 + "selamat datang di daftar tunggu makeuseof.com. Kami akan memberi tahu Anda"
 + "ketika kita meluncurkan. Silakan ikuti kami di Twitter "
 + "{{ params.twitter }}.
";
// mengirim email
menunggu transactionEmailApi.sendTransacEmail (smtpMailData)
 .Kemudian((data) => { 
menghibur.log (data) // catat id email
 })
 .menangkap((kesalahan) => {
menghibur.error (kesalahan)
melemparkanbaruKesalahan(kesalahan) // menangani kesalahan
 })
 } menangkap (kesalahan) {
menghibur.catatan('Kesalahan terjadi...')
menghibur.error (kesalahan)
melemparkanbaruKesalahan(kesalahan) // menangani kesalahan
 }
}

Sebagian besar kode ini mengisi properti utama dari smtpMailData obyek. Secara berurutan, ini adalah:

• pengirim: Objek yang berisi dua properti: email dan nama. Kode di atas menggunakan alamat email tiruan, tetapi Anda harus menggunakan alamat email asli yang berfungsi untuk aplikasi produksi.
• ke: Ini adalah susunan penerima email. Elemen array ini adalah objek yang ditentukan dengan data (email dan nama) penerima email. Anda dapat memiliki hingga 50 penerima per pesan. Secara teknis, Anda dapat mengirim pesan Anda ke lebih dari 50 sekaligus, tetapi hal itu meningkatkan risiko agen email memperlakukannya sebagai spam.
• subjek: Ini adalah subjek email yang akan dikirim.
• parameter: Ini adalah data tambahan yang dapat Anda gunakan di berbagai bagian email Anda (terutama subjek dan konten). Anda dapat menggunakan nilai dari ini parameter objek dengan melampirkannya dalam kurung kurawal ganda (mis {{params.nama}}).
• htmlKonten: Properti ini mendefinisikan isi pesan. Ini membantu untuk menentukan badan pesan email, yang dapat Anda format menggunakan HTML. Ini juga memiliki alternatif, teksKonten, yang membuat isi pesan tetap polos.

Email dapat memiliki lebih banyak properti, dan Anda dapat menemukan semuanya Dokumentasi pengembang SendinBlue.

Akhirnya, sendTransacEmail metode dari transaksiEmailApi mengirim email dan mengembalikan ID email.

Setelah menerapkan SendWaitlistEmail fungsi, Anda dapat memanggilnya di titik akhir daftar tunggu. Titik akhir daftar tunggu di atas sekarang akan terlihat seperti ini:

penggunaan server('/ daftar tunggu', asinkron (req, res) => {
mencoba {
const pengguna = req.tubuh;
menghibur.catatan(`${pengguna.nama lengkap} bergabung dengan daftar tunggu`);
// panggil fungsi pengirim email 
menunggu SendWaitlistEmail (pengguna)
 res.status(200).json({ pesan: 'Berhasil bergabung dengan Daftar Tunggu' })
 } menangkap (kesalahan) {
menghibur.error (kesalahan)
 res.status(500).json({ pesan: 'Terjadi kesalahan server internal' })
 }
})

Anda dapat memulai aplikasi Anda dan menguji endpoint daftar tunggu Anda di klien REST API, atau dari frontend aplikasi Anda. Berikut adalah contoh permintaan tes dari Postman.

Berikut tampilan email yang diterima. Perhatikan bahwa nilai dari parameter objek hadir.

Jika Anda memeriksa terminal Anda, Anda juga akan melihat messageId dicetak di konsol. Anda dapat menyimpan nilai ini dalam database atau log untuk mengidentifikasi email tertentu.

Anda juga dapat mempertimbangkan untuk memeriksa beberapa tips untuk mencegah email masuk ke spam penerima.

Meskipun sistem email ini berfungsi dengan benar, membuat titik akhir langsung memanggil fungsi pengirim email bukanlah pendekatan yang paling efisien. Ini dapat menyebabkan aplikasi Anda menunggu secara tidak perlu saat mengirim email. Untuk menghindari hal ini, Anda harus mengoptimalkan proses dengan mengimplementasikan antrian tugas untuk menangani beban kerja email.

Mengirim Email di Node.js Belum Pernah Lebih Mudah

Sangat menyenangkan mengetahui bahwa Anda dapat membuat layanan untuk mengirim email di Node.js dengan sangat mudah.

Di luar cakupan panduan ini, masih banyak lagi yang dapat Anda lakukan dengan SendinBlue. Anda dapat mengirim versi email yang berbeda ke penerima yang berbeda sekaligus, gunakan template email yang disediakan oleh SendinBlue, konfigurasikan webhook untuk mendeteksi tindakan yang diambil oleh penerima email Anda, dan lihat waktu nyata analitik.

Anda dapat menjelajahi fitur-fitur ini dengan memeriksanya di portal pengembang dan menerapkannya di aplikasi Node.js Anda.