Kako pošiljati e-pošto v Node.js z uporabo API-ja Sendinblue

V današnjem hitrem digitalnem svetu je e-poštno trženje bistveno orodje za podjetja, da učinkovito dosežejo svoje stranke. Vendar pa je uvedba e-poštnega sistema lahko zapleten in dolgotrajen proces, zlasti za razvijalce, ki so novi pri tej nalogi.

Na srečo je s Sendinblue pošiljanje e-pošte zelo enostavno. Sendinblue kot platforma programske opreme kot storitve (SaaS) ponuja vse, kar potrebujete kot lastnik podjetja ali razvijalec, da vaša e-poštna sporočila zelo enostavno posredujete uporabnikom.

Kaj je Sendinblue?

SendinBlue je platforma programske opreme kot storitve (SaaS), ki ponuja preprosto rešitev za e-poštno trženje za mala, srednje velika in velika podjetja. SendinBlue ponuja platformo, ki podjetjem pomaga razvijati odnose s strankami, predvsem prek e-pošte in storitev SMS.

SendinBlue ponuja tudi API-je in orodja, ki razvijalcem omogočajo avtomatizacijo in pošiljanje e-pošte in SMS-ov. Ta orodja je enostavno integrirati z Node.js in drugimi programskimi jeziki za ustvarjanje prilagojenih e-poštnih in SMS kampanj.

S SendinBlue lahko podjetja poenostavijo komunikacijske procese in učinkoviteje dosežejo uporabnike ali stranke.

Kako pridobiti poverilnice API-ja SendinBlue

Za uporabo API-jev in SDK-jev SendinBlue je prvi predpogoj račun SendinBlue. SendinBlue omogoča enostaven postopek prijave, račun pa lahko ustvarite na Stran za prijavo SendinBlue.

Ustvarite račun, vnesite zahtevane podatke in izberite ustrezen načrt v procesu vkrcanja. SendinBlue vas bo nato preusmeril na vašo nadzorno ploščo, kjer boste lahko dobili svoje poverilnice za API.

Če želite pridobiti svoje poverilnice za API, sledite spodnjim korakom.

1. V zgornjem desnem kotu nadzorne plošče kliknite ime vaše organizacije.
2. Izberite SMTP in API iz spustnega menija.
3. Preklopite na API ključi zavihek in kliknite naUstvarite nov ključ API gumb.
4. V pojavnem oknu, ki se prikaže, poimenujte svoj ključ, kopirajte ustvarjeni niz in ga nato varno shranite.

Ta niz je vaš ključ API in vaša poverilnica identitete, ki ju morate skrbno shraniti, da ne pade v napačne roke.

Kako zgraditi sistem za pošiljanje e-pošte v Node.js

Node.js nima vgrajen e-poštni paket, kot je Golang. Za pošiljanje e-pošte potrebujete zunanji paket, kot je nodemailer ali tistega, ki ga ponuja SendinBlue.

Potrebovali boste tudi delovno znanje o Node.js in razvojnem okolju Node.js na vašem računalniku.

Razmislite o tej preprosti aplikaciji Node/Express z a /waitlist končna točka:

// strežnik.js
konst izraziti = zahtevati('express');
// ustvari strežnik
konst strežnik = express();
konst pristanišče = 3333;
server.listen (vrata, () => {
konzola.log(`strežnik posluša na vratih ${port}`);
})
// ustvari končno točko čakalne liste
server.use('/čakalni seznam', asinh (req, res) => {
poskusi {
konst uporabnik = req.body;
konzola.log(`${user.fullname} se je pridružil čakalni listi`);
 res.status(200).json({ sporočilo: 'Uspešno vpisan na čakalni seznam' })
 } ulov (napaka) {
konzola.error (napaka)
 res.status(500).json({ sporočilo: 'Pojavila se je napaka' })
 }
})

SendinBlue lahko uporabite za pošiljanje pozdravnega e-poštnega sporočila uporabniku, ki se pridruži čakalni listi.

Prvi korak je namestitev SDK z uporabo npm ali katerega koli drugega upravitelja paketov. Teči npm namestite sib-api-v3-sdk oz preje dodajte sib-api-v3-sdk v mapi vašega projekta, da ga dodate med odvisnosti projekta.

Po namestitvi ste pripravljeni začeti pošiljati e-pošto z le še nekaj vrsticami kode. Pri večjem projektu bi verjetno želeli funkcijo e-pošte izolirati v ločeni datoteki. Vendar pa lahko za to predstavitev še naprej uporabljate isto server.js mapa.

Uvozite sib-api-v3-sdk paket in nastavite odjemalca SendinBlue, kot je prikazano spodaj:

konst SibApi = zahtevati('sib-api-v3-sdk');
// ustvari nov odjemalec API SendinBlue
konst SibClient = SibApi. ApiClient.instance;
// Preverjanje pristnosti
SibClient.authentications['api-ključ'].apiKey = process.env. SIB_API_KEY
 || 'YOUR_API_KEY_HERE';

Nato nastavite nekaj konfiguracije in ustvarite funkcijo za pošiljanje pozdravnih e-poštnih sporočil:

konst transakcijaEmailApi = novo SibApiSDK.TransactionalEmailsApi();
pustiti smtpMailData = novo SibApiSDK.SendSmtpEmail();
konst pošiljatelj = {
 E-naslov: '[email protected]', // Vaš email naslov
 ime: 'Primer pošiljatelja',
};
konst SendWaitlistEmail = asinh (uporabniški podatki) => {
}

The transakcijaEmailApispremenljivka shrani predmet, ki vam omogoča pošiljanje transakcijskih e-poštnih sporočil (kot se imenujejo na SendinBlue). The smtpMailData spremenljivka bo shranila transakcijske e-poštne podatke, ki jih boste potrebovali za pošiljanje vsakega e-poštnega sporočila: prejemnik, vsebina itd.

