Започнете да изпращате свой собствен имейл с този приятелски API и минималната настройка.

В днешния забързан дигитален свят имейл маркетингът е основен инструмент за бизнеса, за да достигне ефективно до своите клиенти. Внедряването на имейл система обаче може да бъде сложен и отнемащ време процес, особено за разработчици, които са нови в тази задача.

За щастие със Sendinblue изпращането на имейли е много лесна задача. Като платформа софтуер като услуга (SaaS), Sendinblue предоставя всичко, от което се нуждаете като собственик на бизнес или разработчик, за да предавате имейлите си много лесно на потребителите си.

Какво е Sendinblue?

SendinBlue е платформа софтуер като услуга (SaaS), която предлага лесно за използване решение за имейл маркетинг за малки, средни и големи предприятия. SendinBlue предоставя платформа, която помага на компаниите да развиват отношенията си с клиентите си, главно чрез имейл и SMS услуги.

SendinBlue също предлага API и инструменти, които позволяват на разработчиците да автоматизират и изпращат имейли и SMS. Тези инструменти са лесни за интегриране с Node.js и други програмни езици за създаване на персонализирани имейл и SMS кампании.

instagram viewer

Със SendinBlue фирмите могат да рационализират комуникационните процеси и да достигат до потребители или клиенти по-ефективно.

Как да получите идентификационни данни за API на SendinBlue

За да използвате SendinBlue API и SDK, първата предпоставка е акаунт в SendinBlue. SendinBlue предоставя лесен процес на регистрация и можете да създадете акаунт на Страница за регистрация в SendinBlue.

Създайте акаунт, въведете необходимите данни и изберете подходящ план в процеса на включване. След това SendinBlue ще ви пренасочи към вашето табло за управление, където ще можете да получите вашите идентификационни данни за API.

За да получите идентификационните си данни за API, следвайте стъпките по-долу.

  1. Кликнете върху името на вашата организация в горния десен ъгъл на таблото за управление.
  2. Изберете SMTP и API от падащото меню.
  3. Преминете към API ключове и щракнете върхуГенерирайте нов API ключ бутон.
  4. В изскачащия прозорец, който се появява, дайте име на вашия ключ, копирайте генерирания низ и след това го запазете безопасно.

Този низ е вашият API ключ и идентификационните ви данни, които трябва да съхранявате внимателно, за да не попадне в неподходящи ръце.

Как да изградите система за изпращане на имейл в Node.js

Node.js няма a вграден имейл пакет като Golang. За да изпращате имейли, имате нужда от външен пакет като nodemailer или тази, която SendinBlue предоставя.

Ще ви трябват и работни познания за Node.js и среда за разработка Node.js на вашата машина.

Помислете за това просто приложение Node/Express с a /waitlist крайна точка:

// server.js
конст експрес = изискват("експресен");
// създаване на сървър
конст сървър = експрес();
конст порт = 3333;


server.listen (порт, () => {
конзола.log(`сървър слуша на порт ${порт}`);
})


// създаване на крайна точка на списък с чакащи
server.use('/списък с чакащи', асинхронен (req, res) => {
опитвам {
конст потребител = req.body;
конзола.log(`${user.fullname} се присъедини към списъка с чакащи`);
 res.status(200).json({ съобщение: „Успешно присъединяване към списъка с чакащи“ })
 } улов (грешка) {
конзола.error (грешка)
 res.status(500).json({ съобщение: 'Възникна грешка' })
 }
})

Можете да използвате SendinBlue, за да изпратите имейл за добре дошли на потребител, който се присъедини към списъка с чакащи.

Първата стъпка е да инсталирате SDK с помощта на npm или всеки друг мениджър на пакети. Бягай npm инсталирайте sib-api-v3-sdk или добавете прежда sib-api-v3-sdk в папката на вашия проект, за да го добавите към зависимостите на проекта.

След инсталирането сте готови да започнете да изпращате имейли само с още няколко реда код. При по-голям проект вероятно бихте искали да изолирате функцията за имейл в отделен файл. За тази демонстрация обаче можете да продължите да използвате същото server.js файл.

Импортирайте sib-api-v3-sdk пакет и настройте клиента SendinBlue, както е показано по-долу:

конст SibApi = изискват('sib-api-v3-sdk');
// създаване на нов SendinBlue API клиент
конст SibClient = SibApi. ApiClient.instance;
// Удостоверяване
SibClient.authentications['api-ключ'].apiKey = process.env. SIB_API_KEY
 || „YOUR_API_KEY_HERE“;

След това настройте някаква конфигурация и създайте функция за изпращане на имейлите за добре дошли:

конст транзакцияEmailApi = нов SibApiSDK.TransactionalEmailsApi();
позволявам smtpMailData = нов SibApiSDK.SendSmtpEmail();


конст подател = {
 електронна поща: '[email protected]', // Вашата електронна поща
 име: „Примерен подател“,
};
конст SendWaitlistEmail = асинхронен (потребителски данни) => {
}

