Alustage oma meili saatmist selle sõbraliku API ja minimaalse seadistamisega.

Tänapäeva kiires digimaailmas on meiliturundus oluline tööriist, mis võimaldab ettevõtetel tõhusalt klientideni jõuda. E-posti süsteemi juurutamine võib aga olla keeruline ja aeganõudev protsess, eriti arendajatele, kes pole selle ülesandega uudsed.

Õnneks on Sendinblue'iga meilide saatmine väga lihtne. Tarkvara-teenusena (SaaS) platvormina pakub Sendinblue kõike, mida vajate ettevõtte omaniku või arendajana, et teie meilid kasutajateni jõuaksid väga lihtsalt.

Mis on Sendinblue?

SendinBlue on tarkvara-teenusena (SaaS) platvorm, mis pakub väikestele, keskmise suurusega ja suurtele ettevõtetele lihtsalt kasutatavat meiliturunduslahendust. SendinBlue pakub platvormi, mis aitab ettevõtetel arendada suhteid oma klientidega, peamiselt meili- ja SMS-teenuste kaudu.

SendinBlue pakub ka API-sid ja tööriistu, mis võimaldavad arendajatel automatiseerida ja saata e-kirju ja SMS-e. Neid tööriistu on lihtne Node.js-i ja teiste programmeerimiskeeltega integreerida, et luua kohandatud meili- ja SMS-kampaaniaid.

instagram viewer

SendinBlue abil saavad ettevõtted sujuvamaks muuta suhtlusprotsesse ning jõuda kasutajate või klientideni tõhusamalt.

Kuidas saada SendinBlue API mandaate

SendinBlue API-de ja SDK-de kasutamiseks on esimene eeltingimus SendinBlue konto olemasolu. SendinBlue pakub lihtsat registreerumisprotsessi ja saate konto luua SendinBlue registreerimisleht.

Looge konto, sisestage vajalikud andmed ja valige liitumisprotsessis sobiv plaan. SendinBlue suunab teid seejärel teie armatuurlauale, kust saate oma API mandaadid hankida.

API mandaatide hankimiseks järgige alltoodud samme.

  1. Klõpsake juhtpaneeli paremas ülanurgas oma organisatsiooni nimel.
  2. Valige SMTP ja API rippmenüüst.
  3. Lülituge valikule API võtmed vahekaarti ja klõpsake nuppuLooge uus API-võti nuppu.
  4. Ilmuvas hüpikaknas andke oma võtmele nimi, kopeerige loodud string ja salvestage see siis turvaliselt.

See string on teie API-võti ja teie identiteedimandaat, mida peaksite hoolikalt säilitama, et see ei satuks valedesse kätesse.

Kuidas luua Node.js-is meili saatmissüsteem

Node.js-il pole a sisseehitatud meilipakett nagu Golang. Meilide saatmiseks vajate välist paketti nagu nodemailer või see, mida SendinBlue pakub.

Teil on vaja ka tööalaseid teadmisi Node.js-i ja Node.js-i arenduskeskkonna kohta oma masinas.

Mõelge sellele lihtsale Node/Expressi rakendusele koos a /waitlist lõpp-punkt:

// server.js
konst väljendada = nõuda('väljendama');
// loo server
konst server = express();
konst port = 3333;


server.listen (port, () => {
konsool.log(`server kuulab pordis ${port}`);
})


