smtp-locaweb-nodejs
v1.0.1
Published
NPM library to make usage of Locaweb transactional email service API with NodeJS
Downloads
77
Maintainers
Readme
SMTP Locaweb NodeJS
Leia a versão em português no README.pt-br.md.
This is a NPM library to make usage of Locaweb transactional email service API with NodeJS.
WARNING: if you wish to send email using the SMTP protocol, instead of the REST API, use a SMTP library such as Nodemailer to send your messages.
Instalation and Configuration
Install it as usual, with NPM package manager by typing:
npm i smtp-locaweb-nodejs
After that, you must create a .env
file on the root folder of your application with your account's API token, just like show below:
TOKEN=yourAccountToken
No spaces are allowed. The token can be found by accessing the product's dashboard.
Usage
Later, just require the package on your application:
var locaweb = require('smtp-locaweb-nodejs');
You can create a new email object involking the Email constructor and using the following methods to populate it:
var email = new locaweb.Email();
email.addTo('[email protected]');
email.addSubject('Email title!!!');
email.addFrom('[email protected]');
email.addBody('A cool and useful content.');
email.addCc('[email protected]');
email.addBcc('[email protected]');
email.addHeaders({x-source: api});
locaweb.sendMail(email);
Another possible way is passing an object to the constructor. The advantage to this strategy is that you can pass multiples recipients, CCs, BCCs in an array:
message = {
to: ['[email protected]', '[email protected]', '[email protected]'],
subject: 'Email title!!!',
from: '[email protected]',
body: 'A cool and useful content.',
cc: ['[email protected]']
}
var email = new locaweb.Email(message);
locaweb.sendMail(email);
Only the first 4 attributes are mandatory, the others are all optional. For more in-depth information, see the official documentation at http://developer.locaweb.com.br/documentacoes/smtp.