Jak odesílat e-maily v Node.js pomocí Sendinblue API

V dnešním uspěchaném digitálním světě je e-mailový marketing nezbytným nástrojem pro podniky, jak efektivně oslovit své zákazníky. Implementace e-mailového systému však může být složitý a časově náročný proces, zejména pro vývojáře, kteří s tímto úkolem teprve začínají.

Naštěstí se Sendinblue je odesílání e-mailů velmi snadný úkol. Jako platforma software-as-a-service (SaaS) poskytuje Sendinblue vše, co jako vlastník firmy nebo vývojář potřebujete k tomu, abyste své e-maily velmi snadno dostali k vašim uživatelům.

Co je Sendinblue?

SendinBlue je platforma software-as-a-service (SaaS), která nabízí snadno použitelné řešení e-mailového marketingu pro malé, střední a velké podniky. SendinBlue poskytuje platformu, která pomáhá společnostem rozvíjet vztahy se svými zákazníky, zejména prostřednictvím e-mailových a SMS služeb.

SendinBlue také nabízí API a nástroje, které umožňují vývojářům automatizovat a odesílat e-maily a SMS. Tyto nástroje lze snadno integrovat s Node.js a dalšími programovacími jazyky pro vytváření přizpůsobených e-mailových a SMS kampaní.

Pomocí SendinBlue mohou podniky zefektivnit komunikační procesy a efektivněji oslovit uživatele nebo zákazníky.

Jak získat přihlašovací údaje SendinBlue API

Chcete-li používat SendinBlue API a SDK, prvním předpokladem je účet SendinBlue. SendinBlue poskytuje snadný proces registrace a můžete si vytvořit účet na Přihlašovací stránka SendinBlue.

Vytvořte si účet, zadejte požadované údaje a v procesu registrace vyberte vhodný plán. SendinBlue vás poté přesměruje na váš řídicí panel, kde budete moci získat své přihlašovací údaje k API.

Chcete-li získat přihlašovací údaje k rozhraní API, postupujte podle následujících kroků.

1. Klikněte na název vaší organizace v pravém horním rohu řídicího panelu.
2. Vybrat SMTP a API z nabídky, která se otevře.
3. Přepněte na Klíče API a klikněte naVygenerujte nový klíč API knoflík.
4. Ve vyskakovacím okně, které se objeví, zadejte název klíče, zkopírujte vygenerovaný řetězec a poté jej bezpečně uložte.

Tento řetězec je váš klíč API a vaše identifikační údaje, které byste měli pečlivě uchovávat, aby se nedostaly do nesprávných rukou.

Jak vytvořit systém pro odesílání e-mailů v Node.js

Node.js nemá a vestavěný e-mailový balíček jako Golang. K odesílání e-mailů potřebujete externí balíček jako např nodemailer nebo ten, který poskytuje SendinBlue.

Budete také potřebovat pracovní znalost Node.js a vývojového prostředí Node.js na vašem počítači.

Zvažte tuto jednoduchou aplikaci Node/Express s a /waitlist koncový bod:

// server.js
konst vyjádřit = vyžadovat('vyjádřit');
// vytvořit server
konst server = express();
konst přístav = 3333;
server.listen (port, () => {
řídicí panel.log(`server naslouchající na portu ${port}`);
})
// vytvoření koncového bodu čekací listiny
server.use('/waitlist', asynchronní (req, res) => {
Snaž se {
konst uživatel = req.body;
řídicí panel.log(`${user.fullname} zařadil do pořadníku');
 res.status(200.json({ zpráva: 'Úspěšně se připojili k čekací listině' })
 } chytit (chyba) {
řídicí panel.chyba (chyba)
 res.status(500.json({ zpráva: 'Vyskytla se chyba' })
 }
})

SendinBlue můžete použít k odeslání uvítacího e-mailu uživateli, který se připojí na seznam čekatelů.

Prvním krokem je instalace SDK pomocí npm nebo jakýkoli jiný správce balíčků. Běh npm nainstalovat sib-api-v3-sdk nebo příze přidat sib-api-v3-sdk ve složce projektu a přidejte jej do závislostí projektu.

Po instalaci jste připraveni začít odesílat e-maily s několika dalšími řádky kódu. U většího projektu budete pravděpodobně chtít izolovat funkce e-mailu v samostatném souboru. Pro tuto ukázku však můžete pokračovat v používání stejného server.js soubor.

Importujte sib-api-v3-sdk balíček a nastavte klienta SendinBlue, jak je uvedeno níže:

konst SibApi = vyžadovat('sib-api-v3-sdk');
// vytvoření instance nového klienta SendinBlue API
konst SibClient = SibApi. ApiClient.instance;
// Autentizace
SibClient.authentications['api-key'].apiKey = process.env. SIB_API_KEY
 || 'YOUR_API_KEY_HERE';

Dále nastavte nějakou konfiguraci a vytvořte funkci pro odesílání uvítacích e-mailů:

konst transakceEmailApi = Nový SibApiSDK.TransactionalEmailsApi();
nechat smtpMailData = Nový SibApiSDK.SendSmtpEmail();
konst odesílatel = {
 e-mailem: '[email protected]', // Vaše emailová adresa
 název: 'Příklad odesílatele',
};
konst SendWaitlistEmail = asynchronní (userData) => {
}

The transakceEmailApiproměnná ukládá objekt, který vám umožňuje odesílat transakční e-maily (jak se jim říká na SendinBlue). The smtpMailData proměnná bude ukládat transakční e-mailové údaje, které budete potřebovat k odeslání každého e-mailu: příjemce, obsah atd.

Nyní k tělu OdeslatWaitlistEmail funkce. Následující kód ukazuje, jak by mělo vypadat tělo funkce.

konst SendWaitlistEmail = asynchronní (userData) => {
Snaž se {
 smtpMailData.sender = odesílatel;
 smtpMailData.to = [{
 email: userData.email,
 jméno: userData.fullname
 }];
 smtpMailData.subject = "Jste na pořadníku!";
 smtpMailData.params = {
'název': userData.fullname,
'cvrlikání': '@makeuseof'
 };
 smtpMailData.htmlObsah = "
Dobrý den, {{ params.name }}, "

 + "vítejte v pořadníku makeuseof.com." Budeme vás informovat"
 + "když spustíme. Sledujte nás na Twitteru "
 + "{{ params.twitter }}."
";
// poslat e-mailem
čekat transakceEmailApi.sendTransacEmail (smtpMailData)
 .pak((data) => { 
řídicí panel.log (data) // zapište ID e-mailu
 })
 .chytit((chyba) => {
řídicí panel.chyba (chyba)
házetNovýChyba(chyba) // zpracování chyb
 })
 } chytit (chyba) {
řídicí panel.log('Nastala chyba...')
řídicí panel.chyba (chyba)
házetNovýChyba(chyba) // zpracování chyb
 }
}

Většina tohoto kódu naplňuje klíčové vlastnosti smtpMailData objekt. V pořadí to jsou:

• odesílatel: Objekt obsahující dvě vlastnosti: email a jméno. Výše uvedený kód používá fiktivní e-mailovou adresu, ale pro produkční aplikace byste měli používat skutečnou funkční e-mailovou adresu.
• na: Toto je pole příjemců e-mailů. Prvky tohoto pole jsou objekty definované s daty (e-mail a jméno) příjemce e-mailu. V jedné zprávě můžete mít až 50 příjemců. Technicky je možné poslat vaši zprávu více než 50 najednou, ale zvyšuje se riziko, že e-mailoví agenti ji budou považovat za spam.
• předmět: Toto je předmět e-mailu k odeslání.
• parametry: Jedná se o doplňková data, která můžete použít v různých částech svého e-mailu (hlavně v předmětu a obsahu). Z toho můžete použít hodnoty parametry objektu jejich uzavřením do dvojitých složených závorek (tj {{ params.name }}).
• htmlObsah: Tato vlastnost definuje tělo zprávy. Pomáhá definovat tělo zprávy e-mailu, které můžete formátovat pomocí HTML. Má také alternativu, textObsah, který udržuje tělo zprávy čisté.

E-mail může mít více vlastností a všechny je můžete objevit v Vývojářská dokumentace SendinBlue.

Konečně, odeslatTransacEmail metoda transakceEmailApi odešle e-mail a vrátí ID e-mailu.

Po implementaci OdeslatWaitlistEmail funkci, můžete ji volat v koncovém bodu čekací listiny. Výše uvedený koncový bod pořadníku bude nyní vypadat takto:

server.use('/waitlist', asynchronní (req, res) => {
Snaž se {
konst uživatel = req.body;
řídicí panel.log(`${user.fullname} zařadil do pořadníku');
// volání funkce odesílatele e-mailu 
čekat SendWaitlistEmail (uživatel)
 res.status(200.json({ zpráva: 'Úspěšně se připojili k čekací listině' })
 } chytit (chyba) {
řídicí panel.chyba (chyba)
 res.status(500.json({ zpráva: "Došlo k interní chybě serveru" })
 }
})

Aplikaci můžete spustit a otestovat koncový bod čekací listiny v klientovi REST API nebo z frontendu vaší aplikace. Zde je příklad testovací žádosti od Postmana.

Takto vypadá přijatý e-mail. Všimněte si, že hodnoty z parametry objekt jsou přítomny.

Pokud zkontrolujete svůj terminál, uvidíte také messageId vytištěné v konzole. Tuto hodnotu můžete uložit do databáze nebo protokolu pro identifikaci konkrétního e-mailu.

Můžete také zvážit kontrolu některých tipy, jak zabránit tomu, aby e-maily chodily do spamu příjemců.

Ačkoli tento e-mailový systém funguje správně, mít koncový bod přímo volat funkci odesílatele e-mailu není nejefektivnější přístup. Mohlo by to způsobit, že vaše aplikace bude při odesílání e-mailu zbytečně čekat. Abyste tomu zabránili, měli byste proces optimalizovat pomocí implementace fronty úkolů zvládnout e-mailovou zátěž.

Odesílání e-mailů v Node.js nebylo nikdy jednodušší

Je uspokojující si uvědomit, že službu pro odesílání e-mailů v Node.js můžete vytvořit velmi snadno.

Nad rámec této příručky toho můžete se SendinBlue dělat mnohem víc. Můžete odeslat různé verze e-mailu různým příjemcům najednou, použijte e-mailové šablony poskytované společností SendinBlue, nakonfigurujte webhooky tak, aby zjišťovaly akce provedené vašimi příjemci e-mailů a prohlížejte je v reálném čase analytiky.

Tyto funkce můžete prozkoumat tak, že si je prohlédnete na portálu pro vývojáře a implementujete je do svých aplikací Node.js.