Како слати е-поруке у Ноде.јс користећи Сендинблуе АПИ

У данашњем брзом дигиталном свету, е-маил маркетинг је суштински алат за предузећа да ефикасно дођу до својих клијената. Међутим, имплементација система е-поште може бити сложен и дуготрајан процес, посебно за програмере који су нови у задатку.

На срећу, са Сендинблуе, слање е-поште је веома лак задатак. Као платформа софтвер-као-услуга (СааС), Сендинблуе пружа све што вам је потребно као власнику предузећа или програмеру да бисте своје е-поруке веома лако пренели корисницима.

Шта је Сендинблуе?

СендинБлуе је платформа софтвер-као-услуга (СааС) која нуди решење за маркетинг путем е-поште који се лако користи за мала, средња и велика предузећа. СендинБлуе пружа платформу која помаже компанијама да унапреде своје односе са својим клијентима, углавном путем е-поште и СМС услуга.

СендинБлуе такође нуди АПИ-је и алате који омогућавају програмерима да аутоматизују и шаљу е-пошту и СМС. Ови алати су једноставни за интеграцију са Ноде.јс и другим програмским језицима за креирање прилагођених емаил и СМС кампања.

Са СендинБлуе-ом, предузећа могу да поједноставе процесе комуникације и ефикасније допру до корисника или купаца.

Како добити СендинБлуе АПИ акредитиве

Да бисте користили СендинБлуе АПИ-је и СДК-ове, први предуслов је СендинБлуе налог. СендинБлуе пружа једноставан процес регистрације, а можете креирати налог на Страница за пријаву на СендинБлуе.

Креирајте налог, унесите потребне детаље и изаберите одговарајући план у процесу укључивања. СендинБлуе ће вас затим преусмерити на вашу контролну таблу где ћете моћи да добијете своје АПИ акредитиве.

Да бисте добили своје АПИ акредитиве, пратите кораке у наставку.

1. Кликните на назив ваше организације у горњем десном углу контролне табле.
2. Изаберите СМТП & АПИ из менија који се пада.
3. Пребаците се на АПИ кључеви картицу и кликните наГенеришите нови АПИ кључ дугме.
4. У искачућем прозору који се појави дајте свом кључу име, копирајте генерисани стринг, а затим га безбедно сачувајте.

Овај низ је ваш АПИ кључ и ваш идентитет који треба пажљиво да чувате како не би доспео у погрешне руке.

Како направити систем за слање е-поште у Ноде.јс

Ноде.јс нема а уграђени пакет е-поште као што је Голанг. Да бисте слали е-пошту, потребан вам је екстерни пакет као што је нодемаилер или онај који СендинБлуе пружа.

Такође ће вам требати радно знање о Ноде.јс и развојном окружењу Ноде.јс на вашој машини.

Размотрите ову једноставну апликацију Ноде/Екпресс са а /waitlist крајња тачка:

// сервер.јс
конст екпресс = захтевају('изразити');
// креирање сервера
конст сервер = екпресс();
конст порт = 3333;
сервер.листен (порт, () => {
конзола.Пријава(`сервер слуша на порту ${порт}`);
})
// креирање крајње тачке листе чекања
сервер.усе('/ваитлист', асинц (рек, рес) => {
покушати {
конст корисник = рек.боди;
конзола.Пријава(`${усер.фуллнаме} придружио се листи чекања`);
 рес.статус(200).јсон({ порука: 'Успешно се придружио листи чекања' })
 } улов (грешка) {
конзола.еррор (грешка)
 рес.статус(500).јсон({ порука: 'Дошло је до грешке' })
 }
})

Можете користити СендинБлуе да пошаљете поруку добродошлице кориснику који се придружи листи чекања.

Први корак је да инсталирате СДК користећи нпм или било који други менаџер пакета. Трцати нпм инсталл сиб-апи-в3-сдк или предиво додати сиб-апи-в3-сдк у фасцикли вашег пројекта да бисте је додали у зависности од пројекта.

Након инсталације, спремни сте да почнете да шаљете е-пошту са само још неколико линија кода. На већем пројекту, вероватно бисте желели да изолујете функционалност е-поште у посебну датотеку. Међутим, за ову демонстрацију можете наставити да користите исту сервер.јс фајл.

Увезите сиб-апи-в3-сдк пакет, и подесите СендинБлуе клијент као што је доле:

конст СибАпи = захтевају('сиб-апи-в3-сдк');
// инстанцира нови СендинБлуе АПИ клијент
конст СибЦлиент = СибАпи. АпиЦлиент.инстанце;
// Аутентикација
СибЦлиент.аутхентицатионс['апи-кључ'].апиКеи = процесс.енв. СИБ_АПИ_КЕИ
 || 'ИОУР_АПИ_КЕИ_ХЕРЕ';

Затим подесите неку конфигурацију и креирајте функцију за слање е-порука добродошлице:

конст трансакцијаЕмаилАпи = Нова СибАпиСДК.ТрансацтионалЕмаилсАпи();
дозволити смтпМаилДата = Нова СибАпиСДК.СендСмтпЕмаил();
конст пошиљалац = {
 емаил: 'сендинблуемаил@екампле.цом', // Ваша емаил адреса
 име: „Пример пошиљаоца“,
};
конст СендВаитлистЕмаил = асинц (кориснички подаци) => {
}

