Sendinblue API'sini Kullanarak Node.js'de E-posta Gönderme

Günümüzün hızlı tempolu dijital dünyasında, e-posta pazarlaması, işletmelerin müşterilerine etkili bir şekilde ulaşması için önemli bir araçtır. Ancak, bir e-posta sistemini uygulamak, özellikle görevde yeni olan geliştiriciler için karmaşık ve zaman alan bir süreç olabilir.

Neyse ki, Sendinblue ile e-posta göndermek çok kolay bir iştir. Bir hizmet olarak yazılım (SaaS) platformu olarak Sendinblue, bir işletme sahibi veya geliştirici olarak e-postalarınızı kullanıcılarınıza kolayca ulaştırmak için ihtiyacınız olan her şeyi sağlar.

Sendinblue Nedir?

SendinBlue, küçük, orta ve büyük ölçekli işletmeler için kullanımı kolay bir e-posta pazarlama çözümü sunan bir hizmet olarak yazılım (SaaS) platformudur. SendinBlue, şirketlerin müşterileriyle ilişkilerini, özellikle e-posta ve SMS hizmetleri aracılığıyla geliştirmelerine yardımcı olan bir platform sağlar.

SendinBlue ayrıca, geliştiricilerin e-postaları ve SMS'leri otomatikleştirmesine ve göndermesine olanak tanıyan API'ler ve araçlar sunar. Bu araçların, özelleştirilmiş e-posta ve SMS kampanyaları oluşturmak için Node.js ve diğer programlama dilleriyle entegrasyonu kolaydır.

SendinBlue ile işletmeler, iletişim süreçlerini kolaylaştırabilir ve kullanıcılara veya müşterilere daha verimli bir şekilde ulaşabilir.

SendinBlue API Kimlik Bilgileri Nasıl Alınır?

SendinBlue API'lerini ve SDK'larını kullanmak için ilk ön koşul bir SendinBlue hesabıdır. SendinBlue, kolay bir kayıt işlemi sağlar ve bir hesap oluşturabilirsiniz. SendinBlue kayıt sayfası.

Bir hesap oluşturun, gerekli ayrıntıları girin ve katılım sürecinde uygun bir plan seçin. SendinBlue daha sonra sizi API kimlik bilgilerinizi alabileceğiniz kontrol panelinize yönlendirecektir.

API kimlik bilgilerinizi almak için aşağıdaki adımları izleyin.

1. Panonun sağ üst köşesindeki kuruluşunuzun adına tıklayın.
2. Seçme SMTP ve API aşağı açılan menüden.
3. Şuna geç: API Anahtarları sekmesine tıklayın veYeni bir API anahtarı oluştur düğme.
4. Görünen açılır pencerede anahtarınıza bir ad verin, oluşturulan diziyi kopyalayın ve güvenli bir şekilde saklayın.

Bu dize, yanlış ellere geçmemesi için dikkatlice saklamanız gereken API anahtarınız ve kimlik bilgilerinizdir.

Node.js'de E-posta Gönderme Sistemi Nasıl Oluşturulur

Node.js'de yok Golang gibi yerleşik e-posta paketi. E-posta göndermek için aşağıdaki gibi harici bir pakete ihtiyacınız vardır: nodemailer veya SendinBlue'nun sağladığı.

Ayrıca makinenizde çalışan bir Node.js bilgisine ve bir Node.js geliştirme ortamına ihtiyacınız olacak.

Bu basit Node/Express uygulamasını bir /waitlist bitiş noktası:

// sunucu.js
sabit ifade = gerekmek('ifade etmek');
// sunucu oluştur
sabit sunucu = ekspres();
sabit bağlantı noktası = 3333;
server.listen (bağlantı noktası, () => {
konsol.kayıt(`sunucu bağlantı noktasını dinliyor ${bağlantı noktası}`);
})
// bekleme listesi bitiş noktası oluştur
server.use('/bekleme listesi', zaman uyumsuz (gerekli, res) => {
denemek {
sabit kullanıcı = req.body;
konsol.kayıt(`${user.fullname} bekleme listesine katıldı`);
 res.status(200).json({ İleti: "Bekleme listesine başarıyla katıldı" })
 } yakalamak (hata) {
konsol.hata (hata)
 res.status(500).json({ İleti: 'Bir hata oluştu' })
 }
})

