Počnite slati vlastitu e-poštu s ovim prijateljskim API-jem i minimalnim postavkama.

U današnjem brzom digitalnom svijetu marketing putem e-pošte ključan je alat za tvrtke da učinkovito dođu do svojih kupaca. Međutim, implementacija sustava e-pošte može biti složen i dugotrajan proces, posebno za programere koji su novi u tom zadatku.

Srećom, uz Sendinblue, slanje e-pošte vrlo je jednostavan zadatak. Kao platforma softvera kao usluge (SaaS), Sendinblue pruža sve što trebate kao vlasnik tvrtke ili programer da svoju e-poštu vrlo jednostavno prenesete svojim korisnicima.

Što je Sendinblue?

SendinBlue je platforma softvera kao usluge (SaaS) koja nudi marketinško rješenje e-pošte jednostavno za korištenje za mala, srednja i velika poduzeća. SendinBlue pruža platformu koja pomaže tvrtkama da razviju svoje odnose sa svojim klijentima, uglavnom putem usluga e-pošte i SMS-a.

SendinBlue također nudi API-je i alate koji programerima omogućuju automatizaciju i slanje e-pošte i SMS-a. Ovi se alati jednostavno integriraju s Node.js i drugim programskim jezicima za izradu prilagođenih e-mail i SMS kampanja.

instagram viewer

Uz SendinBlue, tvrtke mogu pojednostaviti komunikacijske procese i učinkovitije doći do korisnika ili kupaca.

Kako dobiti vjerodajnice za SendinBlue API

Za korištenje SendinBlue API-ja i SDK-ova, prvi preduvjet je SendinBlue račun. SendinBlue pruža jednostavan postupak prijave, a možete kreirati račun na Stranica za prijavu na SendinBlue.

Napravite račun, unesite tražene podatke i odaberite odgovarajući plan u procesu uključivanja. SendinBlue će vas zatim preusmjeriti na nadzornu ploču gdje ćete moći dobiti svoje API vjerodajnice.

Da biste dobili svoje API vjerodajnice, slijedite korake u nastavku.

  1. Kliknite naziv svoje organizacije u gornjem desnom kutu nadzorne ploče.
  2. Izaberi SMTP i API iz izbornika koji pada.
  3. Prebacite se na API ključevi karticu i kliknite naGenerirajte novi API ključ dugme.
  4. U skočnom prozoru koji se pojavi dodijelite svom ključu naziv, kopirajte generirani niz i pohranite ga na sigurno.

Ovaj niz je vaš API ključ i vjerodajnica vašeg identiteta koju biste trebali pažljivo pohraniti kako ne bi dospjeli u pogrešne ruke.

Kako izgraditi sustav za slanje e-pošte u Node.js

Node.js nema ugrađeni paket e-pošte kao što je Golang. Za slanje e-pošte potreban vam je vanjski paket poput nodemailer ili onaj koji nudi SendinBlue.

Također će vam trebati radno poznavanje Node.js i Node.js razvojnog okruženja na vašem računalu.

Razmotrite ovu jednostavnu aplikaciju Node/Express s a /waitlist krajnja točka:

// server.js
konst izraziti = zahtijevati('izraziti');
// kreiraj poslužitelj
konst server = express();
konst luka = 3333;


server.listen (port, () => {
konzola.log(`poslužitelj sluša port ${port}`);
})


// kreiraj krajnju točku liste čekanja
server.use('/lista čekanja', asinkroni (req, res) => {
probati {
konst korisnik = req.body;
konzola.log(`${user.fullname} pridružio se listi čekanja`);
 res.status(200).json({ poruka: 'Uspješno pridruživanje listi čekanja' })
 } ulov (pogreška) {
konzola.greška (greška)
 res.status(500).json({ poruka: 'Dogodila se pogreška' })
 }
})

Možete koristiti SendinBlue za slanje e-pošte dobrodošlice korisniku koji se pridruži listi čekanja.

Prvi korak je instaliranje SDK-a pomoću npm ili bilo koji drugi upravitelj paketa. Trčanje npm instalirajte sib-api-v3-sdk ili pređa dodati sib-api-v3-sdk u mapi vašeg projekta da biste ga dodali u ovisnosti projekta.

Nakon instalacije, spremni ste za početak slanja e-pošte sa još samo nekoliko redaka koda. Na većem projektu vjerojatno biste željeli izolirati funkciju e-pošte u zasebnoj datoteci. Međutim, za ovu demonstraciju možete nastaviti koristiti isti server.js datoteka.

Uvezi sib-api-v3-sdk paket i postavite SendinBlue klijent kao u nastavku:

konst SibApi = zahtijevati('sib-api-v3-sdk');
// instanciranje novog SendinBlue API klijenta
konst SibKlijent = SibApi. ApiClient.instance;
// Ovjera
SibClient.authentications['api-ključ'].apiKey = proces.env. SIB_API_KEY
 || 'VAŠ_API_KLJUČ_OVDJE';

Zatim postavite konfiguraciju i izradite funkciju za slanje e-poruka dobrodošlice:

konst transakcijaEmailApi = novi SibApiSDK.TransactionalEmailsApi();
neka smtpMailData = novi SibApiSDK.SendSmtpEmail();


konst pošiljatelj = {
 email: '[email protected]', // Vaša email adresa
 Ime: 'Primjer pošiljatelja',
};
konst SendWaitlistEmail = asinkroni (korisnički podaci) => {
}

The transakcijaEmailApivarijabla pohranjuje objekt koji vam omogućuje slanje transakcijske e-pošte (kako se zovu na SendinBlue). The smtpMailData varijabla će pohraniti podatke transakcijske e-pošte koje ćete trebati za slanje svake e-pošte: primatelja, sadržaj itd.

