Sähköpostien lähettäminen Node.js: ssä Sendinblue API: n avulla

Nykypäivän nopeatempoisessa digitaalisessa maailmassa sähköpostimarkkinointi on olennainen työkalu yrityksille tavoittaa asiakkaitaan tehokkaasti. Sähköpostijärjestelmän käyttöönotto voi kuitenkin olla monimutkainen ja aikaa vievä prosessi, erityisesti kehittäjille, jotka ovat uusia tehtäviä.

Onneksi Sendinbluella sähköpostien lähettäminen on erittäin helppoa. Software-as-a-service (SaaS) -alustana Sendinblue tarjoaa kaiken mitä tarvitset yrityksen omistajana tai kehittäjänä, jotta sähköpostisi toimitetaan käyttäjillesi helposti.

Mikä Sendinblue on?

SendinBlue on Software-as-a-service (SaaS) -alusta, joka tarjoaa helppokäyttöisen sähköpostimarkkinointiratkaisun pienille, keskisuurille ja suurille yrityksille. SendinBlue tarjoaa alustan, joka auttaa yrityksiä kasvattamaan suhteitaan asiakkaisiinsa pääasiassa sähköposti- ja tekstiviestipalvelujen avulla.

SendinBlue tarjoaa myös sovellusliittymiä ja työkaluja, joiden avulla kehittäjät voivat automatisoida ja lähettää sähköposteja ja tekstiviestejä. Nämä työkalut on helppo integroida Node.js: n ja muiden ohjelmointikielien kanssa räätälöityjen sähköposti- ja tekstiviestikampanjoiden luomiseksi.

SendinBluen avulla yritykset voivat virtaviivaistaa viestintäprosesseja ja tavoittaa käyttäjät tai asiakkaat tehokkaammin.

Kuinka saada SendinBlue API -tunnistetiedot

SendinBlue-sovellusliittymien ja SDK: iden käytön ensimmäinen edellytys on SendinBlue-tili. SendinBlue tarjoaa helpon kirjautumisprosessin, ja voit luoda tilin osoitteessa SendinBluen rekisteröitymissivu.

Luo tili, syötä tarvittavat tiedot ja valitse sopiva suunnitelma perehdytysprosessissa. SendinBlue ohjaa sinut sitten kojelautaan, josta voit saada API-tunnuksesi.

Hanki API-kirjautumistietosi noudattamalla alla olevia ohjeita.

1. Napsauta organisaatiosi nimeä hallintapaneelin oikeassa yläkulmassa.
2. Valitse SMTP ja API avattavasta valikosta.
3. Vaihda kohtaan API-avaimet -välilehteä ja napsautaLuo uusi API-avain -painiketta.
4. Anna avaimelle nimi avautuvassa ponnahdusikkunassa, kopioi luotu merkkijono ja tallenna se sitten turvallisesti.

Tämä merkkijono on API-avaimesi ja henkilöllisyytesi, jotka sinun tulee säilyttää huolellisesti, jotta se ei joudu vääriin käsiin.

Sähköpostin lähetysjärjestelmän rakentaminen Node.js: ssä

Node.js: ssä ei ole a sisäänrakennettu sähköpostipaketti, kuten Golang. Sähköpostien lähettämiseen tarvitset ulkoisen paketin, kuten nodemailer tai SendinBluen tarjoama.

Tarvitset myös Node.js: n ja Node.js-kehitysympäristön koneellesi.

Harkitse tätä yksinkertaista Node/Express-sovellusta a /waitlist päätepiste:

