串接對話平台：Email

串接 Email 對話平台：設定收發信帳號（Gmail 需應用程式專用密碼）、綁定 Agent，讓 Agent 自動回覆來信的步驟與限制。

串接前確認

• 已在 MaiAgent 平台上建立好一個「AI 助理」

• 已準備好要串接的電子郵件帳號（Gmail、Outlook、Yahoo 或自訂郵件伺服器）

• 若使用 Gmail 或 Outlook，需先產生應用程式專用密碼（非帳號密碼）

Gmail 必須使用 16 位數的應用程式專用密碼，無法使用 Google 帳號密碼登入。請先至 Google 帳號安全性 產生專用密碼。

Email 對話平台做什麼、不做什麼

Email 對話平台是「收信 → Agent 自動回信」：MaiAgent 用 IMAP 收取寄到這個信箱的新郵件，交給綁定的 Agent 產生回覆，再用 SMTP 回信給寄件人；每封來信與回覆都會出現在 所有對話，客服也能在那裡接手回覆。它不會把信箱裡的既有郵件匯入，使用者也不能在對話中搜尋或查詢這個信箱的內容。

要在對話中查信、摘要郵件或代擬回覆，請改用 MaiGPT 的 連接器 把 Google Workspace（Gmail）或 Microsoft 365（Outlook）接進來；可用的連接器以組織的連接器選單為準。

開始串接

1. 進入串接對話平台頁面

在左側選單點選 對話平台，點擊右上角 串接對話平台 按鈕。

2. 選擇 Email

在平台選擇頁面中，點擊 Email。

3. 選擇郵件服務商

從 郵件服務商 下拉選單中選擇：

服務商	說明
Gmail	Google 信箱，需使用應用程式專用密碼
Outlook / Office 365	Microsoft 信箱，啟用兩步驟驗證時需使用應用程式專用密碼
Yahoo Mail	Yahoo 信箱，需使用應用程式專用密碼
自訂	自行設定 IMAP/SMTP 伺服器參數

選擇服務商後，系統會自動填入對應的 IMAP 和 SMTP 伺服器設定。

4. 填寫連線資訊

電子郵件地址

輸入要串接的完整郵件地址，例如 [e-mail]。

IMAP 設定（收信）

欄位	說明
IMAP 伺服器	收信伺服器位址（Gmail 為 imap.gmail.com）
IMAP Port	連接埠號（通常為 993）
使用 SSL	建議開啟以確保傳輸安全

SMTP 設定（寄信）

欄位	說明
SMTP 伺服器	寄信伺服器位址（Gmail 為 smtp.gmail.com）
SMTP Port	連接埠號（通常為 587）
使用 TLS	建議開啟以確保傳輸安全

認證設定

欄位	說明
使用者名稱	通常為電子郵件地址
密碼	應用程式專用密碼（非帳號密碼）

5. 測試連線

填寫完成後，點擊 測試連線 按鈕。系統會同時測試 IMAP（收信）和 SMTP（寄信）的連線狀況。

• 連線成功：顯示「連線成功！IMAP 和 SMTP 伺服器連線測試通過」

• 連線失敗：系統會顯示具體的錯誤原因（認證失敗、伺服器無法連線等），請根據提示修正設定

請務必在儲存前完成連線測試，確認 IMAP 和 SMTP 均可正常連線。

6. 基本設定與儲存

欄位	說明
對話平台名稱	為此串接取一個名稱
AI 助理	選擇要綁定的 Agent
輪詢間隔	（選填）系統檢查新郵件的頻率（秒）
重置指令	（選填）讓使用者重新開始對話的指令

確認設定無誤後，點擊 儲存 完成串接。

串接完成後，當有人寄信至該郵件地址時，Agent 會自動讀取郵件內容並回覆。

串接成功後，您可以在對話平台列表中找到此串接，點擊編輯可進一步設定功能選項（時段回覆、寄件人名稱感知、權限控管等）。

來信附件怎麼處理

來信的附件（含 HTML 內文裡的內嵌圖片）會存成該則訊息的附件，處理方式和使用者在 Web Chat 上傳檔案相同：

附件類型	Agent 怎麼讀
圖片（.png、.jpg、.gif、.webp 等）	直接交給 Agent 的語言模型判讀，Agent 必須使用支援多模態的模型；開啟功能設定的 啟用 OCR 可辨識圖片中的文字
文件（PDF、Word、Excel、CSV、PowerPoint、TXT 等知識庫支援的格式）與音訊	Agent 必須使用 Agent 模式：Agent 會依來信內容決定要不要用附件工具解析檔案、讀取全文或建立索引，再據以回覆；Excel／CSV 會轉成表格文字，可以回答欄位值，音訊會先轉成逐字稿。其他回答模式只會保留附件檔案，Agent 讀不到內容

• 解析在 Agent 回覆時進行，附件多或檔案大時第一封回信會比較慢；解析費用依知識庫的解析器規則計入 Credits。

• 附件只屬於這段對話，不會進入知識庫；保留天數依平台的附件清理設定，到期後附件與解析副本會自動刪除，見 Credits 計費制度。

• 附件工具可在 Agent 的進階設定個別關閉，見 為 Agent 配置工具；處理細節見技術人員手冊 - 訊息附件怎麼被處理。

郵件內容可以匯出嗎

Email 對話平台沒有「匯出成 PDF／Excel」的功能，Agent 也不會把來信內容轉成檔案。來信與回信都會成為對話紀錄，可在 所有對話 查看，或在 Agent 監控 篩選後批次匯出成 Excel（見對話檢視器：批次匯出）。要把單封郵件的內容整理成文件，可以請 Agent 以 Canvas 產出後下載。