Тхе трансакцијаЕмаилАпипроменљива чува објекат који вам омогућава да шаљете е-поруке о трансакцијама (како се зову на СендинБлуе). Тхе смтпМаилДата променљива ће чувати податке е-поште о трансакцији које ћете морати да пошаљете сваку е-пошту: прималац, садржај итд.

Сада пређимо на тело СендВаитлистЕмаил функција. Следећи код показује како тело функције треба да изгледа.

конст СендВаитлистЕмаил = асинц (кориснички подаци) => {
покушати {
 смтпМаилДата.сендер = пошиљалац;
 смтпМаилДата.то = [{
 емаил: усерДата.емаил,
 име: усерДата.фуллнаме
 }];
 смтпМаилДата.субјецт = 'Ви сте на листи чекања!';
 смтпМаилДата.парамс = {
'име': усерДата.фуллнаме,
'твиттер': '@искористи'
 };
 смтпМаилДата.хтмлЦонтент = "
Здраво {{ парамс.наме }}, "

 + „добродошли на макеусеоф.цом листу чекања. Обавестићемо вас "
 + „када покренемо. Молимо вас да нас пратите на Твитеру "
 + „{{ парамс.твиттер }}.
";
// шаљи имејл
чекати трансакцијаЕмаилАпи.сендТрансацЕмаил (смтпМаилДата)
 .онда((података) => { 
конзола.лог (подаци) // евидентирамо ИД е-поште
 })
 .улов((грешка) => {
конзола.еррор (грешка)
бацитиНоваГрешка(грешка) // обради грешке
 })
 } улов (грешка) {
конзола.Пријава('Грешке...')
конзола.еррор (грешка)
бацитиНоваГрешка(грешка) // обради грешке
 }
}

Већина овог кода попуњава кључна својства смтпМаилДата објекат. Редом, ово су:

• пошиљалац: Објекат који садржи два својства: емаил и име. Код изнад користи лажну адресу е-поште, али би требало да користите праву, радну адресу е-поште за производне апликације.
• до: Ово је низ прималаца е-поште. Елементи овог низа су објекти дефинисани подацима (е-маил и име) примаоца е-поште. Можете имати до 50 прималаца по поруци. Технички, могуће је послати своју поруку на више од 50 одједном, али то повећава ризик да је агенти е-поште третирају као нежељену пошту.
• предмет: Ово је предмет е-поште за слање.
• параметри: Ово су додатни подаци које можете користити у различитим деловима ваше е-поште (углавном предмет и садржај). Можете користити вредности из овога парамс објект тако што их ставите у двоструке витичасте заграде (тј {{ парамс.наме }}).
• хтмлСадржај: Ово својство дефинише тело поруке. Помаже да се дефинише тело поруке е-поште, које можете да форматирате помоћу ХТМЛ-а. Такође има алтернативу, тектЦонтент, што тело поруке држи једноставним.

Е-пошта може имати више својстава и све их можете открити Документација за програмере СендинБлуе.

Коначно, сендТрансацЕмаил метод трансакцијаЕмаилАпи шаље е-пошту и враћа ИД е-поште.

Након имплементације СендВаитлистЕмаил функцију, можете је позвати у крајњој тачки листе чекања. Крајња тачка листе чекања изнад ће сада изгледати овако:

сервер.усе('/ваитлист', асинц (рек, рес) => {
покушати {
конст корисник = рек.боди;
конзола.Пријава(`${усер.фуллнаме} придружио се листи чекања`);
// позива функцију пошиљаоца е-поште 
чекати СендВаитлистЕмаил (корисник)
 рес.статус(200).јсон({ порука: 'Успешно се придружио листи чекања' })
 } улов (грешка) {
конзола.еррор (грешка)
 рес.статус(500).јсон({ порука: „Дошло је до интерне грешке сервера“ })
 }
})

Можете покренути своју апликацију и тестирати крајњу тачку листе чекања у РЕСТ АПИ клијенту или са фронтенда ваше апликације. Ево примера захтева за тестирање од Поштара.

Ево како изгледа примљени мејл. Приметите да вредности из парамс објекат је присутан.

Ако проверите свој терминал, видећете и мессагеИд одштампан у конзоли. Ову вредност можете да сачувате у бази података или евиденцији да бисте идентификовали одређену е-пошту.

Такође можете размислити да проверите неке савете да спречите да е-поруке оду у нежељену пошту примаоца.

Иако овај систем е-поште функционише исправно, крајња тачка директно позива функцију пошиљаоца е-поште није најефикаснији приступ. То може довести до тога да ваша апликација непотребно чека док шаље е-пошту. Да бисте то избегли, требало би да оптимизујете процес имплементација реда задатака да се носи са оптерећењем е-поште.

Слање е-порука у Ноде.јс никада није било лакше

Задовољство је схватити да можете врло лако да направите услугу за слање е-поште у Ноде.јс.

Изван обима овог водича, постоји још много тога што можете да урадите са СендинБлуе. Можете послати различите верзије е-поште различитим примаоцима одједном, користећи шаблоне е-поште које обезбеђује СендинБлуе, конфигуришите веб-хукове за откривање радњи које предузимају ваши примаоци е-поште и прегледајте у реалном времену аналитике.

Можете истражити ове функције тако што ћете их проверити на порталу за програмере и имплементирати их у своје Ноде.јс апликације.