E-mailek küldése a Node.js-ben a Sendinblue API használatával

A mai rohanó digitális világban az e-mail marketing elengedhetetlen eszköze a vállalkozásoknak ahhoz, hogy hatékonyan elérjék ügyfeleiket. Az e-mail rendszer megvalósítása azonban bonyolult és időigényes folyamat lehet, különösen azoknak a fejlesztőknek, akik még nem ismerik ezt a feladatot.

Szerencsére a Sendinblue segítségével az e-mailek küldése nagyon egyszerű feladat. Szoftver-szolgáltatásként (SaaS) platformként a Sendinblue mindent megad, amire cégtulajdonosként vagy fejlesztőként szüksége van ahhoz, hogy e-mailjeit nagyon könnyen eljuttassa a felhasználókhoz.

Mi az a Sendinblue?

A SendinBlue egy szoftver-szolgáltatás (SaaS) platform, amely könnyen használható e-mail marketing megoldást kínál kis-, közép- és nagyvállalatok számára. A SendinBlue olyan platformot biztosít, amely elsősorban e-mail- és SMS-szolgáltatásokon keresztül segíti a vállalatokat ügyfeleikkel való kapcsolatuk bővítésében.

A SendinBlue API-kat és eszközöket is kínál, amelyek lehetővé teszik a fejlesztők számára az e-mailek és SMS-ek automatizálását és küldését. Ezek az eszközök egyszerűen integrálhatók a Node.js-szel és más programozási nyelvekkel testreszabott e-mail- és SMS-kampányok létrehozásához.

A SendinBlue segítségével a vállalkozások egyszerűsíthetik a kommunikációs folyamatokat, és hatékonyabban érhetik el a felhasználókat vagy ügyfeleket.

A SendinBlue API hitelesítő adatok beszerzése

A SendinBlue API-k és SDK-k használatához az első előfeltétel egy SendinBlue-fiók. A SendinBlue egyszerű regisztrációs folyamatot biztosít, és fiókot hozhat létre a SendinBlue regisztrációs oldal.

Hozzon létre egy fiókot, adja meg a szükséges adatokat, és válasszon egy megfelelő tervet a csatlakozási folyamat során. A SendinBlue ezután átirányítja Önt az irányítópultra, ahol lekérheti API hitelesítő adatait.

Az API hitelesítő adatainak beszerzéséhez kövesse az alábbi lépéseket.

1. Kattintson a szervezet nevére az irányítópult jobb felső sarkában.
2. Válassza ki SMTP és API a legördülő menüből.
3. Váltson a API kulcsok fület, és kattintson aHozzon létre egy új API-kulcsot gomb.
4. A megjelenő felugró ablakban adjon nevet kulcsának, másolja ki a generált karakterláncot, majd tárolja biztonságosan.

Ez a karakterlánc az API-kulcs és az identitás hitelesítő adatai, amelyeket gondosan kell tárolnia, hogy ne kerüljön rossz kezekbe.

Hogyan építsünk fel e-mail küldő rendszert a Node.js-ben

A Node.js nem rendelkezik a beépített e-mail csomag, mint a Golang. E-mailek küldéséhez külső csomagra van szükség, mint pl nodemailer vagy a SendinBlue által kínált.

Szüksége lesz a Node.js és a Node.js fejlesztői környezet gyakorlati ismeretére is a gépén.

Tekintsük ezt az egyszerű Node/Express alkalmazást a /waitlist végpont:

