Začnite posielať svoj vlastný e-mail s týmto priateľským rozhraním API a minimálnym nastavením.

V dnešnom rýchlom digitálnom svete je e-mailový marketing základným nástrojom pre firmy, ako efektívne osloviť svojich zákazníkov. Implementácia e-mailového systému však môže byť zložitý a časovo náročný proces, najmä pre vývojárov, ktorí sú v tejto úlohe noví.

Našťastie so Sendinblue je odosielanie e-mailov veľmi jednoduchá úloha. Sendinblue ako platforma softvéru ako služby (SaaS) poskytuje všetko, čo ako vlastník firmy alebo vývojár potrebujete na to, aby ste svoje e-maily mohli veľmi jednoducho dostať k svojim používateľom.

Čo je Sendinblue?

SendinBlue je platforma softvéru ako služba (SaaS), ktorá ponúka ľahko použiteľné riešenie e-mailového marketingu pre malé, stredné a veľké podniky. SendinBlue poskytuje platformu, ktorá pomáha spoločnostiam rozvíjať vzťahy so zákazníkmi, najmä prostredníctvom e-mailových a SMS služieb.

SendinBlue tiež ponúka API a nástroje, ktoré umožňujú vývojárom automatizovať a odosielať e-maily a SMS. Tieto nástroje sa dajú jednoducho integrovať s Node.js a ďalšími programovacími jazykmi na vytváranie prispôsobených e-mailových a SMS kampaní.

instagram viewer

Pomocou SendinBlue môžu podniky zefektívniť komunikačné procesy a efektívnejšie osloviť používateľov alebo zákazníkov.

Ako získať poverenia SendinBlue API

Ak chcete používať SendinBlue API a SDK, prvým predpokladom je účet SendinBlue. SendinBlue poskytuje jednoduchý proces registrácie a môžete si vytvoriť účet na Prihlasovacia stránka SendinBlue.

Vytvorte si účet, zadajte požadované údaje a vyberte si vhodný plán v procese registrácie. SendinBlue vás potom presmeruje na váš informačný panel, kde budete môcť získať svoje poverenia API.

Ak chcete získať svoje poverenia API, postupujte podľa krokov nižšie.

  1. Kliknite na názov svojej organizácie v pravom hornom rohu hlavného panela.
  2. Vyberte SMTP a API z rozbaľovacej ponuky.
  3. Prepnúť na API kľúče a kliknite naVygenerujte nový kľúč API tlačidlo.
  4. V zobrazenom kontextovom okne zadajte názov kľúča, skopírujte vygenerovaný reťazec a potom ho bezpečne uložte.

Tento reťazec je váš kľúč API a vaše identifikačné údaje, ktoré by ste si mali starostlivo uložiť, aby sa nedostali do nesprávnych rúk.

Ako vytvoriť systém na odosielanie e-mailov v Node.js

Node.js nemá a vstavaný e-mailový balík ako Golang. Na odosielanie e-mailov potrebujete externý balík, napr nodemailer alebo ten, ktorý poskytuje SendinBlue.

Budete tiež potrebovať pracovné znalosti Node.js a vývojového prostredia Node.js na vašom počítači.

Zvážte túto jednoduchú aplikáciu Node/Express s a /waitlist koncový bod:

// server.js
konšt vyjadriť = vyžadovať('expresné');
//vytvor server
konšt server = express();
konšt prístav = 3333;


server.listen (port, () => {
konzoly.log(`server počúva na porte ${port}`);
})


