engagelab-email

# EngageLab Email

## 概述

此 Skill 允许 Manus 通过 EngageLab 的 REST API 发送电子邮件。它封装了复杂的 API 调用细节，使得发送邮件、管理收件人、处理邮件内容（HTML/纯文本）、进行变量替换以及添加附件变得简单高效。此外，还支持配置高级发送设置，如沙箱模式、邮件追踪等。

## 核心功能

### 1. 发送普通邮件

通过指定发件人、收件人、主题和邮件内容（HTML 或纯文本）来发送基本的电子邮件。支持抄送 (CC) 和密送 (BCC)。

**使用场景**：发送通知、确认邮件、简单消息等。

### 2. 邮件内容与变量替换

支持在邮件主题和内容中使用变量，并通过 `vars` 或 `dynamic_vars` 参数进行替换，实现邮件内容的个性化。

- **`vars`**: 适用于简单的文本替换，如 `Dear %name%`。
- **`dynamic_vars`**: 适用于动态模板引擎的变量替换，如 `Dear {{name}}`。

**使用场景**：发送营销邮件、批量个性化通知等。

### 3. 附件处理

支持在邮件中添加附件。附件内容需要进行 Base64 编码。可以设置附件的文件名、类型以及处置方式（`inline` 或 `attachment`）。`inline` 模式常用于在邮件正文中嵌入图片。

**使用场景**：发送报告、图片、文档等。

### 4. 高级发送设置

通过 `settings` 参数可以配置多种发送行为，包括：

- **`send_mode`**: 发送模式（0: 普通, 1: 模板, 2: 地址列表）。
- **`sandbox`**: 是否开启沙箱模式进行测试，邮件不会实际发送。
- **`open_tracking`**, **`click_tracking`**, **`unsubscribe_tracking`**: 邮件打开、点击和取消订阅的追踪。

**使用场景**：测试邮件发送功能、进行邮件营销效果分析。

## 资源

### scripts/

- **`send_email.py`**: 这是一个 Python 脚本，封装了 EngageLab 邮件发送 API 的调用逻辑。它处理了身份验证、请求体构建、API 调用和错误处理。你可以直接调用此脚本来发送邮件。

### references/

- **`api_spec.md`**: 包含了 EngageLab 邮件发送 REST API 的详细参数说明、请求示例和响应格式。当需要深入了解 API 的具体细节时，可以查阅此文件。

### templates/

当前 Skill 没有特定的模板文件，因为邮件内容通常是动态生成的。如有需要，可以根据具体场景添加邮件内容模板。