电子邮件通知对于现代 Web 应用程序至关重要。在本指南中，我们将使用 Express.js 和 Gmail 的 OAuth2 身份验证构建安全的电子邮件通知服务。我们的服务将接受 webhook 请求并根据传入数据自动发送电子邮件。

我们正在建设什么

我们将创建一个 Express 服务器：

• 通过 POST 请求接收 webhook 数据
• 使用 OAuth2 通过 Gmail 进行身份验证
• 根据 webhook 负载发送自定义电子邮件
• 优雅地处理错误

先决条件

• Node.js 安装在您的计算机上
• 启用 Gmail API 的 Google Cloud Console 项目
• OAuth2 凭据（客户端 ID、客户端密钥、刷新令牌）
• Express.js 和 async/await 的基本了解

项目设置

首先，安装所需的软件包：

npm install express body-parser nodemailer googleapis dotenv

使用您的凭据创建 .env 文件：

CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret
REDIRECT_URI=your_redirect_uri
REFRESH_TOKEN=your_refresh_token
[email protected]

如果您在设置这些凭据时遇到任何困难，就像我一样，您可以按照以下步骤操作...

第 1 步：创建新的 Google Cloud 项目：

一个。转到 https://console.cloud.google.com/
b.单击页面顶部的项目下拉列表
c.点击“新建项目”
d.输入项目名称，点击“创建”

第 2 步：启用 Gmail API：
一个。在左侧边栏中，转到“API 和服务”>“库”
b.搜索“Gmail API”
c.点击“Gmail API”，然后点击“启用”

第 3 步：配置 OAuth 同意屏幕：
一个。转到“API 和服务”>“OAuth 同意屏幕”
b.选择“外部”作为用户类型，然后单击“创建”
c.填写必填字段：
- 应用程序名称：[您的应用程序名称]
- 用户支持电子邮件：[您的电子邮件]
- 开发者联系信息：[您的电子邮件]
d.点击“保存并继续”
e.在“范围”页面上，单击“添加或删除范围”
f.查找并选择“https://mail.google.com/”范围
g。单击“更新”，然后单击“保存并继续”
h.在“测试用户”页面，点击“添加用户”
我。添加您的 Gmail 地址并点击“保存并继续”
j。查看摘要并单击“返回仪表板”

第 4 步：创建 OAuth2 凭据：
一个。转到“API 和服务”>“凭据”
b.单击“创建凭据”>“OAuth 客户端 ID”
c.选择“Web应用程序”作为应用程序类型
d.名称：[您的应用名称]
e.授权的 JavaScript 来源：添加服务器的域（例如，用于本地开发的 http://localhost:3000）

f.授权重定向 URI：
- 添加：https://developers.google.com/oauthplayground
- 添加服务器的回调 URL（如果有的话）（例如，http://localhost:3000/auth/google/callback）
g。点击“创建”
h.弹出窗口将显示您的客户端 ID 和客户端密钥。安全地保存这些。

第五步：获取新的刷新令牌：
一个。转到 https://developers.google.com/oauthplayground/

b.单击右上角的齿轮图标（如设置）
c.单击复选框“使用您自己的 OAuth 凭据”
d.输入您的新客户端 ID 和客户端密钥
e.关闭设置
f.在左侧边栏中，找到“Gmail API v1”
g。选择 https://mail.google.com/
h.点击“授权API”
我。选择您的 Google 帐户并授予请求的权限
j。在下一个屏幕上，单击“将授权码兑换为令牌”
k.从响应中复制“刷新令牌”

如果您在此过程中或测试电子邮件功能时遇到任何问题，请提供您在评论中看到的具体错误消息或行为。

代码解释

我们来一步步分解实现：

1. 初始设置和依赖关系

const express = require("express");
const bodyParser = require("body-parser");
const nodemailer = require("nodemailer");
const { google } = require("googleapis");
require("dotenv").config();

const app = express();
app.use(bodyParser.json());

这部分设置我们的 Express 服务器并导入必要的依赖项。我们使用 body-parser 来解析 JSON 请求，并使用 dotenv 来管理环境变量。

2.OAuth2配置

const oAuth2Client = new google.auth.OAuth2(
  CLIENT_ID,
  CLIENT_SECRET,
  REDIRECT_URI
);
oAuth2Client.setCredentials({ refresh_token: REFRESH_TOKEN });

我们使用 Google 的身份验证库创建 OAuth2 客户端。这可以使用 Gmail 的 API 处理令牌刷新和身份验证。

3. 邮件发送功能

async function sendEmail(webhookData) {
  const {
    receiver_email, //change data based on your needs
  } = webhookData;

  try {
    const accessToken = await oAuth2Client.getAccessToken();
    const transport = nodemailer.createTransport({
      service: "gmail",
      auth: {
        type: "OAuth2",
        user: process.env.EMAIL_USER,
        clientId: CLIENT_ID,
        clientSecret: CLIENT_SECRET,
        refreshToken: REFRESH_TOKEN,
        accessToken: accessToken,
      },
    });

    const mailOptions = {
      from: `Your Name `,
      to: receiver_email,
      subject: ``, //Add Subject of Email
      html: ``, // Add your HTML template here
    };

    return await transport.sendMail(mailOptions);
  } catch (error) {
    console.error("Error in sendMail function:", error);
    throw error;
  }
}

该函数：

• 从webhook负载中提取数据，您可以根据需要修改负载
• 获取新的访问令牌
• 使用 OAuth2 身份验证创建传输
• 发送包含自定义内容的电子邮件

4.Webhook端点

app.post("/webhook", async (req, res) => {
  try {
    const webhookData = req.body;
    await sendEmail(webhookData);
    res.status(200).send("Email sent successfully");
  } catch (error) {
    console.error("Error processing webhook:", error);
    res.status(500).send("Error processing webhook");
  }
});

我们的 webhook 端点：

• 接收POST请求
• 处理 webhook 数据
• 发送电子邮件
• 返回适当的响应

测试

使用curl或Postman测试您的webhook：

curl -X POST http://localhost:4000/webhook \
-H "Content-Type: application/json" \
-d '{
  "receiver_email": "[email protected]",
}'

故障排除

常见问题及解决方案：

1. 身份验证错误：检查您的 OAuth2 凭据
2. 令牌过期：确保刷新令牌有效
3. 缺少数据：验证 webhook 有效负载

结论

您现在拥有一个安全的、OAuth2验证的电子邮件通知系统！此实现为构建更复杂的通知系统提供了坚实的基础，同时保持安全性和可靠性。

希望这篇文章对您设置电子邮件服务有用。

编码愉快！ ？