The транзакцияEmailApiпроменлива съхранява обект, който ви позволява да изпращате имейли за транзакции (както се наричат ​​в SendinBlue). The smtpMailData променлива ще съхранява имейл данните за транзакцията, от които ще се нуждаете, за да изпратите всеки имейл: получател, съдържание и т.н.

Сега към тялото на Изпращане на имейл в списъка за чакане функция. Следният код показва как трябва да изглежда тялото на функцията.

конст SendWaitlistEmail = асинхронен (потребителски данни) => {
опитвам {
 smtpMailData.sender = подател;
 smtpMailData.to = [{
 имейл: userData.email,
 име: потребителски данни.пълно име
 }];


 smtpMailData.subject = „Вие сте в списъка за чакане!“;


 smtpMailData.params = {
име: потребителски данни. пълно име,
"туитър": '@да се възползват от'
 };


 smtpMailData.htmlСъдържание = "
Здравейте {{ params.name }}, "

 + "добре дошли в списъка за изчакване на makeuseof.com. Ще ви уведомим"
 + "когато стартираме. Моля, следвайте ни в Twitter "
 + „{{ params.twitter }}.
";
// Изпратете имейл
изчакайте transactionEmailApi.sendTransacEmail (smtpMailData)
 .тогава((данни) => { 
конзола.log (данни) // регистрирайте имейл идентификатора
 })
 .catch((грешка) => {
конзола.error (грешка)
хвърлямновГрешка(грешка) // обработка на грешки
 })
 } улов (грешка) {
конзола.log('Възникна грешка...')
конзола.error (грешка)
хвърлямновГрешка(грешка) // обработка на грешки
 }
}

По-голямата част от този код попълва ключови свойства на smtpMailData обект. По ред това са:

  • подател: Обект, съдържащ две свойства: имейл и име. Кодът по-горе използва фиктивен имейл адрес, но трябва да използвате истински, работещ имейл адрес за производствени приложения.
  • да се: Това е масив от получатели на имейл. Елементите на този масив са обекти, дефинирани с данните (имейл и име) на получателя на имейла. Можете да имате до 50 получатели на съобщение. Технически е възможно да изпратите съобщението си до повече от 50 наведнъж, но това увеличава риска имейл агентите да го третират като спам.
  • предмет: Това е темата на имейла за изпращане.
  • параметри: Това са допълнителни данни, които можете да използвате в различни части на вашия имейл (главно тема и съдържание). Можете да използвате стойности от това параметри обект, като ги поставите в двойни фигурни скоби (т.е {{ params.name }}).
  • html съдържание: Това свойство определя тялото на съобщението. Помага да се определи тялото на съобщението на имейла, което можете да форматирате с помощта на HTML. Има и алтернатива, textContent, което поддържа основния текст на съобщението обикновен.

Имейлът може да има повече свойства и можете да ги откриете всички в Документация за разработчици на SendinBlue.

И накрая, на sendTransacEmail метод на транзакцияEmailApi изпраща имейла и връща идентификатора на имейла.

След прилагане на Изпращане на имейл в списъка за чакане функция, можете да я извикате в крайната точка на списъка с чакащи. Крайната точка на списъка с чакащи по-горе сега ще изглежда така:

server.use('/списък с чакащи', асинхронен (req, res) => {
опитвам {
конст потребител = req.body;
конзола.log(`${user.fullname} се присъедини към списъка с чакащи`);
// извикване на функцията за подател на имейл 
изчакайте SendWaitlist Email (потребител)
 res.status(200).json({ съобщение: „Успешно присъединяване към списъка с чакащи“ })
 } улов (грешка) {
конзола.error (грешка)
 res.status(500).json({ съобщение: „Възникна вътрешна грешка в сървъра“ })
 }
})

Можете да стартирате приложението си и да тествате крайната си точка в списъка с чакащи в REST API клиент или от интерфейса на вашето приложение. Ето примерна заявка за тест от Postman.

Ето как изглежда получения имейл. Забележете, че стойностите от параметри обект са налице.

Ако проверите терминала си, ще видите също messageId отпечатани в конзолата. Можете да съхраните тази стойност в база данни или регистрационен файл, за да идентифицирате конкретен имейл.

Може също да помислите да проверите някои съвети за предотвратяване на изпращането на имейли в спам на получателите.

Въпреки че тази имейл система работи правилно, крайната точка директно да извиква функцията за подател на имейл не е най-ефективният подход. Това може да накара приложението ви да чака ненужно, докато изпрати имейла. За да избегнете това, трябва да оптимизирате процеса чрез внедряване на опашка от задачи за справяне с натоварването по имейл.

Изпращането на имейли в Node.js никога не е било по-лесно

Удоволствие е да разберете, че можете да създадете услуга за изпращане на имейли в Node.js много лесно.

Извън обхвата на това ръководство има много повече, които можете да правите със SendinBlue. Можете да изпращате различни имейл версии до различни получатели наведнъж, като използвате имейл шаблони, предоставени от SendinBlue, конфигурирайте уеб кукички за откриване на действия, предприети от получателите на вашия имейл, и преглеждайте в реално време анализи.

Можете да изследвате тези функции, като ги проверите в портала за разработчици и ги внедрите във вашите Node.js приложения.