Kaip siųsti el. laiškus Node.js naudojant Sendinblue API

Šiuolaikiniame sparčiai besivystančiame skaitmeniniame pasaulyje elektroninio pašto rinkodara yra esminė priemonė įmonėms efektyviai pasiekti klientus. Tačiau el. pašto sistemos įdiegimas gali būti sudėtingas ir daug laiko reikalaujantis procesas, ypač kūrėjams, kurie šią užduotį dar nepažįsta.

Laimei, naudojant Sendinblue el. laiškų siuntimas yra labai lengva užduotis. Kaip programinės įrangos kaip paslaugos (SaaS) platforma, Sendinblue suteikia viską, ko jums reikia kaip verslo savininkui ar kūrėjui, kad jūsų el. laiškai būtų labai lengvai pasiekiami vartotojams.

Kas yra Sendinblue?

SendinBlue yra programinės įrangos kaip paslaugos (SaaS) platforma, siūlanti paprastą naudoti el. pašto rinkodaros sprendimą mažoms, vidutinėms ir didelėms įmonėms. SendinBlue yra platforma, kuri padeda įmonėms plėsti santykius su klientais, daugiausia naudojant el. pašto ir SMS paslaugas.

SendinBlue taip pat siūlo API ir įrankius, kurie leidžia kūrėjams automatizuoti ir siųsti el. laiškus bei SMS. Šiuos įrankius paprasta integruoti su Node.js ir kitomis programavimo kalbomis, kad būtų galima sukurti pritaikytas el. pašto ir SMS kampanijas.

Su SendinBlue įmonės gali supaprastinti komunikacijos procesus ir efektyviau pasiekti vartotojus ar klientus.

Kaip gauti SendinBlue API kredencialus

Norint naudoti SendinBlue API ir SDK, pirma būtina sąlyga yra SendinBlue paskyra. „SendinBlue“ suteikia lengvą prisiregistravimo procesą ir galite susikurti paskyrą SendinBlue registracijos puslapis.

Susikurkite paskyrą, įveskite reikiamą informaciją ir prisijungimo procese pasirinkite tinkamą planą. Tada SendinBlue nukreips jus į prietaisų skydelį, kur galėsite gauti API kredencialus.

Norėdami gauti API kredencialus, atlikite toliau nurodytus veiksmus.

1. Viršutiniame dešiniajame prietaisų skydelio kampe spustelėkite savo organizacijos pavadinimą.
2. Pasirinkite SMTP ir API iš išskleidžiamojo meniu.
3. Perjungti į API raktai skirtuką ir spustelėkiteSugeneruokite naują API raktą mygtuką.
4. Pasirodžiusiame iššokančiajame lange suteikite raktui pavadinimą, nukopijuokite sugeneruotą eilutę ir saugiai išsaugokite.

Ši eilutė yra jūsų API raktas ir jūsų tapatybės kredencialas, kurį turėtumėte atidžiai saugoti, kad nepatektų į netinkamas rankas.

Kaip sukurti el. pašto siuntimo sistemą Node.js

Node.js neturi a Integruotas el. pašto paketas, pvz., „Golang“.. Norėdami siųsti el. laiškus, jums reikia išorinio paketo, pvz nodemailer arba tas, kurį teikia SendinBlue.

Taip pat reikės darbo žinių apie Node.js ir Node.js kūrimo aplinką jūsų kompiuteryje.

Apsvarstykite šią paprastą „Node / Express“ programą su a /waitlist galutinis taškas:

