> ## 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 穩定同步郵箱中繼資料、完整正文和附件。
# 通用郵箱同步
通用郵箱同步用於將企業或個人郵箱中的郵件穩定同步到產品內：同步郵件中繼資料、完整正文和附件，並寫入專案收件匣與檔案儲存。適合客服郵箱、業務通知郵箱、售後郵箱、招聘郵箱等需要長期、穩定收信的場景。
***
## 能做什麼
* 接入多個企業或個人郵箱。
* 同步郵件中繼資料，並獲取完整郵件正文。
* 解碼並上傳郵件附件至專案檔案儲存。
* 由後台定時同步新增郵件；失敗可重試，不同郵箱相互隔離。
雲計算和檔案儲存等底層能力會由 superun 按需準備。你通常不需要單獨理解這些依賴。
***
## 接入前需要準備
| 準備項 | 說明 |
| ----------- | --------------------------------- |
| 郵箱地址 | 需要同步的企業或個人郵箱 |
| 客戶端授權碼 | 使用授權碼或應用專用密碼，不要使用郵箱登入密碼 |
| IMAP / POP3 | 確認已開啟客戶端收信，或準備好主機與連接埠 |
| 服務商資訊 | 可選擇常見郵箱服務商，或手動填寫 IMAP/POP3 主機與連接埠 |
***
## 郵箱需要開啟什麼能力
通用郵箱同步不需要到飛書、釘釘或企業微信後台申請權限，但需要在郵箱服務商後台開啟客戶端訪問能力。
| 配置項 | 用途 | 說明 |
| ------------- | ------------- | ------------------------------ |
| IMAP | 發現和同步郵件中繼資料 | 通常在「設定」→「客戶端授權」或「POP3/IMAP」中開啟 |
| POP3 | 獲取完整郵件正文與附件 | 建議與 IMAP 一併開啟，按產品提示配置 |
| 客戶端授權碼 / 專用密碼 | 用於系統登入郵箱客戶端協議 | 不要填寫郵箱網頁登入密碼 |
常見郵箱說明：
| 郵箱類型 | 需要使用者確認 |
| --------------- | ---------------------------------- |
| 騰訊企業郵箱 | 開啟客戶端收信，並使用客戶端專用密碼或授權碼 |
| 網易企業郵箱 / 163 郵箱 | 開啟 IMAP/POP3，並使用授權碼 |
| 其他企業郵箱 | 確認 IMAP/POP3 伺服器地址、連接埠、安全連接方式和專用密碼 |
***
## 如何在 superun 中啟用
在技能庫中打開「通用郵箱同步」，點擊右上角「使用」，讓 superun 開始接入。
為每個郵箱填寫郵箱地址、服務商或 IMAP/POP3 主機與連接埠，以及授權碼或應用專用密碼。
系統會建立同步任務、收件匣介面和附件儲存。確認新郵件能進入收件匣，附件可正常打開。
***
## 使用限制
* 必須使用郵箱授權碼或應用專用密碼，不能使用郵箱登入密碼。
* 首次同步預設匯入近期郵件，不會全量遍歷整個郵箱歷史。
* 中國區同步鏈路不支援 Gmail、Outlook、Yahoo 等在國內網路環境下不可穩定訪問的海外郵箱服務。
* 建議為不同郵箱分別配置與驗證，避免某個郵箱異常影響其他郵箱。
* 郵箱授權碼等敏感資訊請只填寫在產品配置頁中，不要直接發在公開對話裡。
* 啟用或停用該能力可能會調整專案程式碼，並消耗專案算力值。