Zdaj pa k telesu Pošlji e-pošto na čakalni listi funkcijo. Naslednja koda prikazuje, kako naj bi izgledalo telo funkcije.

konst SendWaitlistEmail = asinh (uporabniški podatki) => {
poskusi {
 smtpMailData.sender = pošiljatelj;
 smtpMailData.to = [{
 e-pošta: uporabniški podatki.e-pošta,
 ime: uporabniški podatki.polno ime
 }];
 smtpMailData.subject = 'Ste na čakalni listi!';
 smtpMailData.params = {
'ime': uporabniški podatki.polno ime,
'twitter': '@izkoristijo'
 };
 smtpMailData.htmlVsebina = "
Pozdravljeni {{ params.name }}, "

 + "dobrodošli na čakalni listi makeuseof.com. Obvestili vas bomo"
 + "ko zaženemo. Vljudno nas spremljajte na Twitterju "
 + "{{ params.twitter }}.
";
// Pošlji sporočilo
čakati transactionEmailApi.sendTransacEmail (smtpMailData)
 .potem((podatke) => { 
konzola.log (podatki) // zabeleži e-poštni ID
 })
 .catch((napaka) => {
konzola.error (napaka)
metatinovoNapaka(napaka) // obravnava napake
 })
 } ulov (napaka) {
konzola.log('Prišlo je do napake...')
konzola.error (napaka)
metatinovoNapaka(napaka) // obravnava napake
 }
}

Večina te kode zapolni ključne lastnosti smtpMailData predmet. Po vrstnem redu so to:

• pošiljatelj: Objekt, ki vsebuje dve lastnosti: e-pošto in ime. Zgornja koda uporablja navidezni e-poštni naslov, vendar bi morali uporabiti pravi, delujoči e-poštni naslov za produkcijske aplikacije.
• za: To je niz prejemnikov e-pošte. Elementi tega polja so objekti, definirani s podatki (e-pošta in ime) prejemnika e-pošte. Na sporočilo lahko imate do 50 prejemnikov. Tehnično je mogoče svoje sporočilo poslati več kot 50 osebam hkrati, vendar s tem povečate tveganje, da ga bodo e-poštni agenti obravnavali kot vsiljeno pošto.
• predmet: To je zadeva e-pošte, ki jo želite poslati.
• parametri: To so dodatni podatki, ki jih lahko uporabite v različnih delih vašega e-poštnega sporočila (predvsem predmet in vsebina). Uporabite lahko vrednosti iz tega params predmet tako, da jih zaprete v dvojne zavite oklepaje (tj {{ params.name }}).
• htmlVsebina: Ta lastnost definira telo sporočila. Pomaga določiti telo sporočila e-pošte, ki ga lahko oblikujete s HTML. Ima tudi alternativo, textContent, ki ohranja telo sporočila preprosto.

E-pošta ima lahko več lastnosti in vse jih lahko odkrijete Dokumentacija za razvijalce SendinBlue.

Končno, sendTransacEmail metoda transakcijaEmailApi pošlje e-pošto in vrne ID e-pošte.

Po izvedbi Pošlji e-pošto na čakalni listi funkcijo, jo lahko pokličete v končni točki čakalnega seznama. Zgornja končna točka čakalne vrste bo zdaj videti takole:

server.use('/čakalni seznam', asinh (req, res) => {
poskusi {
konst uporabnik = req.body;
konzola.log(`${user.fullname} se je pridružil čakalni listi`);
// pokliči funkcijo pošiljatelja e-pošte 
čakati SendWaitlistEmail (uporabnik)
 res.status(200).json({ sporočilo: 'Uspešno vpisan na čakalni seznam' })
 } ulov (napaka) {
konzola.error (napaka)
 res.status(500).json({ sporočilo: 'Prišlo je do notranje napake strežnika' })
 }
})

Svojo aplikacijo lahko zaženete in preizkusite končno točko čakalnega seznama v odjemalcu REST API ali s sprednjega dela aplikacije. Tukaj je primer testne zahteve od poštarja.

Tukaj je videti prejeto e-poštno sporočilo. Upoštevajte, da so vrednosti iz params predmeti so prisotni.

Če preverite svoj terminal, boste videli tudi messageId natisnjeno v konzoli. To vrednost lahko shranite v zbirko podatkov ali dnevnik, da identificirate določeno e-pošto.

Morda razmislite tudi o preverjanju nekaterih nasvete, kako preprečiti, da bi e-poštna sporočila prišla med vsiljeno pošto prejemnikov.

Čeprav ta e-poštni sistem deluje pravilno, to, da končna točka neposredno pokliče funkcijo pošiljatelja e-pošte, ni najučinkovitejši pristop. To lahko povzroči, da vaša aplikacija po nepotrebnem čaka med pošiljanjem e-pošte. Da bi se temu izognili, morate postopek optimizirati z izvajanje čakalne vrste opravil za obvladovanje delovne obremenitve e-pošte.

Pošiljanje e-pošte v Node.js še nikoli ni bilo lažje

Zadovoljstvo je ugotoviti, da lahko zelo preprosto zgradite storitev za pošiljanje e-pošte v Node.js.

Poleg obsega tega vodnika lahko s SendinBlue storite še veliko več. Lahko pošljete različne različice e-pošte različnim prejemnikom hkrati, uporabite e-poštne predloge, ki jih ponuja SendinBlue, konfigurirajte webhooke za zaznavanje dejanj vaših prejemnikov e-pošte in ogled v realnem času analitika.

Te funkcije lahko raziščete tako, da jih preverite na portalu za razvijalce in jih implementirate v svoje aplikacije Node.js.