// serveris.js
konst išreikšti = reikalauti("išreikšti");
// sukurti serverį
konst serveris = express();
konst prievadas = 3333;
serveris.klausymas (prievadas, () => {
konsolė.log(`serveris klausosi prievade ${port}`);
})
// sukurti laukimo sąrašo galinį tašką
server.use('/laukiamųjų sąrašas', async (req, res) => {
bandyti {
konst user = req.body;
konsolė.log(`${user.fullname} prisijungė prie laukiančiųjų sąrašo“.);
 res.status(200.json({ žinutę: „Sėkmingai prisijungė prie laukiančiųjų sąrašo“ })
 } sugauti (klaida) {
konsolė.error (klaida)
 res.status(500.json({ žinutę: 'Įvyko klaida' })
 }
})

Galite naudoti SendinBlue norėdami išsiųsti sveikinimo laišką vartotojui, kuris prisijungia prie laukiančiųjų sąrašo.

Pirmasis žingsnis yra įdiegti SDK naudojant npm ar bet kuri kita paketų tvarkyklė. Bėk npm įdiegti sib-api-v3-sdk arba verpalai pridėti sib-api-v3-sdk savo projekto aplanke, kad pridėtumėte jį prie projekto priklausomybių.

Įdiegę galite pradėti siųsti el. laiškus su dar keliomis kodo eilutėmis. Didesniame projekte tikriausiai norėsite išskirti el. pašto funkcijas atskirame faile. Tačiau šiai demonstracijai galite ir toliau naudoti tą patį server.js failą.

Importuoti sib-api-v3-sdk paketą ir nustatykite SendinBlue klientą, kaip nurodyta toliau:

konst SibApi = reikalauti(„sib-api-v3-sdk“);
// sukurti naują SendinBlue API klientą
konst SibClient = SibApi. ApiClient.instance;
// Autentifikavimas
SibClient.autentifikacijos['api-key'].apiKey = process.env. SIB_API_KEY
 || „YOUR_API_KEY_HERE“;

Tada nustatykite tam tikrą konfigūraciją ir sukurkite sveikinimo el. laiškų siuntimo funkciją:

konst sandorisEmailApi = naujas SibApiSDK.TransactionalEmailsApi();
leisti smtpMailData = naujas SibApiSDK.SendSmtpEmail();
konst siuntėjas = {
 paštas: '[email protected]', // Jūsų elektroninio pašto adresas
 vardas: "Pavyzdys siuntėjas",
};
konst SendWaitlistEmail = async (naudotojo duomenys) => {
}

The sandorisEmailApikintamasis saugo objektą, leidžiantį siųsti operacijų el. laiškus (kaip jie vadinami SendinBlue). The smtpMailData kintamajame bus saugomi operacijos el. pašto duomenys, kuriuos turėsite išsiųsti kiekvienam el. laiškui: gavėjas, turinys ir kt.

Dabar pereikime prie kūno SendWaitlistEmail funkcija. Šis kodas parodo, kaip turėtų atrodyti funkcijos kūnas.

konst SendWaitlistEmail = async (naudotojo duomenys) => {
bandyti {
 smtpMailData.sender = siuntėjas;
 smtpMailData.to = [{
 paštas: userData.email,
 vardas: userData.fullname
 }];
 smtpMailData.subject = 'Jūs esate laukiančiųjų sąraše!';
 smtpMailData.params = {
'vardas': userData.fullname,
"Twitter": '@pasinaudoti'
 };
 smtpMailData.htmlTurinys = "
Sveiki, {{ params.name }}, "

 + „Sveiki atvykę į makeuseof.com laukiančiųjų sąrašą. Mes jus informuosime"
 + „Kai paleisime. Sekite mus Twitter "
 + „{{ params.twitter }}.
";
// Siųsti laišką
laukti TransactionEmailApi.sendTransacEmail (smtpMailData)
 .thena((duomenis) => { 
konsolė.log (duomenys) // užregistruokite el. pašto adresą
 })
 .catch((klaida) => {
konsolė.error (klaida)
mestinaujasKlaida(klaida) // tvarkyti klaidas
 })
 } sugauti (klaida) {
konsolė.log('Įvyko klaida...')
konsolė.error (klaida)
mestinaujasKlaida(klaida) // tvarkyti klaidas
 }
}

Dauguma šio kodo užpildo pagrindines ypatybes smtpMailData objektas. Iš eilės tai yra:

• siuntėjas: Objektas, turintis dvi ypatybes: el. pašto adresą ir vardą. Aukščiau pateiktame kode naudojamas netikras el. pašto adresas, tačiau gamybinėms programoms turėtumėte naudoti tikrą, veikiantį el. pašto adresą.
• į: Tai el. pašto gavėjų masyvas. Šio masyvo elementai yra objektai, apibrėžti el. pašto gavėjo duomenimis (el. paštu ir vardu). Viename pranešime gali būti iki 50 gavėjų. Techniškai žinutes vienu metu galima išsiųsti daugiau nei 50, tačiau tai padidina riziką, kad el. pašto agentai jį traktuos kaip šlamštą.
• tema: Tai yra siunčiamo el. laiško tema.
• parametrai: Tai papildomi duomenys, kuriuos galite naudoti įvairiose el. laiško dalyse (daugiausia tema ir turinys). Galite naudoti vertes iš to parametrai objektą įsprausdami juos į dvigubas garbanotas petnešas (t. y {{ params.name }}).
• htmlTurinys: Ši savybė apibrėžia pranešimo turinį. Tai padeda apibrėžti el. laiško tekstą, kurį galite formatuoti naudodami HTML. Ji taip pat turi alternatyvą, teksto Turinys, todėl pranešimo tekstas yra aiškus.

El. laiškas gali turėti daugiau ypatybių ir jas visas galite atrasti „SendinBlue“ kūrėjo dokumentacija.

Galiausiai, siųsti TransacEmail metodas sandorisEmailApi išsiunčia el. laišką ir grąžina el. pašto ID.

Įgyvendinus SendWaitlistEmail funkciją, galite ją iškviesti laukiančiųjų sąrašo galutiniame taške. Aukščiau pateiktas laukimo sąrašo galutinis taškas dabar atrodys taip:

server.use('/laukiamųjų sąrašas', async (req, res) => {
bandyti {
konst user = req.body;
konsolė.log(`${user.fullname} prisijungė prie laukiančiųjų sąrašo“.);
// skambinti el. pašto siuntėjo funkcija 
laukti SendWaitlistEmail (vartotojas)
 res.status(200.json({ žinutę: „Sėkmingai prisijungė prie laukiančiųjų sąrašo“ })
 } sugauti (klaida) {
konsolė.error (klaida)
 res.status(500.json({ žinutę: „Įvyko vidinė serverio klaida“ })
 }
})

Galite paleisti programą ir išbandyti laukiančiųjų sąrašo galutinį tašką REST API kliente arba iš savo programos sąsajos. Štai „Postman“ bandymo užklausos pavyzdys.

Štai kaip atrodo gautas el. Atkreipkite dėmesį, kad vertės iš parametrai objektas yra.

Jei patikrinsite savo terminalą, taip pat pamatysite pranešimo ID atspausdinta konsolėje. Šią reikšmę galite išsaugoti duomenų bazėje arba žurnale, kad identifikuotumėte konkretų el.

Taip pat galite apsvarstyti kai kuriuos patikrinimus patarimai, kaip apsisaugoti, kad el. laiškai nepatektų į gavėjų šlamštą.

Nors ši el. pašto sistema veikia tinkamai, galutinio taško tiesioginis skambinimas el. pašto siuntėjo funkcijai nėra pats efektyviausias būdas. Dėl to jūsų programa gali be reikalo laukti, kol išsiųs el. laišką. Norėdami to išvengti, turėtumėte optimizuoti procesą įgyvendinant užduočių eilę pašto darbo krūviui tvarkyti.

El. laiškų siuntimas naudojant Node.js dar niekada nebuvo taip paprastas

Malonu suvokti, kad labai lengvai galite sukurti paslaugą el. laiškų siuntimui Node.js.

Be šio vadovo taikymo srities, su SendinBlue galite nuveikti daug daugiau. Galite siųsti skirtingas el. pašto versijas skirtingiems gavėjams vienu metu, naudokite pateiktus el. pašto šablonus SendinBlue, sukonfigūruokite žiniatinklio kabliukus, kad aptiktų el. pašto gavėjų veiksmus ir peržiūrėtų realiuoju laiku analitika.

Galite ištirti šias funkcijas, patikrinę jas kūrėjų portale ir įdiegę jas savo Node.js programose.