E-mails verzenden in Node.js met behulp van de Sendinblue API

In de snelle digitale wereld van vandaag is e-mailmarketing een essentiële tool voor bedrijven om hun klanten effectief te bereiken. Het implementeren van een e-mailsysteem kan echter een complex en tijdrovend proces zijn, vooral voor ontwikkelaars die nieuw zijn in deze taak.

Gelukkig is het verzenden van e-mails met Sendinblue een heel gemakkelijke taak. Als een software-as-a-service (SaaS)-platform biedt Sendinblue alles wat u als bedrijfseigenaar of ontwikkelaar nodig heeft om uw e-mails heel gemakkelijk aan uw gebruikers over te brengen.

Wat is Sendinblue?

SendinBlue is een software-as-a-service (SaaS)-platform dat een gebruiksvriendelijke e-mailmarketingoplossing biedt voor kleine, middelgrote en grote bedrijven. SendinBlue biedt een platform dat bedrijven helpt hun relaties met hun klanten te laten groeien, voornamelijk via e-mail- en sms-diensten.

SendinBlue biedt ook API's en tools waarmee ontwikkelaars e-mails en sms kunnen automatiseren en verzenden. Deze tools zijn eenvoudig te integreren met Node.js en andere programmeertalen om aangepaste e-mail- en sms-campagnes te maken.

Met SendinBlue kunnen bedrijven communicatieprocessen stroomlijnen en gebruikers of klanten efficiënter bereiken.

Hoe SendinBlue API-referenties te verkrijgen

Om SendinBlue API's en SDK's te gebruiken, is de eerste vereiste een SendinBlue-account. SendinBlue biedt een eenvoudig aanmeldingsproces en u kunt een account aanmaken op de SendinBlue-aanmeldingspagina.

Maak een account aan, voer de vereiste gegevens in en kies een geschikt abonnement in het onboardingproces. SendinBlue zal u vervolgens doorverwijzen naar uw dashboard waar u uw API-referenties kunt krijgen.

Volg de onderstaande stappen om uw API-referenties te verkrijgen.

1. Klik op de naam van uw organisatie in de rechterbovenhoek van het dashboard.
2. Selecteer SMTP & API uit het menu dat naar beneden valt.
3. Schakel over naar de API-sleutels tabblad en klik op deGenereer een nieuwe API-sleutel knop.
4. In de pop-up die verschijnt, geeft u uw sleutel een naam, kopieert u de gegenereerde tekenreeks en slaat u deze veilig op.

Deze tekenreeks is uw API-sleutel en uw identiteitsreferentie die u zorgvuldig moet bewaren, zodat deze niet in verkeerde handen valt.

Hoe een e-mailverzendsysteem te bouwen in Node.js

Node.js heeft geen ingebouwd e-mailpakket zoals Golang. Om e-mails te versturen heb je een extern pakket nodig zoals nodemailer of degene die SendinBlue biedt.

U hebt ook praktische kennis van Node.js en een Node.js-ontwikkelomgeving op uw computer nodig.

Overweeg deze eenvoudige Node/Express-toepassing met een /waitlist eindpunt:

// server.js
const uitdrukken = vereisen('nadrukkelijk');
// server aanmaken
const server = uitdrukken();
const poort = 3333;
server.luister (poort, () => {
troosten.log(`server luistert op poort ${poort}`);
})
// maak een wachtlijsteindpunt
server.gebruik('/wachtlijst', asynchroon (req, res) => {
poging {
const gebruiker = aanvraaglichaam;
troosten.log(`${gebruiker.volledige naam} toegetreden tot de wachtlijst`);
 res.status(200.json({ bericht: 'Succesvol ingeschreven op wachtlijst' })
 } vangst (fout) {
troosten.fout (fout)
 res.status(500.json({ bericht: 'Er is een fout opgetreden' })
 }
})

U kunt SendinBlue gebruiken om een ​​welkomstmail te sturen naar een gebruiker die op de wachtlijst komt.

De eerste stap is het installeren van de SDK met behulp van npm of een andere pakketbeheerder. Loop npm installeer sib-api-v3-sdk of garen voeg sib-api-v3-sdk toe in uw projectmap om het toe te voegen aan de afhankelijkheden van het project.

Na de installatie bent u klaar om e-mails te verzenden met nog maar een paar regels code. Bij een groter project wilt u waarschijnlijk de e-mailfunctionaliteit isoleren in een apart bestand. Voor deze demonstratie kunt u echter hetzelfde blijven gebruiken server.js bestand.

Importeer de sib-api-v3-sdk pakket en stel de SendinBlue-client in zoals hieronder:

const SibApi = vereisen('sib-api-v3-sdk');
// creëer een nieuwe SendinBlue API-client
const SibClient = SibApi. ApiClient.exemplaar;
// Authenticatie
SibClient.authenticaties['API sleutel'].apiKey = proces.env. SIB_API_KEY
 || 'JOUW_API_KEY_HIER';

Stel vervolgens een configuratie in en maak een functie om de welkomst-e-mails te verzenden:

const transactieEmailApi = nieuw SibApiSDK.TransactionalEmailsApi();
laten smtpMailData = nieuw SibApiSDK.SendSmtpEmail();
const afzender = {
 e-mail: '[email protected]', // jouw e-mailadres
 naam: 'Voorbeeld afzender',
};
const SendWaitlistEmail = asynchroon (gebruikersgegevens) => {
}

De transactieEmailApivariabele slaat een object op waarmee u transactie-e-mails kunt verzenden (zoals ze worden genoemd op SendinBlue). De smtpMailData variabele slaat de transactie-e-mailgegevens op die u nodig hebt om elke e-mail te verzenden: de ontvanger, inhoud, enz.

Nu op naar het lichaam van de Wachtlijste-mail verzenden functie. De volgende code laat zien hoe de body van de functie eruit zou moeten zien.

const SendWaitlistEmail = asynchroon (gebruikersgegevens) => {
poging {
 smtpMailData.sender = afzender;
 smtpMailData.to = [{
 e-mail: userData.email,
 naam: userData.volledige naam
 }];
 smtpMailData.onderwerp = 'Je staat op de wachtlijst!';
 smtpMailData.params = {
'naam': userData.volledige naam,
'twitteren': '@gebruikmaken van'
 };
 smtpMailData.htmlContent = "
Hallo {{ params.name }}, "

 + "welkom op de wachtlijst van makeuseof.com. We houden je op de hoogte"
 + "wanneer we lanceren. Volg ons op Twitter "
 + "{{ params.twitter }}.
";
// stuur e-mail
wachten transactionEmailApi.sendTransacEmail (smtpMailData)
 .Dan((gegevens) => { 
troosten.log (gegevens) // log de e-mail-ID in
 })
 .vangst((fout) => {
troosten.fout (fout)
gooiennieuwFout(fout) // omgaan met fouten
 })
 } vangst (fout) {
troosten.log('Er is een fout opgetreden...')
troosten.fout (fout)
gooiennieuwFout(fout) // omgaan met fouten
 }
}

Het grootste deel van deze code vult de belangrijkste eigenschappen van het smtpMailData voorwerp. In volgorde zijn dit:

• afzender: Een object met twee eigenschappen: e-mail en naam. De bovenstaande code gebruikt een dummy e-mailadres, maar u moet een echt, werkend e-mailadres gebruiken voor productietoepassingen.
• naar: Dit is een reeks e-mailontvangers. De elementen van deze array zijn objecten die zijn gedefinieerd met de gegevens (e-mail en naam) van de e-mailontvanger. U kunt maximaal 50 ontvangers per bericht hebben. Technisch gezien is het mogelijk om uw bericht naar meer dan 50 tegelijk te sturen, maar als u dit doet, loopt u het risico dat e-mailagenten het als spam behandelen.
• onderwerp: Dit is het onderwerp van de te verzenden e-mail.
• parameters: Dit zijn aanvullende gegevens die u in verschillende onderdelen van uw e-mail kunt gebruiken (voornamelijk het onderwerp en de inhoud). U kunt hier waarden uit gebruiken parameters object door ze tussen dubbele accolades te plaatsen (d.w.z {{ params.name }}).
• htmlInhoud: Deze eigenschap definieert de hoofdtekst van het bericht. Het helpt om de berichttekst van de e-mail te definiëren, die u kunt opmaken met behulp van HTML. Er is ook een alternatief tekstInhoud, waardoor de berichttekst duidelijk blijft.

De e-mail kan meer eigenschappen hebben en u kunt ze allemaal ontdekken SendinBlue's ontwikkelaarsdocumentatie.

eindelijk, de stuurTransacEmail methode van transactieEmailApi verzendt de e-mail en geeft de ID van de e-mail terug.

Het implementeren van de Wachtlijste-mail verzenden functie, kunt u deze aanroepen in het wachtlijsteindpunt. Het bovenstaande wachtlijsteindpunt ziet er nu als volgt uit:

server.gebruik('/wachtlijst', asynchroon (req, res) => {
poging {
const gebruiker = aanvraaglichaam;
troosten.log(`${gebruiker.volledige naam} toegetreden tot de wachtlijst`);
// bel de afzenderfunctie van e-mail 
wachten SendWaitlistEmail (gebruiker)
 res.status(200.json({ bericht: 'Succesvol ingeschreven op wachtlijst' })
 } vangst (fout) {
troosten.fout (fout)
 res.status(500.json({ bericht: 'Er is een interne serverfout opgetreden' })
 }
})

U kunt uw toepassing starten en uw wachtlijsteindpunt testen in een REST API-client of vanaf de frontend van uw toepassing. Hier is een voorbeeld van een testverzoek van Postman.

Zo ziet de ontvangen e-mail eruit. Merk op dat de waarden van de parameters voorwerp aanwezig zijn.

Als u uw terminal controleert, ziet u ook de berichtId afgedrukt in de console. U kunt deze waarde opslaan in een database of logboek om een ​​bepaalde e-mail te identificeren.

U kunt ook overwegen om er een paar te controleren tips om te voorkomen dat e-mails in de spam van de ontvanger terechtkomen.

Hoewel dit e-mailsysteem correct werkt, is het niet de meest efficiënte aanpak om het eindpunt rechtstreeks de e-mailafzenderfunctie te laten aanroepen. Hierdoor kan uw toepassing onnodig wachten terwijl de e-mail wordt verzonden. Om dit te voorkomen, moet u het proces optimaliseren door het implementeren van een taakwachtrij om de e-mailworkload aan te kunnen.

Het verzenden van e-mails in Node.js is nog nooit zo eenvoudig geweest

Het is bevredigend om te beseffen dat je heel gemakkelijk een service kunt bouwen om e-mails in Node.js te verzenden.

Buiten het bestek van deze handleiding, kunt u nog veel meer doen met SendinBlue. U kunt verschillende e-mailversies tegelijk naar verschillende ontvangers sturen, gebruik e-mailsjablonen van SendinBlue, configureer webhooks om acties van uw e-mailontvangers te detecteren en bekijk ze in realtime analyses.

U kunt deze functies verkennen door ze uit te checken in de ontwikkelaarsportal en ze te implementeren in uw Node.js-applicaties.