Bekleme listesine katılan bir kullanıcıya hoş geldiniz e-postası göndermek için SendinBlue'yu kullanabilirsiniz.

İlk adım, SDK'yı kullanarak yüklemektir. npm veya başka bir paket yöneticisi. Koşmak npm sib-api-v3-sdk'yi kurun veya iplik ekleme sib-api-v3-sdk projenin bağımlılıklarına eklemek için proje klasörünüzde.

Yüklemeden sonra, yalnızca birkaç satır daha kodla e-posta göndermeye hazırsınız. Daha büyük bir projede, muhtemelen e-posta işlevini ayrı bir dosyada izole etmek istersiniz. Ancak, bu tanıtım için aynısını kullanmaya devam edebilirsiniz. sunucu.js dosya.

içe aktar sib-api-v3-sdk paketini açın ve SendinBlue istemcisini aşağıdaki gibi kurun:

sabit SibApi = gerekmek('sib-api-v3-sdk');
// yeni SendinBlue API istemcisini başlat
sabit SibClient = SibApi. ApiClient.örnek;
// kimlik doğrulama
SibClient.authentications["api anahtarı"].apiKey = işlem.env. SIB_API_KEY
 || "SİZİN_API_KEY_BURADASINIZ";

Ardından, bazı yapılandırmalar ayarlayın ve karşılama e-postalarını göndermek için bir işlev oluşturun:

sabit işlemEmailApi = yeni SibApiSDK.TransactionalEmailsApi();
izin vermek smtpMailData = yeni SibApiSDK.SendSmtpEmail();
sabit gönderen = {
 e-posta: 'gö[email protected]', // e-posta adresiniz
 isim: "Örnek Gönderici",
};
sabit SendWaitlistEmail = zaman uyumsuz (kullanıcıVerileri) => {
}

