README.pt-br.md

SMTP Locaweb NodeJS

Trata-se de uma biblioteca NPM para fazer uso da API de envio do serviço de email transacional da Locaweb com NodeJS.

ATENÇÃO: se você deseja enviar os seus emails utilizando o protocolo SMTP, ao invés da API REST, use uma biblioteca SMTP como o Nodemailer, para enviar suas mensagens.

Instalação e Configuração

Instale normalmente, através do NPM digitando:

npm i smtp-locaweb-nodejs

Depois disso, é preciso criar um arquivo .env na pasta raiz da sua aplicação contendo seu token de uso da API, conforme mostrado abaixo:

TOKEN=yourAccountToken

Não são permitidos espaços. O token pode ser encontrado acessando o painel do produto.

Uso

Em seguida, faça o "import" do pacote em sua aplicação:

var locaweb = require('smtp-locaweb-nodejs');

Você pode criar um novo objeto email ao invocar o construtor Email e usar os seguintes métodos para adicionar os atributos:

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);

Outra forma possível é passar um objeto ao construtor. A vantagem desta estratégia é que você pode passar múltiplos destinatários, CCs, BCCs como arrays:

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);

Apenas os primeiros 4 atributos são obrigatórios. Para mais informações, consulte a documentação oficial em http://developer.locaweb.com.br/documentacoes/smtp.