Cum să trimiteți e-mailuri în Node.js folosind API-ul Sendinblue

În lumea digitală rapidă de astăzi, marketingul prin e-mail este un instrument esențial pentru ca companiile să își ajungă în mod eficient clienții. Cu toate acestea, implementarea unui sistem de e-mail poate fi un proces complex și consumator de timp, în special pentru dezvoltatorii care sunt noi în această sarcină.

Din fericire, cu Sendinblue, trimiterea de e-mailuri este o sarcină foarte ușoară. Ca platformă software-as-a-service (SaaS), Sendinblue oferă tot ce aveți nevoie în calitate de proprietar sau dezvoltator de afaceri pentru a vă transmite e-mailurile utilizatorilor foarte ușor.

Ce este Sendinblue?

SendinBlue este o platformă software-as-a-service (SaaS) care oferă o soluție de marketing prin e-mail ușor de utilizat pentru întreprinderile mici, mijlocii și mari. SendinBlue oferă o platformă care ajută companiile să-și dezvolte relațiile cu clienții, în principal prin servicii de e-mail și SMS.

SendinBlue oferă, de asemenea, API-uri și instrumente care permit dezvoltatorilor să automatizeze și să trimită e-mailuri și SMS-uri. Aceste instrumente sunt ușor de integrat cu Node.js și alte limbaje de programare pentru a crea campanii personalizate de e-mail și SMS.

Cu SendinBlue, companiile pot eficientiza procesele de comunicare și pot ajunge la utilizatori sau clienți mai eficient.

Cum să obțineți acreditările API SendinBlue

Pentru a utiliza API-urile și SDK-urile SendinBlue, prima condiție prealabilă este un cont SendinBlue. SendinBlue oferă un proces ușor de înregistrare și vă puteți crea un cont pe Pagina de înscriere SendinBlue.

Creați un cont, introduceți detaliile necesare și alegeți un plan potrivit în procesul de înscriere. SendinBlue vă va redirecționa apoi către tabloul de bord de unde veți putea obține acreditările API.

Pentru a obține acreditările API, urmați pașii de mai jos.

1. Faceți clic pe numele organizației dvs. în colțul din dreapta sus al tabloului de bord.
2. Selectați SMTP și API din meniul care se derulează.
3. Comutați la Chei API fila și faceți clic peGenerați o nouă cheie API buton.
4. În fereastra pop-up care apare, dați un nume cheii, copiați șirul generat, apoi stocați-l în siguranță.

Acest șir este cheia dvs. API și acreditările dvs. de identitate pe care ar trebui să le stocați cu atenție, astfel încât să nu cadă în mâini greșite.

Cum să construiți un sistem de trimitere a e-mailurilor în Node.js

Node.js nu are un pachet de e-mail încorporat precum Golang. Pentru a trimite e-mailuri, aveți nevoie de un pachet extern, cum ar fi nodemailer sau cel oferit de SendinBlue.

De asemenea, veți avea nevoie de cunoștințe de lucru despre Node.js și un mediu de dezvoltare Node.js pe mașina dvs.

Luați în considerare această aplicație simplă Node/Express cu a /waitlist punct final:

// server.js
const expres = cere('expres');
// creează un server
const server = expres();
const port = 3333;
server.listen (port, () => {
consolă.Buturuga(`server care ascultă pe port ${port}`);
})
// creează punctul final al listei de așteptare
server.use('/Lista de așteptare', asincron (req, res) => {
încerca {
const utilizator = req.body;
consolă.Buturuga(`${user.fullname} s-a înscris pe lista de așteptare`);
 starea res.(200).json({ mesaj: „S-a înscris cu succes pe lista de așteptare” })
 } captură (eroare) {
consolă.eroare (eroare)
 starea res.(500).json({ mesaj: 'A aparut o eroare' })
 }
})

Puteți folosi SendinBlue pentru a trimite un e-mail de bun venit unui utilizator care se alătură listei de așteptare.

Primul pas este să instalați SDK-ul folosind npm sau orice alt manager de pachete. Alerga npm instalează sib-api-v3-sdk sau yarn add sib-api-v3-sdk în folderul proiectului pentru a-l adăuga la dependențele proiectului.

După instalare, sunteți gata să începeți să trimiteți e-mailuri cu doar câteva linii de cod. La un proiect mai mare, probabil că ați dori să izolați funcționalitatea de e-mail într-un fișier separat. Cu toate acestea, pentru această demonstrație, puteți continua să utilizați același lucru server.js fişier.

Importă sib-api-v3-sdk pachet și configurați clientul SendinBlue ca mai jos:

const SibApi = cere(„sib-api-v3-sdk”);
// instanțiază noul client API SendinBlue
const SibClient = SibApi. ApiClient.instance;
// Autentificare
SibClient.authentications[„cheie api”].apiKey = process.env. SIB_API_KEY
 || „YOUR_API_KEY_HERE”;

Apoi, configurați o configurație și creați o funcție pentru a trimite e-mailurile de bun venit:

const transactionEmailApi = nou SibApiSDK.TransactionalEmailsApi();
lăsa smtpMailData = nou SibApiSDK.SendSmtpEmail();
const expeditor = {
 e-mail: „sendinbluemail@example.com”, // Adresa dvs. de e-mail
 Nume: „Exemplu de expeditor”,
};
const SendWaitlistEmail = asincron (userData) => {
}

The transactionEmailApivariabila stochează un obiect care vă permite să trimiteți e-mailuri de tranzacție (cum sunt numite pe SendinBlue). The smtpMailData variabila va stoca datele de e-mail ale tranzacției de care veți avea nevoie pentru a trimite fiecare e-mail: destinatar, conținut etc.

