> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 通用邮箱同步

> 通过 IMAP 与 POP3 稳定同步邮箱元数据、完整正文和附件。

# 通用邮箱同步

通用邮箱同步用于将企业或个人邮箱中的邮件稳定同步到产品内：同步邮件元数据、完整正文和附件，并写入项目收件箱与文件存储。适合客服邮箱、业务通知邮箱、售后邮箱、招聘邮箱等需要长期、稳定收信的场景。

***

## 能做什么

* 接入多个企业或个人邮箱。
* 同步邮件元数据，并获取完整邮件正文。
* 解码并上传邮件附件至项目文件存储。
* 由后台定时同步新增邮件；失败可重试，不同邮箱相互隔离。

<Note>
  云计算和文件存储等底层能力会由 superun 按需准备。你通常不需要单独理解这些依赖。
</Note>

***

## 接入前需要准备

| 准备项         | 说明                               |
| ----------- | -------------------------------- |
| 邮箱地址        | 需要同步的企业或个人邮箱                     |
| 客户端授权码      | 使用授权码或应用专用密码，不要使用邮箱登录密码          |
| IMAP / POP3 | 确认已开启客户端收信，或准备好主机与端口             |
| 服务商信息       | 可选择常见邮箱服务商，或手动填写 IMAP/POP3 主机与端口 |

***

## 邮箱需要开启什么能力

通用邮箱同步不需要到飞书、钉钉或企业微信后台申请权限，但需要在邮箱服务商后台开启客户端访问能力。

| 配置项           | 用途            | 说明                             |
| ------------- | ------------- | ------------------------------ |
| IMAP          | 发现和同步邮件元数据    | 通常在「设置」→「客户端授权」或「POP3/IMAP」中开启 |
| POP3          | 获取完整邮件正文与附件   | 建议与 IMAP 一并开启，按产品提示配置          |
| 客户端授权码 / 专用密码 | 用于系统登录邮箱客户端协议 | 不要填写邮箱网页登录密码                   |

常见邮箱说明：

| 邮箱类型            | 需要用户确认                            |
| --------------- | --------------------------------- |
| 腾讯企业邮箱          | 开启客户端收信，并使用客户端专用密码或授权码            |
| 网易企业邮箱 / 163 邮箱 | 开启 IMAP/POP3，并使用授权码               |
| 其他企业邮箱          | 确认 IMAP/POP3 服务器地址、端口、安全连接方式和专用密码 |

***

## 如何在 superun 中启用

<Steps>
  <Step title="点击右上角「使用」">
    在技能库中打开「通用邮箱同步」，点击右上角「使用」，让 superun 开始接入。
  </Step>

  <Step title="配置邮箱">
    为每个邮箱填写邮箱地址、服务商或 IMAP/POP3 主机与端口，以及授权码或应用专用密码。
  </Step>

  <Step title="确认同步结果">
    系统会创建同步任务、收件箱界面和附件存储。确认新邮件能进入收件箱，附件可正常打开。
  </Step>
</Steps>

***

## 使用限制

* 必须使用邮箱授权码或应用专用密码，不能使用邮箱登录密码。
* 首次同步默认导入近期邮件，不会全量遍历整个邮箱历史。
* 中国区同步链路不支持 Gmail、Outlook、Yahoo 等在国内网络环境下不可稳定访问的海外邮箱服务。
* 建议为不同邮箱分别配置与验证，避免某个邮箱异常影响其他邮箱。
* 邮箱授权码等敏感信息请只填写在产品配置页中，不要直接发在公开对话里。
* 启用或停用该能力可能会调整项目代码，并消耗项目算力值。