邮件集成指南

本指南帮助你配置 Gmail 或 Outlook 邮件集成，在 MihootCRM 中使用 AI 邮件分析和回复功能。

1. 邮件 OAuth 配置

1.1 配置 Gmail

前提条件：

• 已有 Google Cloud 项目并启用了 Gmail API
• 已获取 OAuth 2.0 客户端 ID 和客户端密钥

环境变量配置（由管理员在部署时设置）：

• NEXT_PUBLIC_GOOGLE_CLIENT_ID：Google OAuth 客户端 ID

操作步骤：

1. 进入 集成页面
2. 在集成列表中找到"Gmail"并点击"连接"
3. 系统跳转至 Google 授权页面
4. 登录 Google 账号，授权 MihootCRM 访问 Gmail
5. 授权成功后自动回调至 /integrations/callback/gmail
6. 连接成功后，在 /integrations 中显示为"已连接"

1.2 配置 Outlook

前提条件：

• 已有 Microsoft Azure 应用注册
• 已获取 OAuth 2.0 客户端 ID、租户 ID 和客户端密钥

环境变量配置（由管理员在部署时设置）：

• NEXT_PUBLIC_OUTLOOK_CLIENT_ID：Outlook 客户端 ID
• NEXT_PUBLIC_OUTLOOK_TENANT_ID：Outlook 租户 ID
• NEXT_PUBLIC_OUTLOOK_CLIENT_SECRET_VALUE：客户端密钥值
• NEXT_PUBLIC_OUTLOOK_CLIENT_SECRET_ID：客户端密钥 ID

操作步骤：

1. 进入 集成页面
2. 在集成列表中找到"Outlook"并点击"连接"
3. 按提示完成 Microsoft 账号授权
4. 授权成功后自动回调至 /integrations/callback/outlook
5. 连接成功后显示为"已连接"

1.3 IMAP 直连

除 OAuth 外，系统还支持标准的 IMAP 直连方式。在 /integrations 中选择 IMAP 类型，填写服务器、端口、用户名、密码等信息即可。

2. AI 邮件分析

使用场景

• 邮件内容分析：AI 自动分析邮件正文，提取关键信息（意图、紧急程度、行动项）
• 回复建议：AI 根据邮件内容生成回复草稿，可选择发送或手动编辑
• 邮件翻译：自动翻译外文邮件内容

操作步骤

1. 在 /mails 中打开一封邮件
2. 点击"AI 分析"按钮
3. 系统调用 AI 分析邮件内容，返回：
   • 邮件摘要：一两句话概括邮件核心内容
   • 意图识别：询问/投诉/咨询/报价请求等
   • 建议行动：需要回复、转交、创建任务等

AI 回复生成

1. 在邮件详情页点击"生成回复"
2. AI 根据原始邮件内容 + 上下文生成回复草稿
3. 预览回复内容，可直接发送或手动修改后发送

邮件翻译

1. 在邮件详情页点击"翻译"
2. 选择目标语言
3. AI 自动翻译邮件正文内容

3. 邮件营销相关

邮件集成配置完成后，你还可以：

• 在 /email-marketing 中选择已连接的邮箱作为发送人
• 系统会在营销邮件中嵌入追踪像素，自动记录打开事件到客户时间线
• AI 可批量分析邮件回复，分类客户意向

详见「营销管理指南」。

4. 邮件凭证存储

所有 OAuth Token 通过 credential-crypto.ts 加密存储，确保密钥安全。连接状态和令牌有效性由系统自动管理，Token 过期前会自动刷新。

5. 故障排查

6. 相关文档

• 营销管理指南 — 邮件营销活动管理
• AI 智能助理指南 — AI 模型与能力配置