// server.js
konst express = vaatia('ilmaista');
// luo palvelin
konst palvelin = express();
konst portti = 3333;
server.listen (portti, () => {
konsoli.Hirsi(`palvelin kuuntelee portissa ${port}`);
})
// luo jonotuslistan päätepiste
server.use('/ odotuslista', asynk (req, res) => {
yrittää {
konst user = req.body;
konsoli.Hirsi(`${user.fullname} liittyi jonotuslistalle);
 res.status(200).json({ viesti: "Liity jonotuslistalle onnistuneesti" })
 } ottaa kiinni (virhe) {
konsoli.error (virhe)
 res.status(500).json({ viesti: 'Tapahtui virhe' })
 }
})

SendinBluen avulla voit lähettää tervetuloviestin jonotuslistalle liittyneelle käyttäjälle.

Ensimmäinen vaihe on asentaa SDK käyttämällä npm tai muu paketinhallinta. Juosta npm asentaa sib-api-v3-sdk tai lanka lisää sib-api-v3-sdk projektikansiossasi lisätäksesi sen projektin riippuvuuksiin.

Asennuksen jälkeen olet valmis aloittamaan sähköpostien lähettämisen vain muutamalla koodirivillä. Suuremmassa projektissa haluat todennäköisesti eristää sähköpostitoiminnot erilliseen tiedostoon. Voit kuitenkin jatkaa samaa käyttöä tässä esittelyssä server.js tiedosto.

Tuo sib-api-v3-sdk paketti ja määritä SendinBlue-asiakas alla olevalla tavalla:

konst SibApi = vaatia("sib-api-v3-sdk");
// luo uusi SendinBlue API -asiakas
konst SibClient = SibApi. ApiClient.instance;
// Todennus
SibClient.authentications['api-avain'].apiKey = process.env. SIB_API_KEY
 || 'YOUR_API_KEY_HERE';

Määritä seuraavaksi kokoonpano ja luo toiminto tervetulosähköpostien lähettämiseksi:

konst transaktioEmailApi = Uusi SibApiSDK.TransactionalEmailsApi();
antaa smtpMailData = Uusi SibApiSDK.SendSmtpEmail();
konst lähettäjä = {
 sähköposti: '[email protected]', // Sähköpostiosoitteesi
 nimi: "Esimerkkilähettäjä",
};
konst SendWaitlistEmail = asynk (käyttäjätiedot) => {
}

The transaktioEmailApimuuttuja tallentaa objektin, jonka avulla voit lähettää tapahtumasähköpostiviestejä (kuten niitä kutsutaan SendinBluessa). The smtpMailData muuttuja tallentaa tapahtumasähköpostitiedot, jotka sinun on lähetettävä jokaiseen sähköpostiin: vastaanottaja, sisältö jne.

Nyt kehon runkoon SendWaitlistSähköposti toiminto. Seuraava koodi näyttää, miltä funktion rungon tulisi näyttää.

konst SendWaitlistEmail = asynk (käyttäjätiedot) => {
yrittää {
 smtpMailData.sender = lähettäjä;
 smtpMailData.to = [{
 sähköposti: userData.email,
 nimi: userData.fullname
 }];
 smtpMailData.subject = 'Olet jonotuslistalla!';
 smtpMailData.params = {
'nimi': userData.fullname,
'viserrys': '@hyödyntää'
 };
 smtpMailData.htmlSisältö = "
Hei {{ params.name }}, "

 + "Tervetuloa makeuseof.comin jonotuslistalle. Ilmoitamme sinulle"
 + "kun käynnistämme. Seuraa meitä Twitterissä"
 + "{{ params.twitter }}.
";
// lähettää sähköpostia
odottaa tranzakcióEmailApi.sendTransacEmail (smtpMailData)
 .sitten((tiedot) => { 
konsoli.log (data) // kirjaa sähköpostitunnus
 })
 .ottaa kiinni((virhe) => {
konsoli.error (virhe)
heittääUusiVirhe(virhe) // Käsittele virheitä
 })
 } ottaa kiinni (virhe) {
konsoli.Hirsi('Tapahtui virhe...')
konsoli.error (virhe)
heittääUusiVirhe(virhe) // Käsittele virheitä
 }
}

Suurin osa tästä koodista täyttää tärkeimmät ominaisuudet smtpMailData esine. Nämä ovat järjestyksessä:

• lähettäjä: Objekti, joka sisältää kaksi ominaisuutta: sähköpostiosoite ja nimi. Yllä oleva koodi käyttää valesähköpostiosoitetta, mutta tuotantosovelluksissa kannattaa käyttää oikeaa toimivaa sähköpostiosoitetta.
• vastaanottajalle: Tämä on joukko sähköpostin vastaanottajia. Tämän taulukon elementit ovat objekteja, jotka on määritetty sähköpostin vastaanottajan tiedoilla (sähköposti ja nimi). Yhdessä viestissä voi olla enintään 50 vastaanottajaa. Teknisesti on mahdollista lähettää viestisi useammalle kuin 50:lle kerralla, mutta se lisää riskiä, ​​että sähköpostiagentit käsittelevät sitä roskapostina.
• aihe: Tämä on lähetettävän sähköpostin aihe.
• parametrit: Nämä ovat lisätietoja, joita voit käyttää sähköpostisi eri osissa (pääasiassa aihe ja sisältö). Voit käyttää arvoja tästä parametrit objektia sulkemalla ne kaksinkertaisiin kihariin aaltosulkeisiin (esim {{ params.name }}).
• htmlSisältö: Tämä ominaisuus määrittää viestin rungon. Se auttaa määrittämään sähköpostin viestin rungon, jonka voit muotoilla HTML: llä. Sillä on myös vaihtoehto, tekstisisältö, mikä pitää viestin tekstiosan selkeänä.

Sähköpostilla voi olla enemmän ominaisuuksia, ja voit löytää ne kaikki SendinBluen kehittäjädokumentaatio.

Lopuksi, Lähetä TransacEmail menetelmä transaktioEmailApi lähettää sähköpostin ja palauttaa sähköpostin tunnuksen.

Toteutettuaan SendWaitlistSähköposti -toimintoa, voit kutsua sitä jonotuslistan päätepisteessä. Yllä oleva jonotuslistan päätepiste näyttää nyt tältä:

server.use('/ odotuslista', asynk (req, res) => {
yrittää {
konst user = req.body;
konsoli.Hirsi(`${user.fullname} liittyi jonotuslistalle);
// soita sähköpostin lähettäjätoimintoon 
odottaa SendWaitlistEmail (käyttäjä)
 res.status(200).json({ viesti: "Liity jonotuslistalle onnistuneesti" })
 } ottaa kiinni (virhe) {
konsoli.error (virhe)
 res.status(500).json({ viesti: "Tapahtui sisäinen palvelinvirhe" })
 }
})