Sada prijeđimo na tijelo Pošalji e-poštu liste čekanja funkcija. Sljedeći kod pokazuje kako bi tijelo funkcije trebalo izgledati.

konst SendWaitlistEmail = asinkroni (korisnički podaci) => {
probati {
 smtpMailData.sender = pošiljatelj;
 smtpMailData.to = [{
 email: userData.email,
 ime: korisnički podaci.puno ime
 }];


 smtpMailData.subject = 'Na listi ste čekanja!';


 smtpMailData.params = {
'Ime': korisnički podaci.puno ime,
'cvrkut': '@iskoristiti'
 };


 smtpMailData.htmlSadržaj = "
Pozdrav {{ params.name }}, "

 + "dobrodošli na makeuseof.com listu čekanja. Obavijestit ćemo vas"
 + "kada lansiramo. Pratite nas na Twitteru "
 + "{{ params.twitter }}.
";
// Pošalji e-mail
čekati transactionEmailApi.sendTransacEmail (smtpMailData)
 .zatim((podaci) => { 
konzola.log (podaci) // zabilježi ID e-pošte
 })
 .ulov((greška) => {
konzola.greška (greška)
bacanjenoviGreška(greška) // obraditi pogreške
 })
 } ulov (pogreška) {
konzola.log('Došlo je do pogreške...')
konzola.greška (greška)
bacanjenoviGreška(greška) // obraditi pogreške
 }
}

Većina ovog koda popunjava ključna svojstva smtpMailData objekt. Redom, to su:

  • pošiljatelj: Objekt koji sadrži dva svojstva: email i ime. Gornji kôd koristi lažnu adresu e-pošte, ali trebali biste koristiti pravu, radnu adresu e-pošte za proizvodne aplikacije.
  • do: Ovo je niz primatelja e-pošte. Elementi ovog polja su objekti definirani podacima (e-mail i ime) primatelja e-pošte. Možete imati do 50 primatelja po poruci. Tehnički, moguće je svoju poruku poslati na više od 50 odjednom, ali time se povećava rizik da je agenti za e-poštu tretiraju kao neželjenu poštu.
  • predmet: Ovo je predmet e-poruke koju treba poslati.
  • parametri: Ovo su dodatni podaci koje možete koristiti u raznim dijelovima svoje e-pošte (uglavnom predmet i sadržaj). Možete koristiti vrijednosti iz ovoga parametri objekt tako što ćete ih staviti u dvostruke vitičaste zagrade (tj {{params.name}}).
  • htmlSadržaj: Ovo svojstvo definira tijelo poruke. Pomaže definirati tijelo poruke e-pošte, koje možete formatirati pomoću HTML-a. Također ima alternativu, textContent, koji tijelo poruke čini jasnim.

E-pošta može imati više svojstava i sve ih možete otkriti Dokumentacija za razvojne programere SendinBlue.

Konačno, sendTransacEmail metoda od transakcijaEmailApi šalje e-poštu i vraća ID e-pošte.

Nakon što je implementirao Pošalji e-poštu liste čekanja funkciju, možete je pozvati u krajnjoj točki liste čekanja. Gornja krajnja točka liste čekanja sada će izgledati ovako:

server.use('/lista čekanja', asinkroni (req, res) => {
probati {
konst korisnik = req.body;
konzola.log(`${user.fullname} pridružio se listi čekanja`);
// pozivanje funkcije pošiljatelja e-pošte 
čekati SendWaitlistEmail (korisnik)
 res.status(200).json({ poruka: 'Uspješno pridruživanje listi čekanja' })
 } ulov (pogreška) {
konzola.greška (greška)
 res.status(500).json({ poruka: 'Došlo je do interne pogreške poslužitelja' })
 }
})

Možete pokrenuti svoju aplikaciju i testirati svoju krajnju točku liste čekanja u REST API klijentu ili iz sučelja svoje aplikacije. Evo primjera testnog zahtjeva od Postmana.

Evo kako izgleda primljeni e-mail. Primijetite da su vrijednosti iz parametri objekti su prisutni.

Ako provjerite svoj terminal, također ćete vidjeti messageId ispisano u konzoli. Ovu vrijednost možete pohraniti u bazu podataka ili zapisnik kako biste identificirali određenu e-poštu.

Također možete razmisliti o provjeri nekih savjete za sprječavanje odlaska e-pošte u neželjenu poštu primatelja.

Iako ovaj sustav e-pošte radi ispravno, izravni poziv krajnje točke funkciji pošiljatelja e-pošte nije najučinkovitiji pristup. To bi moglo uzrokovati nepotrebno čekanje vaše aplikacije dok šalje e-poštu. Da biste to izbjegli, trebali biste optimizirati proces pomoću implementacija reda čekanja zadataka za podnošenje opterećenja e-pošte.

Slanje e-pošte u Node.js nikad nije bilo lakše

Zadovoljstvo je shvatiti da možete vrlo lako izgraditi uslugu za slanje e-pošte u Node.js.

Izvan opsega ovog vodiča, postoji mnogo više što možete učiniti sa SendinBlue. Možete poslati različite verzije e-pošte različitim primateljima odjednom, upotrijebite predloške e-pošte koje nudi SendinBlue, konfigurirajte web-dojavnike za otkrivanje radnji koje poduzimaju vaši primatelji e-pošte i pregledajte u stvarnom vremenu analitika.

Ove značajke možete istražiti tako da ih provjerite na portalu za razvojne programere i implementirate u svoje Node.js aplikacije.