使用說明
— 操作流程、API 金鑰申請與設定v3.3.5① 採集名單
比對中心 / 採集任務1
到 採集任務，輸入關鍵字（如「養生館」）與縣市/地區，執行 Google Places 採集；或到 政府資料匯入 匯官方名冊（診所/旅宿/禮儀/宮廟/月子…）。
2
到 比對中心，用「🚀 批次採集」勾「🏛 工商統編比對」補統編與公司登記名（mygov / GCIS / twincn）。
3
勾「🔗 管道補齊」自動補 LINE/電話/Email/IG/FB：免費方法優先（官網爬蟲→DDG+Bing 並行找官網與社群→Email 網域推測）；付費 Google API 預設關閉，勾了才當備援。
4
低價值名單（採後仍無電話+Email）會自動遮蔽；「⋯ 更多工具」也可手動遮蔽/還原，遮蔽者批次採集跳過、清單隱藏，加快讀取。
🔎 類別/統計數字取自跨全 5.8 萬筆的完整統計；批次預設跳過 7 天內已試過的品牌、30 線並行，進度條會顯示每分鐘筆數與預估剩餘時間。
② 經營名單
名單總覽 / 商機 / 跟進1
名單總覽：檢視每個品牌的聯絡管道、工商資料、門市與評論；可建立客戶照護計畫（拜訪/回購週期）。
2
商機進度：把名單推進到打樣、報價、議約、成交等階段。AI 語音外撥的每通電話會自動在這裡建立/推進商機並註記「AI語音」。
3
今日跟進：系統自動產生回購、拜訪到期、停滯商機、三節提醒等任務。漏斗分析看各階段轉換與熱度。
③ 產品與報價
產品報價1
在 產品資料 分頁維護產品（售價、通路價、成本、毛利、規格、最低起訂量）。
2
在 報價單 分頁點「＋ 新增報價單」，左側點選產品加入、調整數量與折扣，搜尋並綁定客戶名單。
3
建立後可查看、改狀態（草稿/已寄出/已接受），並「📋 複製內容」貼到 LINE 或 Email。
④ 電子報外發
郵件編輯器 / 電子報發送 / 郵件儀表板1
郵件編輯器：選 11 組情境範本（初次開發、報價、節慶…）或按「✨ AI 生成」用主題自動產生草稿，編輯後「存成模板」。
2
電子報發送：左側勾選收件名單（自動帶出採集到 Email 的客戶），右側選模板預覽，點「寄送」批次發出。
3
郵件儀表板：追蹤寄送量、開信率、點擊率、退信與回覆，並有漏斗、依產業/模板分析。
📧 怎麼真正寄出 Email？
重要支援三家寄信服務，設定其中一家即可。未設定前是「模擬寄出」——會標記已寄、但不會真的進對方信箱。 電子報發送頁上方會顯示目前模式與使用的服務。可用 EMAIL_PROVIDER（gmail / resend / sendgrid）指定，否則自動挑選。
方案 A — Gmail SMTP（最快，不需網域）
1
Gmail 帳號開啟兩步驟驗證，到 Google 帳戶 → 安全性 → 應用程式密碼 產生一組 16 碼密碼。
2
填入環境變數：
EMAIL_PROVIDER=gmail
GMAIL_USER=你的帳號@gmail.com
GMAIL_APP_PASSWORD=16碼應用程式密碼
OUTREACH_FROM_NAME=HeroHerb 好漢草
APP_BASE_URL=https://你的網址
⚠️ 免費 Gmail 每日約 500 封上限，且不適合大量冷開發信（送達率/帳號風險），適合先小量測試。
方案 B — Resend（適合長期、量大）
1
到 resend.com 註冊 → Domains 驗證寄件網域（加 SPF/DKIM DNS）→ 建立 API Key。
2
填入環境變數：
EMAIL_PROVIDER=resend
RESEND_API_KEY=re_xxxxxxxx
OUTREACH_FROM_EMAIL=hello@你的網域.com
OUTREACH_FROM_NAME=HeroHerb 好漢草
APP_BASE_URL=https://你的網址
方案 C — SendGrid（每日免費額度較高）
1
到 sendgrid.com 註冊 → Settings → Sender Authentication 驗證寄件人或網域。
2
Settings → API Keys → Create API Key（權限選 Mail Send），複製 SG. 開頭金鑰。
EMAIL_PROVIDER=sendgrid
SENDGRID_API_KEY=SG.xxxxxxxx
OUTREACH_FROM_EMAIL=hello@你的網域.com
方案 D — 自訂 SMTP（自有郵件主機 / 其他服務商）
1
向你的郵件服務商（公司信箱、Mailgun、Postmark、Zoho…）取得 SMTP 主機、連接埠、帳號、密碼。
2
填入環境變數（port 587 用 STARTTLS、465 用 SSL 則 SMTP_SECURE=true）：
EMAIL_PROVIDER=smtp
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=帳號
SMTP_PASS=密碼
OUTREACH_FROM_EMAIL=hello@你的網域.com
3
存檔後重啟（本機）或重新部署（Vercel）。回 電子報發送 確認上方變「✅ 真實寄送模式」，選名單、選模板、按「寄送」。
4
到 郵件儀表板 看送達、開信、點擊、退信、回覆。報價單「✉ 寄給客戶」也走同一條寄信管道。
🔌 內部已串接：Resend／SendGrid 走 HTTP API、Gmail／自訂 SMTP 走 nodemailer。你只要填金鑰/密碼，系統自動依 EMAIL_PROVIDER 或已設定的金鑰挑選。「API 設定」頁可看到哪些已設定。
⑤ AI 語音外撥
AI 語音外撥 → 商機進度1
匯出可外撥名單：選產業下載 CSV（只含有電話、未拒撥、未遮蔽者，帶 brand_id 與話術變數：品牌名/產業/縣市/負責人）。
2
用語音 AI 平台外撥：Bland AI / Retell / Vapi / ElevenLabs。撥號時把 brand_id 放進該平台的 metadata / dynamic variables 帶著跑。
3
自動回寫（webhook）：把平台「通話結束」的 webhook 指向 /api/voice/webhook?provider=平台代號，逐字稿/錄音/秒數/成效就自動進系統；或用「匯入結果 CSV」手動匯入。
4
每通電話無論接通與否都會自動寫入商機進度並註記「AI語音」：接通→已聯繫、有興趣/約回撥→留在管道、沒興趣/拒撥→登記流失（拒撥號碼加入拒撥名單、下次匯出排除）。
⚖️ 合規四要點：用自己的聲音、開場表明是 AI 助理、告知錄音、維護拒撥名單。webhook 可設 VOICE_WEBHOOK_TOKEN 密鑰驗證。本系統只做名單匯出與結果紀錄，不代為撥打。