Voit käynnistää sovelluksesi ja testata odotuslistan päätepistettä REST API -asiakkaassa tai sovelluksesi käyttöliittymästä. Tässä on esimerkki testipyynnöstä Postmanilta.

Tältä vastaanotettu sähköposti näyttää. Huomaa, että arvot parametrit esineet ovat läsnä.

Jos tarkistat terminaalin, näet myös viestitunnus tulostettu konsoliin. Voit tallentaa tämän arvon tietokantaan tai lokiin tietyn sähköpostin tunnistamiseksi.

Voit myös harkita joidenkin tarkistamista vinkkejä, joiden avulla voit estää sähköpostien joutumisen vastaanottajien roskapostiin.

Vaikka tämä sähköpostijärjestelmä toimii oikein, päätepisteen soittaminen suoraan sähköpostin lähettäjälle ei ole tehokkain tapa. Se voi saada sovelluksesi odottamaan tarpeettomasti sähköpostin lähettämisen aikana. Tämän välttämiseksi sinun tulee optimoida prosessi tehtäväjonon toteuttaminen hoitaa sähköpostin työtaakkaa.

Sähköpostien lähettäminen Node.js: ssa ei ole koskaan ollut helpompaa

On ilahduttavaa huomata, että voit rakentaa palvelun sähköpostien lähettämiseen Node.js: ssä erittäin helposti.

Tämän oppaan laajuuden lisäksi SendinBluella voit tehdä paljon muutakin. Voit lähettää eri sähköpostiversioita eri vastaanottajille kerralla käyttämällä sähköpostimalleja SendinBlue, määritä webhookit tunnistamaan sähköpostisi vastaanottajien tekemät toimet ja tarkastelemaan reaaliajassa analytiikka.

Voit tutustua näihin ominaisuuksiin tarkistamalla ne kehittäjäportaalissa ja ottamalla ne käyttöön Node.js-sovelluksissasi.