儀表板
系統運作狀態與統計
收件匣未讀
—
Gmail
已處理信件
—
累積
已自動轉寄
—
成功
待人工審核
—
需處理
🔗 系統狀態
載入中...
📋 最近處理記錄
載入中...
業務人員管理
職責說明越詳細，AI 判斷越準確
姓名 Email 職責說明 狀態 操作
業務類別管理
定義信件類型，每個類別綁定一位負責人
類別名稱 說明 負責人 狀態 操作
主持人 / 節目名稱
讓 AI 知道這些名字是品牌識別，不因名字出現就誤判
💡
當信件中出現這些名字時，AI 會注意這是公司品牌，並根據信件的意圖來判斷分類，而非單純因為名字出現就誤導分類。
名稱 別名 / 暱稱 備注 狀態 操作
信件處理記錄
查看每封信的 AI 判斷結果與轉寄狀況
收信時間 寄件人 主旨 AI 分類 動作 操作
關鍵字規則管理
命中規則的信件直接轉寄，不呼叫 AI（優先順序高）
⚡
關鍵字規則在 AI 判斷之前執行。優先序數字越大越優先。規則命中後直接轉寄，不再呼叫 Gemini，速度快且無 API 費用。
優先序 關鍵字 比對範圍 比對方式 收件人 說明 狀態 操作
AI 判斷規則
用自然語言寫路由邏輯，AI 處理信件時會參考這些規則
🧠
這些規則會直接注入給 Gemini，讓 AI 在判斷時參考。規則用繁體中文描述即可，例如：「若信件邀請鄭國威個人演講或受訪，只轉給鄭國威，不要給其他人」。優先序數字越大越優先。
優先序 規則名稱 規則內容 狀態 操作
系統設定
調整 AI 行為與信件掃描設定
🔑 Gmail 授權
載入中...
🤖 AI 設定
API Key 請在伺服器的 .env 檔設定 GEMINI_API_KEY
關閉後，所有信件都會進入人工審核佇列，不會自動轉寄
⏱️ 掃描設定
每次排程最多處理幾封信，避免一次呼叫太多次 Gemini API
📧 Gmail 信件處理行為
「垃圾信」指 AI 判定 is_spam=true 的信件；關鍵字命中的信件不會被視為垃圾信
處理過的信件會加上此 Gmail 標籤；變更後新標籤會自動建立
開啟（預設）：AI 判定為垃圾信也加標籤，避免下次重複處理
兩種模式都完整保留附件、HTML 排版、嵌入圖片。.eml 模式原信 bytes 完全沒被修改，最穩定；inline 模式閱讀體驗最佳，但 S/MIME 簽章等特殊信件可能重建失敗
🔗 Webhook 通知（給 Business Hub 用）
每封信處理完後，POST 通知此 URL（留空=停用）
設定後會在 X-MailRouter-Signature header 加上 HMAC SHA-256 簽章，供接收端驗證來源
📊 自來客回填 Google 試算表
自來客表單寄給業務後，自動整理並追加一列到試算表
取自試算表網址 /spreadsheets/d/這一段/edit。
需先把試算表「共用」給服務帳號的 email（編輯權限）。系統只回填「實際寄給業務的自來客表單」，會自動對應你試算表現有的欄位標題。
👥 自來客業務團隊（一律整組派發）
設定後，只要 AI 判定為自來客商機，一律同時寄給此清單中的所有人（一封信、收件人並列），不再由 AI 自由加減人數。
清單只認目前「業務人員」中存在且啟用的 Email；留空＝沿用 AI 逐筆判斷的指派。
政府單位或勾選整合行銷的自來客，改派給此信箱（不寄給業務團隊）。
每封派發通知都會多寄一份到這裡供留存/監看；不會列入「派給」記錄，不影響責任歸屬。
當公司名／姓名／內容整格等於清單中的字（不分大小寫），或幾乎空白時， 即使被判為自來客也攔下不自動派發、標記「未處理」交人工看。留空＝用系統預設清單。
🔗 Ragic 舊客比對（規則 2）
取得方式：登入 Ragic → 右上角個人設定 / 帳號設定 → API Key（或請 Ragic 管理者開立）。
這是機密，請只在此貼上、勿外流。填好後我才能接上「舊客自動比對」。
取自表單網址 /default/forms31/41?PAGEID=… 這一段（既有客戶專案查詢表）。
🛎️ 進件中斷警報（守門員）
當進件長時間中斷時，系統會寄警報信到這個信箱。
連續超過這個時數沒讀到任何官網進件，就寄警報（附 24 小時冷卻、恢復後自動重置）。
警報用系統自己的信箱直接寄、不經官網 WP Mail SMTP，所以官網寄信再壞也送得出去。
🔗 官網表單串接（webform）
官網表單送出後，要 POST 到這個網址。
串接程式碼裡的 token 要填這一組。請只在信任的環境複製貼上，勿公開張貼。
外部呼叫 /webform 時需在 HTTP header 帶 X-Webform-Token 為這組值。