// server.js
const expressz = igényelnek('Expressz');
// szerver létrehozása
const szerver = express();
const port = 3333;
server.listen (port, () => {
konzol.log(`szerver figyel a porton ${port}`);
})
// várólista végpont létrehozása
server.use('/várólista', async (req, res) => {
próbáld ki {
const user = req.body;
konzol.log(`${user.fullname} csatlakozott a várólistához);
 res.status(200).json({ üzenet: "Sikeresen csatlakozott a várólistához" })
 } fogás (hiba) {
konzol.error (hiba)
 res.status(500).json({ üzenet: 'Hiba lépett fel' })
 }
})

A SendinBlue segítségével üdvözlő e-mailt küldhet azoknak a felhasználóknak, akik csatlakoznak a várólistához.

Az első lépés az SDK telepítése a segítségével npm vagy bármilyen más csomagkezelő. Fuss npm telepítse a sib-api-v3-sdk-t vagy fonal add sib-api-v3-sdk a projekt mappájában, hogy hozzáadja a projekt függőségeihez.

A telepítés után készen áll az e-mailek küldésére, mindössze néhány sornyi kóddal. Nagyobb projekteknél valószínűleg külön fájlba szeretné elkülöníteni az e-mail funkciót. Ehhez a bemutatóhoz azonban továbbra is használhatja ugyanazt server.js fájlt.

Importálja a sib-api-v3-sdk csomagot, és állítsa be a SendinBlue klienst az alábbiak szerint:

const SibApi = igényelnek("sib-api-v3-sdk");
// új SendinBlue API kliens példányosítása
const SibClient = SibApi. ApiClient.instance;
// Hitelesítés
SibClient.authentications["api-kulcs"].apiKey = process.env. SIB_API_KEY
 || "YOUR_API_KEY_HERE";

Ezután állítson be néhány konfigurációt, és hozzon létre egy funkciót az üdvözlő e-mailek küldéséhez:

const tranzakcióEmailApi = új SibApiSDK.TransactionalEmailsApi();
hagyja smtpMailData = új SibApiSDK.SendSmtpEmail();
const feladó = {
 email: '[email protected]', // az email címed
 név: "Példa feladó",
};
const SendWaitlistEmail = async (felhasználói adatok) => {
}

A tranzakcióEmailApiváltozó tárol egy objektumot, amely lehetővé teszi tranzakciós e-mailek küldését (ahogyan a SendinBlue-n hívják). A smtpMailData változó tárolja a tranzakciós e-mail-adatokat, amelyeket minden e-mailben el kell küldenie: a címzett, a tartalom stb.

Most térjünk rá a testre SendWaitlistEmail funkció. A következő kód megmutatja, hogyan kell kinéznie a függvénytörzsnek.

const SendWaitlistEmail = async (felhasználói adatok) => {
próbáld ki {
 smtpMailData.sender = feladó;
 smtpMailData.to = [{
 email: userData.email,
 név: userData.fullname
 }];
 smtpMailData.subject = 'Várólistán vagy!';
 smtpMailData.params = {
'név': userData.fullname,
"Twitter": '@kihasználni'
 };
 smtpMailData.htmlContent = "
Kedves {{ params.name }}!

 + "Üdvözöljük a makeuseof.com várólistáján. Értesíteni fogjuk"
 + "amikor elindulunk. Kövess minket a Twitteren"
 + "{{ params.twitter }}.
";
// küldjön e-mailt
várja tranzakcióEmailApi.sendTransacEmail (smtpMailData)
 .akkor((adat) => { 
konzol.log (adatok) // naplózza az email azonosítót
 })
 .fogás((hiba) => {
konzol.error (hiba)
dobásújHiba(hiba) // hibák kezelése
 })
 } fogás (hiba) {
konzol.log('Hiba történt...')
konzol.error (hiba)
dobásújHiba(hiba) // hibák kezelése
 }
}

Ennek a kódnak a többsége a kulcs tulajdonságait tölti fel smtpMailData tárgy. Sorrendben ezek a következők:

• feladó: Két tulajdonságot tartalmazó objektum: email és név. A fenti kód ál e-mail címet használ, de az éles alkalmazásokhoz valódi, működő e-mail címet kell használnia.
• nak nek: Ez az e-mail címzettek tömbje. Ennek a tömbnek az elemei az e-mail címzettjének adataival (e-mail cím és név) meghatározott objektumok. Üzenetenként legfeljebb 50 címzett lehet. Technikailag lehetséges, hogy üzenetét egyszerre több mint 50-nek küldje el, de ezzel megnő annak a kockázata, hogy az e-mail-ügynökök spamként kezelik.
• tantárgy: Ez az elküldendő e-mail tárgya.
• paraméterek: Ezek további adatok, amelyeket e-mailje különböző részeiben (főleg a tárgyban és a tartalomban) használhat fel. Ebből értékeket használhat params dupla göndör kapcsos zárójelbe zárva (pl {{ params.name }}).
• htmlTartalom: Ez a tulajdonság határozza meg az üzenet törzsét. Segít meghatározni az e-mail üzenettörzsét, amelyet HTML használatával formázhat. Van alternatívája is, textContent, ami egyértelművé teszi az üzenet törzsét.

Az e-mailnek több tulajdonsága is lehet, és mindegyiket megtalálhatja A SendinBlue fejlesztői dokumentációja.

Végül a SendTransacEmail a metódusa tranzakcióEmailApi elküldi az e-mailt és visszaküldi az e-mail azonosítóját.

Miután végrehajtották a SendWaitlistEmail függvényt, meghívhatja a várólista végpontjában. A fenti várólista-végpont most így fog kinézni:

server.use('/várólista', async (req, res) => {
próbáld ki {
const user = req.body;
konzol.log(`${user.fullname} csatlakozott a várólistához);
// e-mail küldő funkció hívása 
várja SendWaitlistEmail (felhasználó)
 res.status(200).json({ üzenet: "Sikeresen csatlakozott a várólistához" })
 } fogás (hiba) {
konzol.error (hiba)
 res.status(500).json({ üzenet: "Belső szerverhiba történt" })
 }
})

Elindíthatja az alkalmazást, és tesztelheti a várólistás végpontját egy REST API-ügyfélben vagy az alkalmazás előterében. Íme egy példa tesztkérésre a Postmantól.

Így néz ki a kapott e-mail. Figyeljük meg, hogy az értékek a params objektumok vannak jelen.

Ha ellenőrzi a terminálját, látni fogja a üzenetazonosító a konzolba nyomtatva. Ezt az értéket adatbázisban vagy naplóban tárolhatja egy adott e-mail azonosításához.

Érdemes néhányat ellenőrizni is tippeket, hogy megakadályozza, hogy az e-mailek a címzettek spamjei közé kerüljenek.

Bár ez az e-mail rendszer megfelelően működik, nem a leghatékonyabb módszer, ha a végpont közvetlenül hívja az e-mail küldő funkciót. Előfordulhat, hogy az alkalmazás szükségtelenül vár, amíg elküldi az e-mailt. Ennek elkerülése érdekében optimalizálnia kell a folyamatot feladatsor megvalósítása az e-mail munkaterhelés kezelésére.

Soha nem volt ilyen egyszerű az e-mailek küldése a Node.js-ben

Örömteli felismerni, hogy nagyon egyszerűen létrehozhat egy szolgáltatást az e-mailek küldésére a Node.js-ben.

Az útmutató keretein túlmenően a SendinBlue segítségével még sok mást is megtehet. Különféle e-mail-verziókat küldhet egyszerre különböző címzetteknek, használhatja az általa biztosított e-mail sablonokat SendinBlue, konfigurálja a webhookot az e-mail címzettjei által végrehajtott műveletek észlelésére és valós idejű megtekintésére analitika.

Ezeket a szolgáltatásokat úgy fedezheti fel, ha megnézi őket a fejlesztői portálon, és implementálja őket a Node.js alkalmazásaiba.