// vytvorenie koncového bodu poradovníka
server.use('/waitlist', async (req, res) => {
skúste {
konšt užívateľ = req.body;
konzoly.log(`${user.fullname} zaradil do poradovníka“.);
 res.status(200.json({ správu: „Úspešne sa pripojili k zoznamu čakateľov“ })
 } chytiť (chyba) {
konzoly.chyba (chyba)
 res.status(500.json({ správu: 'Nastala chyba' })
 }
})

SendinBlue môžete použiť na odoslanie uvítacieho e-mailu používateľovi, ktorý sa pripojí do zoznamu čakateľov.

Prvým krokom je inštalácia SDK pomocou npm alebo iného správcu balíkov. Bežať npm nainštalujte sib-api-v3-sdk alebo priadza pridať sib-api-v3-sdk v priečinku projektu a pridajte ho do závislostí projektu.

Po inštalácii ste pripravení začať odosielať e-maily s niekoľkými ďalšími riadkami kódu. Na väčšom projekte by ste pravdepodobne chceli izolovať e-mailové funkcie v samostatnom súbore. Pre túto ukážku však môžete pokračovať v používaní toho istého server.js súbor.

Importovať sib-api-v3-sdk balík a nastavte klienta SendinBlue, ako je uvedené nižšie:

konšt SibApi = vyžadovať('sib-api-v3-sdk');
// vytvorenie inštancie nového klienta SendinBlue API
konšt SibClient = SibApi. ApiClient.instance;
// Overenie
SibClient.authentications['api-key'].apiKey = process.env. SIB_API_KEY
 || 'YOUR_API_KEY_HERE';

Ďalej nastavte konfiguráciu a vytvorte funkciu na odosielanie uvítacích e-mailov:

konšt transakciaEmailApi = Nový SibApiSDK.TransactionalEmailsApi();
nech smtpMailData = Nový SibApiSDK.SendSmtpEmail();


konšt odosielateľ = {
 email: '[email protected]', // Vaša emailová adresa
 názov: „Príklad odosielateľa“,
};
konšt SendWaitlistEmail = async (userData) => {
}

The transakciaEmailApipremenná ukladá objekt, ktorý vám umožňuje odosielať transakčné e-maily (ako sa nazývajú na SendinBlue). The smtpMailData premenná bude uchovávať transakčné e-mailové údaje, ktoré budete potrebovať na odoslanie každého e-mailu: príjemca, obsah atď.

Teraz k telu SendWaitlistEmail funkciu. Nasledujúci kód ukazuje, ako by malo vyzerať telo funkcie.

konšt SendWaitlistEmail = async (userData) => {
skúste {
 smtpMailData.sender = odosielateľ;
 smtpMailData.to = [{
 email: userData.email,
 meno: userData.fullname
 }];


 smtpMailData.subject = "Ste na zozname čakateľov!";


 smtpMailData.params = {
'názov': userData.fullname,
'twitter': '@použiť'
 };


 smtpMailData.htmlObsah = "
Dobrý deň, {{ params.name }}, "

 + "Vitajte v poradovníku makeuseof.com." Budeme vás informovať"
 + "keď spustíme. Sledujte nás na Twitteri “
 + "{{ params.twitter }}."
";
// poslať email
čakať transakciaEmailApi.sendTransacEmail (smtpMailData)
 .potom((údajov) => { 
konzoly.log (údaje) // zapíšte ID e-mailu
 })
 .catch((chyba) => {
konzoly.chyba (chyba)
hodiťNovýChyba(chyba) // spracovanie chýb
 })
 } chytiť (chyba) {
konzoly.log('Vyskytla sa chyba...')
konzoly.chyba (chyba)
hodiťNovýChyba(chyba) // spracovanie chýb
 }
}

Väčšina tohto kódu vypĺňa kľúčové vlastnosti smtpMailData objekt. V poradí sú to tieto:

  • odosielateľ: Objekt obsahujúci dve vlastnosti: email a meno. Vyššie uvedený kód používa fiktívnu e-mailovú adresu, ale pre produkčné aplikácie by ste mali použiť skutočnú funkčnú e-mailovú adresu.
  • komu: Toto je pole príjemcov e-mailov. Prvky tohto poľa sú objekty definované s údajmi (e-mail a meno) príjemcu e-mailu. V jednej správe môžete mať až 50 príjemcov. Technicky je možné poslať správu viac ako 50 naraz, ale zvyšuje sa riziko, že e-mailoví agenti ju budú považovať za spam.
  • predmet: Toto je predmet e-mailu na odoslanie.
  • parametre: Ide o dodatočné údaje, ktoré môžete použiť v rôznych častiach svojho e-mailu (hlavne predmet a obsah). Z toho môžete použiť hodnoty parametre objekt ich uzavretím do dvojitých zložených zátvoriek (t.j {{ params.name }}).
  • htmlObsah: Táto vlastnosť definuje telo správy. Pomáha definovať telo správy e-mailu, ktoré môžete naformátovať pomocou HTML. Má aj alternatívu, textObsah, čím je telo správy jednoduché.

E-mail môže mať viac vlastností a všetky ich môžete objaviť v Dokumentácia pre vývojárov SendinBlue.

Nakoniec, sendTransacEmail spôsob transakciaEmailApi odošle e-mail a vráti ID e-mailu.

Po implementácii SendWaitlistEmail môžete ju zavolať v koncovom bode zoznamu čakateľov. Koncový bod zoznamu čakateľov vyššie bude teraz vyzerať takto:

server.use('/waitlist', async (req, res) => {
skúste {
konšt užívateľ = req.body;
konzoly.log(`${user.fullname} zaradil do poradovníka“.);
// zavolajte funkciu odosielateľa e-mailu 
čakať SendWaitlistEmail (používateľ)
 res.status(200.json({ správu: „Úspešne sa pripojili k zoznamu čakateľov“ })
 } chytiť (chyba) {
konzoly.chyba (chyba)
 res.status(500.json({ správu: "Vyskytla sa interná chyba servera" })
 }
})

Svoju aplikáciu môžete spustiť a otestovať koncový bod zoznamu čakateľov v klientovi REST API alebo z frontendu vašej aplikácie. Tu je príklad žiadosti o test od Postmana.

Takto vyzerá prijatý e-mail. Všimnite si, že hodnoty z parametre objekt sú prítomné.

Ak skontrolujete svoj terminál, uvidíte aj messageId vytlačené v konzole. Túto hodnotu môžete uložiť do databázy alebo denníka na identifikáciu konkrétneho e-mailu.

Môžete tiež zvážiť kontrolu niektorých tipy, ako zabrániť tomu, aby sa e-maily dostávali do spamu príjemcov.

Hoci tento e-mailový systém funguje správne, mať koncový bod priamo volať funkciu odosielateľa e-mailu nie je najefektívnejší prístup. Mohlo by to spôsobiť, že vaša aplikácia bude pri odosielaní e-mailu zbytočne čakať. Aby ste tomu zabránili, mali by ste proces optimalizovať o implementácia frontu úloh zvládnuť e-mailovú záťaž.

Odosielanie e-mailov v Node.js nebolo nikdy jednoduchšie

Je uspokojujúce uvedomiť si, že službu na odosielanie e-mailov v Node.js môžete vytvoriť veľmi jednoducho.

Okrem rozsahu tejto príručky môžete so SendinBlue robiť oveľa viac. Môžete poslať rôzne verzie e-mailu rôznym príjemcom naraz, použite šablóny e-mailov, ktoré poskytuje SendinBlue, nakonfigurujte webhooky tak, aby zisťovali akcie, ktoré vykonali príjemcovia vašich e-mailov, a prezerajte si ich v reálnom čase analýzy.

Tieto funkcie môžete preskúmať tak, že si ich pozriete na portáli pre vývojárov a implementujete ich do svojich aplikácií Node.js.