// ootenimekirja lõpp-punkti loomine
server.use('/ootenimekiri', asünkr (req, res) => {
proovi {
konst kasutaja = req.body;
konsool.log(`${user.fullname} liitus ootenimekirjaga’);
 res.status(200).json({ sõnum: "Ootenimekirjaga liitumine õnnestus" })
 } püüda (viga) {
konsool.error (viga)
 res.status(500).json({ sõnum: 'Ilmnes viga' })
 }
})

Saate kasutada SendinBlue'i, et saata ootenimekirjaga liitunud kasutajale tervitusmeil.

Esimene samm on SDK installimine kasutades npm või mõni muu paketihaldur. Jookse npm installige sib-api-v3-sdk või lõng lisa sib-api-v3-sdk projekti kaustas, et lisada see projekti sõltuvustesse.

Pärast installimist olete valmis alustama meilide saatmist vaid mõne koodireaga. Suurema projekti puhul soovite tõenäoliselt eraldada e-posti funktsioonid eraldi faili. Kuid selle demonstratsiooni jaoks võite jätkata sama kasutamist server.js faili.

Importige sib-api-v3-sdk pakett ja seadistage SendinBlue klient nagu allpool:

konst SibApi = nõuda('sib-api-v3-sdk');
// looge uus SendinBlue API klient
konst SibClient = SibApi. ApiClient.instance;
// Autentimine
SibClient.authentications['api-võti'].apiKey = process.env. SIB_API_KEY
 || 'YOUR_API_KEY_HERE';

Järgmisena seadistage konfiguratsioon ja looge funktsioon tervituskirjade saatmiseks:

konst tehinguEmailApi = uus SibApiSDK.TransactionalEmailsApi();
lase smtpMailData = uus SibApiSDK.SendSmtpEmail();


konst saatja = {
 email: 'saadavabluemail@example.com', // sinu emaili aadress
 nimi: "Näidisaatja",
};
konst SendWaitlistEmail = asünkr (kasutajaandmed) => {
}

The tehingu EmailApimuutuja salvestab objekti, mis võimaldab teil saata tehingumeile (nagu neid SendinBlue'is kutsutakse). The smtpMailData muutuja salvestab tehingute meiliandmed, mida peate iga meili saatma: saaja, sisu jne.

Nüüd aga korpuse juurde SendWaitlistEmail funktsiooni. Järgmine kood näitab, milline peaks funktsiooni keha välja nägema.

konst SendWaitlistEmail = asünkr (kasutajaandmed) => {
proovi {
 smtpMailData.sender = saatja;
 smtpMailData.to = [{
 email: userData.email,
 nimi: kasutajaandmed.täisnimi
 }];


 smtpMailData.subject = "Sa oled ootenimekirjas!";


 smtpMailData.params = {
'nimi': userData.fullname,
'twitter': '@makeuseof'
 };


 smtpMailData.htmlSisu = "
Tere, {{ params.name }}, "

 + "Tere tulemast makeuseof.com ootenimekirja. Anname teile teada"
 + "Kui käivitame. Jälgige meid Twitteris"
 + "{{ params.twitter }}.
";
// saada email
ootama tranzakcióEmailApi.sendTransacEmail (smtpMailData)
 .hen((andmeid) => { 
konsool.log (andmed) // logige e-posti ID
 })
 .catch((viga) => {
konsool.error (viga)
viskamauusViga(viga) // käsitseda vigu
 })
 } püüda (viga) {
konsool.log("Tekkis viga...")
konsool.error (viga)
viskamauusViga(viga) // käsitseda vigu
 }
}

Suurem osa sellest koodist täidab põhiomadused smtpMailData objektiks. Järjekorras on need:

  • saatja: Objekt, mis sisaldab kahte atribuuti: e-post ja nimi. Ülaltoodud kood kasutab näivat e-posti aadressi, kuid tootmisrakenduste jaoks peaksite kasutama tõelist töötavat e-posti aadressi.
  • kellele: See on e-kirjade saajate hulk. Selle massiivi elemendid on objektid, mis on määratletud meili saaja andmetega (e-post ja nimi). Ühes kirjas võib olla kuni 50 adressaati. Tehniliselt on võimalik saata oma sõnum korraga rohkem kui 50-le, kuid see suurendab ohtu, et meiliagentid käsitlevad seda rämpspostina.
  • teema: See on saadetava meili teema.
  • parameetrid: Need on lisaandmed, mida saate kasutada oma meili erinevates osades (peamiselt teema ja sisu). Saate kasutada selle väärtusi parameetrid objekti, sulgedes need topelt lokkis traksidega (st {{ params.name }}).
  • htmlSisu: See atribuut määrab sõnumi sisu. See aitab määratleda meilisõnumi sisu, mida saate HTML-i abil vormindada. Sellel on ka alternatiiv, tekstSisu, mis hoiab sõnumi sisu selgena.

Meilil võib olla rohkem atribuute ja saate need kõik avastada SendinBlue'i arendaja dokumentatsioon.

Lõpuks, saatke TransacEmail meetod tehingu EmailApi saadab meili ja tagastab meili ID.

Olles rakendanud SendWaitlistEmail funktsiooni, võite seda kutsuda ootenimekirja lõpp-punktis. Ülaltoodud ootenimekirja lõpp-punkt näeb nüüd välja selline:

server.use('/ootenimekiri', asünkr (req, res) => {
proovi {
konst kasutaja = req.body;
konsool.log(`${user.fullname} liitus ootenimekirjaga’);
// helista e-posti saatja funktsioonile 
ootama SendWaitlistEmail (kasutaja)
 res.status(200).json({ sõnum: "Ootenimekirjaga liitumine õnnestus" })
 } püüda (viga) {
konsool.error (viga)
 res.status(500).json({ sõnum: "Tekkis sisemine serveri viga" })
 }
})

Saate käivitada oma rakenduse ja testida ootenimekirja lõpp-punkti REST API kliendis või rakenduse esiprogrammis. Siin on Postmani testitaotluse näide.

Saabunud e-kiri näeb välja selline. Pange tähele, et väärtused alates parameetrid objekt on olemas.

Kui kontrollite oma terminali, näete ka sõnumi ID prinditakse konsooli. Konkreetse meili tuvastamiseks saate selle väärtuse salvestada andmebaasi või logisse.

Samuti võite kaaluda mõne kontrollimist näpunäiteid, kuidas vältida e-kirjade sattumist adressaatide rämpsposti.

Kuigi see meilisüsteem töötab õigesti, ei ole lõpp-punkti otse meili saatja funktsiooni kutsumine kõige tõhusam viis. See võib põhjustada teie rakenduse tarbetut ootamist, kuni see meili saadab. Selle vältimiseks peaksite protsessi optimeerima ülesannete järjekorra rakendamine meilitöökoormusega toimetulemiseks.

Meilide saatmine Node.js-is pole kunagi olnud lihtsam

Rõõmustav on tõdeda, et saate luua teenuse Node.js-is meilide saatmiseks väga lihtsalt.

Lisaks selle juhendi ulatusele saate SendinBlue'iga teha palju muud. Saate saata erinevatele adressaatidele korraga erinevaid meiliversioone, kasutades selleks pakutavaid meilimalle SendinBlue, konfigureerige veebihaagid, et tuvastada teie meilisaajate tehtud toiminguid ja vaadata reaalajas analüütika.

Saate neid funktsioone uurida, kontrollides neid arendajaportaalis ja juurutades need oma Node.js rakendustes.