Acum, la corpul lui Trimite lista de așteptare e-mail funcţie. Următorul cod arată cum ar trebui să arate corpul funcției.

const SendWaitlistEmail = asincron (userData) => {
încerca {
 smtpMailData.sender = expeditor;
 smtpMailData.to = [{
 e-mail: userData.email,
 nume: userData.fullname
 }];
 smtpMailData.subject = — Ești pe lista de așteptare!;
 smtpMailData.params = {
'Nume': userData.fullname,
'stare de nervozitate': '@a se folosi de'
 };
 smtpMailData.htmlContent = "
Bună ziua {{ params.name }}, "

 + „Bine ați venit pe lista de așteptare makeuseof.com. Vă vom anunța"
 + „când lansăm. Vă rugăm să ne urmăriți pe Twitter "
 + „{{ params.twitter }}.
";
// Trimite email
așteaptă transactionEmailApi.sendTransacEmail (smtpMailData)
 .apoi((date) => { 
consolă.log (date) // înregistrează ID-ul de e-mail
 })
 .captură((eroare) => {
consolă.eroare (eroare)
aruncanouEroare(eroare) // gestionează erorile
 })
 } captură (eroare) {
consolă.Buturuga('A aparut o eroare...')
consolă.eroare (eroare)
aruncanouEroare(eroare) // gestionează erorile
 }
}

Majoritatea acestui cod populează proprietățile cheie ale smtpMailData obiect. În ordine, acestea sunt:

• expeditor: Un obiect care conține două proprietăți: e-mail și nume. Codul de mai sus folosește o adresă de e-mail falsă, dar ar trebui să utilizați o adresă de e-mail reală și funcțională pentru aplicațiile de producție.
• la: Aceasta este o serie de destinatari de e-mail. Elementele acestei matrice sunt obiecte definite cu datele (email și numele) destinatarului e-mailului. Puteți avea până la 50 de destinatari per mesaj. Din punct de vedere tehnic, este posibil să trimiteți mesajul la mai mult de 50 de persoane simultan, dar acest lucru crește riscul ca agenții de e-mail să îl trateze ca spam.
• subiect: Acesta este subiectul e-mailului de trimis.
• parametri: Acestea sunt date suplimentare pe care le puteți utiliza în diferite părți ale e-mailului dvs. (în principal subiectul și conținutul). Puteți folosi valori din aceasta parametrii obiect prin includerea lor în acolade duble (de ex {{ params.name }}).
• htmlConținut: Această proprietate definește corpul mesajului. Vă ajută să definiți corpul mesajului e-mailului, pe care îl puteți formata folosind HTML. Are și o alternativă, textContent, care păstrează simplu corpul mesajului.

E-mailul poate avea mai multe proprietăți și le puteți descoperi pe toate în Documentația pentru dezvoltatori SendinBlue.

În cele din urmă, cel trimiteTransacEmail Metodă de transactionEmailApi trimite e-mailul și returnează ID-ul e-mailului.

După ce a implementat Trimite lista de așteptare e-mail funcția, o puteți apela în punctul final al listei de așteptare. Punctul final al listei de așteptare de mai sus va arăta acum astfel:

server.use('/Lista de așteptare', asincron (req, res) => {
încerca {
const utilizator = req.body;
consolă.Buturuga(`${user.fullname} s-a înscris pe lista de așteptare`);
// apelează funcția de expeditor de e-mail 
așteaptă SendWaitlistEmail (utilizator)
 starea res.(200).json({ mesaj: „S-a înscris cu succes pe lista de așteptare” })
 } captură (eroare) {
consolă.eroare (eroare)
 starea res.(500).json({ mesaj: „A apărut o eroare internă de server” })
 }
})

Vă puteți porni aplicația și puteți testa punctul final al listei de așteptare într-un client API REST sau din interfața aplicației dvs. Iată un exemplu de solicitare de testare de la Postman.

Iată cum arată e-mailul primit. Observați că valorile din parametrii obiect sunt prezente.

Dacă vă verificați terminalul, veți vedea, de asemenea, mesaj ID imprimat în consolă. Puteți stoca această valoare într-o bază de date sau într-un jurnal pentru a identifica un anumit e-mail.

Puteți lua în considerare și să verificați unele sfaturi pentru a preveni ca e-mailurile să ajungă la spam-ul destinatarilor.

Deși acest sistem de e-mail funcționează corect, faptul că punctul final apelează direct funcția de expeditor de e-mail nu este cea mai eficientă abordare. Ar putea face ca aplicația dvs. să aștepte inutil în timp ce trimite e-mailul. Pentru a evita acest lucru, ar trebui să optimizați procesul prin implementarea unei coade de sarcini pentru a gestiona sarcina de lucru prin e-mail.

Trimiterea de e-mailuri în Node.js nu a fost niciodată mai ușoară

Este satisfăcător să realizezi că poți construi un serviciu pentru a trimite e-mailuri în Node.js foarte ușor.

Dincolo de scopul acestui ghid, puteți face mult mai multe cu SendinBlue. Puteți trimite diferite versiuni de e-mail către diferiți destinatari simultan, utilizați șabloanele de e-mail furnizate de SendinBlue, configurați webhook-uri pentru a detecta acțiunile întreprinse de destinatarii dvs. de e-mail și vizualizați în timp real analitice.

Puteți explora aceste funcții verificându-le în portalul pentru dezvoltatori și implementându-le în aplicațiile dvs. Node.js.