bu işlemEmailApideğişkeni, işlem e-postaları göndermenizi sağlayan bir nesneyi depolar (SendinBlue'da adlandırıldıkları gibi). bu smtpMailData değişkeni, her bir e-postayı göndermek için ihtiyaç duyacağınız işlem e-posta verilerini depolar: alıcı, içerik vb.

Şimdi vücuduna geçelim Bekleme ListesiE-posta Gönder işlev. Aşağıdaki kod, işlev gövdesinin nasıl görünmesi gerektiğini gösterir.

sabit SendWaitlistEmail = zaman uyumsuz (kullanıcıVerileri) => {
denemek {
 smtpMailData.sender = gönderen;
 smtpMailData.to = [{
 e-posta: userData.email,
 ad: userData.fullname
 }];
 smtpMailData.subject = "Bekleme listesindesiniz!";
 smtpMailData.params = {
'isim': userData.fullname,
"twitter": '@faydalanmak'
 };
 smtpMailData.htmlİçerik = "
Merhaba {{ params.name }}, "

 + "makeuseof.com bekleme listesine hoş geldiniz. Size haber vereceğiz"
 + "başladığımızda. Lütfen bizi Twitter'da takip edin"
 + "{{params.twitter }}.
";
// eposta gönder
beklemek işlemEmailApi.sendTransacEmail (smtpMailData)
 .Daha sonra((veri) => { 
konsol.log (veri) // e-posta kimliğini günlüğe kaydet
 })
 .yakalamak((hata) => {
konsol.hata (hata)
fırlatmakyeniHata(hata) // hataları işle
 })
 } yakalamak (hata) {
konsol.kayıt('Bir hata oluştu...')
konsol.hata (hata)
fırlatmakyeniHata(hata) // hataları işle
 }
}

Bu kodun çoğu, smtpMailData nesne. Sırayla bunlar:

• gönderen: İki özellik içeren bir nesne: e-posta ve ad. Yukarıdaki kod sahte bir e-posta adresi kullanıyor, ancak üretim uygulamaları için gerçek, çalışan bir e-posta adresi kullanmalısınız.
• ile: Bu, bir dizi e-posta alıcısıdır. Bu dizinin öğeleri, e-posta alıcısının verileriyle (e-posta ve ad) tanımlanan nesnelerdir. Mesaj başına en fazla 50 alıcınız olabilir. Teknik olarak, mesajınızı aynı anda 50'den fazla kişiye göndermek mümkündür, ancak bunu yapmak, e-posta aracılarının mesajı spam olarak değerlendirme riskini artırır.
• ders: Bu, gönderilecek e-postanın konusudur.
• parametreler: Bu, e-postanızın çeşitli bölümlerinde (esas olarak konu ve içerik) kullanabileceğiniz ek verilerdir. Buradaki değerleri kullanabilirsiniz parametreler nesneyi çift kıvrık ayraç içine alarak (yani {{ parametreler.adı }}).
• htmlİçerik: Bu özellik mesajın gövdesini tanımlar. HTML kullanarak biçimlendirebileceğiniz e-postanın mesaj gövdesini tanımlamanıza yardımcı olur. Onun da bir alternatifi var, Metin içeriği, bu da mesaj gövdesini düz tutar.

E-postanın daha fazla özelliği olabilir ve hepsini şurada keşfedebilirsiniz: SendinBlue'nun geliştirici belgeleri.

Son olarak, gönderTransacEmail yöntemi işlemEmailApi e-postayı gönderir ve e-postanın kimliğini döndürür.

hayata geçirdikten Bekleme ListesiE-posta Gönder işlevi, onu bekleme listesi bitiş noktasında arayabilirsiniz. Yukarıdaki bekleme listesi uç noktası şimdi şöyle görünecektir:

server.use('/bekleme listesi', zaman uyumsuz (gerekli, res) => {
denemek {
sabit kullanıcı = req.body;
konsol.kayıt(`${user.fullname} bekleme listesine katıldı`);
// e-posta gönderen işlevini çağır 
beklemek SendWaitlistEmail (kullanıcı)
 res.status(200).json({ İleti: "Bekleme listesine başarıyla katıldı" })
 } yakalamak (hata) {
konsol.hata (hata)
 res.status(500).json({ İleti: "Bir dahili sunucu hatası oluştu" })
 }
})

Uygulamanızı başlatabilir ve bekleme listesi uç noktanızı bir REST API istemcisinde veya uygulamanızın ön ucundan test edebilirsiniz. İşte Postman'dan örnek bir test isteği.

İşte alınan e-postanın nasıl göründüğü. Değerlerden gelen değerlere dikkat edin. parametreler nesne bulunur.

Terminalinizi kontrol ederseniz, şunu da göreceksiniz: Mesaj Kimliği konsolda yazdırılır. Belirli bir e-postayı tanımlamak için bu değeri bir veritabanında veya günlükte saklayabilirsiniz.

Ayrıca bazılarını kontrol etmeyi de düşünebilirsiniz. e-postaların alıcıların istenmeyen postasına gitmesini önlemek için ipuçları.

Bu e-posta sistemi düzgün çalışsa da uç noktanın doğrudan e-posta gönderen işlevini çağırması en verimli yaklaşım değildir. Uygulamanızın e-postayı gönderirken gereksiz yere beklemesine neden olabilir. Bunu önlemek için, süreci şu şekilde optimize etmelisiniz: bir görev kuyruğu uygulamak e-posta iş yükünü yönetmek için.

Node.js'de E-posta Göndermek Hiç Bu Kadar Kolay Olmamıştı

Node.js'de çok kolay bir şekilde e-posta göndermek için bir hizmet oluşturabileceğinizi fark etmek tatmin edici.

Bu kılavuzun kapsamı dışında, SendinBlue ile yapabileceğiniz çok daha fazlası var. Aynı anda farklı alıcılara farklı e-posta sürümleri gönderebilir, tarafından sağlanan e-posta şablonlarını kullanabilirsiniz. SendinBlue, e-posta alıcılarınız tarafından gerçekleştirilen eylemleri algılamak ve gerçek zamanlı olarak görüntülemek için web kancalarını yapılandırın analitik.

Bu özellikleri, geliştirici portalında inceleyerek ve Node.js uygulamalarınızda uygulayarak keşfedebilirsiniz.