enviar-email-msgraph
v1.0.4
Published
Pacote para enviar e-mails usando o Microsoft Graph API.
Downloads
25
Maintainers
Readme
enviar-email-msgraph
Biblioteca para enviar e-mails usando o Microsoft Graph API em Node.js.
Descrição
Esta biblioteca permite enviar e-mails através do Microsoft Graph API. Ela encapsula a lógica de obtenção do token de acesso e o envio de e-mails, simplificando a integração com o Microsoft Graph em projetos Node.js.
Instalação
Para instalar este pacote, use o npm:
npm install enviar-email-msgraph
Como Usar
1. Importar o Pacote
Primeiro, importe o pacote e crie uma nova instância de GraphEmailClient
, fornecendo as credenciais necessárias:
const GraphEmailClient = require("enviar-email-msgraph");
// Crie uma instância do cliente de e-mail com as credenciais
const emailClient = new GraphEmailClient(
"YOUR_CLIENT_ID",
"YOUR_CLIENT_SECRET",
"YOUR_TENANT_ID",
"YOUR_USER_ID"
);
2. Enviar um E-mail
Use o método sendEmail
da instância para enviar um e-mail:
emailClient
.sendEmail("[email protected]", "Assunto do E-mail", "Corpo do E-mail")
.then(() => console.log("E-mail enviado com sucesso!"))
.catch((error) => console.error("Erro ao enviar e-mail:", error));
Parâmetros
clientId
: O ID do cliente registrado no Azure AD.clientSecret
: O segredo do cliente gerado no Azure AD.tenantId
: O ID do locatário associado ao Azure AD.userId
: O endereço de e-mail do usuário que enviará os e-mails (deve ter permissões adequadas).toEmailAddress
: O endereço de e-mail do destinatário.subject
: O assunto do e-mail.bodyContent
: O conteúdo do corpo do e-mail.
Exemplo Completo
Aqui está um exemplo completo de como configurar e enviar um e-mail:
const GraphEmailClient = require("enviar-email-msgraph");
// Configuração do cliente de e-mail
const emailClient = new GraphEmailClient(
"YOUR_CLIENT_ID",
"YOUR_CLIENT_SECRET",
"YOUR_TENANT_ID",
"YOUR_USER_ID"
);
// Enviando o e-mail
emailClient
.sendEmail("[email protected]", "Assunto do E-mail", "Corpo do E-mail")
.then(() => console.log("E-mail enviado com sucesso!"))
.catch((error) => console.error("Erro ao enviar e-mail:", error));
Dependências
Este pacote depende de:
node-fetch
: Para fazer solicitações HTTP ao Microsoft Graph API.
Observações
- Permissões: O aplicativo registrado no Azure AD deve ter as permissões corretas para enviar e-mails através do Microsoft Graph API (
Mail.Send
). - Segurança: Nunca inclua suas credenciais (
clientId
,clientSecret
, etc.) diretamente no código-fonte em ambientes de produção. Utilize variáveis de ambiente ou serviços seguros para gerenciar essas informações.
Licença
ISC License
Resumo
Este README.md
inclui:
- Uma breve descrição do pacote.
- Instruções para instalação.
- Um exemplo de uso com explicações detalhadas sobre como configurar e enviar um e-mail.
- Descrição dos parâmetros e métodos.
- Observações importantes sobre permissões e segurança.