📘 【小慧同學 WP智慧客服】使用說明書

感謝您選擇小慧同學！這份說明書將帶您從零開始，5分鐘內完成設定，讓您的網站立刻擁有24小時智能客服！🚀

📦 外掛基本資訊

項目	內容
外掛名稱	小慧同學 WP智慧客服
適用平台	WordPress (WooCommerce、Easy Digital Downloads 等購物網站皆可)
版本	v7.5.2
作者	小慧同學團隊

📥 安裝方式

方法：手動上傳安裝

前往小慧同學官網下載外掛壓縮檔
登入 WordPress 後台，前往 外掛 → 安裝外掛
點擊頁面頂端的 上傳外掛 按鈕
選擇下載的 zip 檔案，點擊 立即安裝
安裝完成後，點擊啟用

📋 目錄

快速開始（5分鐘設定）
設定頁面導覽
功能詳解
前台操作說明
常見問題
技術支援

快速開始（5分鐘設定）

步驟1：啟用外掛

安裝完成後點擊「啟用」

步驟2：取得Gemini API金鑰（免費）

前往 Google AI Studio
登入Google帳號，點擊「Get API Key」
點擊「Create API Key」，複製產生的金鑰

步驟3：貼上API金鑰

前往後台 設定 → 智慧客服用戶端
點擊「🤖 AI設定」頁籤
貼上API金鑰，選擇模型（建議Gemini 2.5 Flash）
點擊「儲存設定」

步驟4：填寫公司與店家資訊

點擊「🏢 公司介紹」頁籤，填寫公司資料
點擊「🏠 店家資訊」頁籤，填寫店家資料
這些資料會自動讓AI學習，回答客戶問題

步驟5：開啟前台顯示

點擊「⚙️ 基本+角色」頁籤
勾選「前台顯示開關」
可自訂對話框標題（例如「線上店小二」）
點擊「儲存設定」

步驟6：前往前台測試

到您的網站前台，點擊右下角對話泡泡
輸入「你們公司做什麼？」或「營業時間」測試AI回應

🎉 完成！你的網站已經有24小時AI客服了！

設定頁面導覽

後台路徑：設定 → 智慧客服用戶端

頁籤說明

📋 版本記錄

顯示目前版本
試用版資訊（剩餘天數、已使用天數）
授權碼輸入與激活按鈕
使用說明連結
關於「小慧同學」連結

⚙️ 基本+角色

基本設定
- 前台顯示開關
- 對話框標題（可自訂，例如「線上店小二」、「客服小幫手」、「有任何問題歡迎詢問」）
- 機器人名稱
- 主色調
- 歷史紀錄數量（10-200 筆）
角色設定
- 機器人個性
- AI 角色定位
- 興趣愛好
- 幽默程度（正式版）
- 專業程度（正式版）
- 啟用閒聊模式

⚡ 快取設定

啟用回應快取
快取時間（5分鐘至24小時）
啟用 AJAX 快取

🏢 公司介紹

公司全名
公司簡介
成立時間
公司使命（正式版）
公司願景（正式版）
核心價值
主要產品
主要服務

🏠 店家資訊

店家名稱
聯絡電話
地址
營業時間
公休日
價格表
品牌特色
常見問答

🎉 近期活動

啟用活動宣傳
活動名稱
活動說明
活動期間（開始/結束日期）
活動圖片（正式版）
活動連結（正式版）
觸發關鍵字（簡易模式用，最多8組）

🤖 AI 設定（核心功能）

Google Gemini 設定
- 啟用 Gemini
- API Key 輸入（免費版與付費版皆可使用）
- 模型選擇（Gemini 3 Flash / 2.5 Flash / 2.0 Flash / 2.5 Pro）
- API 狀態顯示（額度用完/金鑰無效/無法連線）

📋 關鍵字自動回覆設定（備援系統）

簡易模式關鍵字設定區
- 格式：關鍵字 => 回覆內容
- 每行一組規則
- 支援直接填入店家資訊（AI模式會自動學習，簡易模式需手動填入）

🎤 語音設定

啟用語音輸入
語音速度（正式版可調整 0.5-2.0）

📊 使用統計

每日統計報表
- AI 呼叫次數
- 簡易模式次數
- 快取命中次數
- 節省比例
總計數據
試用版顯示最近7天

📚 學習記錄

啟用記錄
待補充問題列表
- 問題內容
- 詢問次數
- 最後詢問時間
清除記錄按鈕

🔍 Debug

Debug 記錄列表
- 時間
- 類型（ERROR/SUCCESS/WARNING/INFO/NOTIFY）
- 訊息
- 詳細資料查看
功能按鈕
- 重新整理
- 清除記錄
- 一鍵複製記錄
- 測試伺服器連線
- 測試 Webhook 通知
- 清除 AI 記憶
- 手動發送試用記錄（試用版）
- 重置試用記錄（試用版）

功能詳解

1. AI 智慧回覆（核心功能）

使用 Google Gemini API 進行智慧對話，讓您的網站擁有24小時自動客服。

🤖 AI會自動學習您的公司資訊

這是小慧同學最聰明的功能！您只需在後台填寫一次資料，AI就會自動學習並用來回答客戶問題：

AI會學習的資訊來源：

設定頁籤	填寫內容	AI會回答的問題
🏢 公司介紹	公司全名、簡介、成立時間、使命、願景、產品、服務	「你們公司是做什麼的？」「公司成立多久了？」「你們的產品有哪些？」
🏠 店家資訊	店家名稱、電話、地址、營業時間、公休日、價格表、FAQ	「你們幾點開門？」「地址在哪裡？」「電話幾號？」「這個多少錢？」
🎉 近期活動	活動名稱、說明、期間	「最近有什麼優惠？」「活動到什麼時候？」
⚙️ 角色設定	機器人個性、角色定位、興趣愛好	AI會用您設定的個性來回應，更有親切感

範例：

如果您在後台填寫：

公司名稱：美好咖啡工作室
營業時間：10:00-20:00
公休日：週二
地址：台北市大安區和平東路100號

當客戶問「你們幾點開門？」，AI就會自動回答：

「我們美好咖啡工作室營業時間是10:00-20:00，每週二公休喔！歡迎來坐坐～」

完全不用手動設定關鍵字，AI會自動理解問題並給出正確答案！

關於API費用的重要說明

項目	Gemini API 免費版	Gemini API 付費版
費用誰收？	Google免費提供	Google收費（用量計費）
小慧同學收費？	免費	免費
適合對象	多數中小賣家	高流量、高諮詢量的賣家
流量限制	每分鐘60次請求	幾乎無限制
額度用完	自動切換到關鍵字回覆	幾乎不會用完

💡 小提醒：

小慧同學本身完全免費提供這個外掛，我們沒有向用戶收取任何費用
API費用是Google收取的，如果您覺得免費版不夠用（例如每分鐘60次限制），可以考慮付費給Google升級方案
若需付費方案，請前往 Google AI Studio 升級您的Google帳號

對90%的中小賣家來說，免費版就非常夠用了！即使額度用完，系統也會自動切換備援模式，服務不中斷。

2. 關鍵字自動回覆設定（備援系統）

這是最重要的保險機制！當AI額度用完或API暫時無法連線時，系統會自動啟用關鍵字回覆，確保服務永不中斷。

設定範例：

觸發關鍵字	回覆內容	適用情境
運費,運費多少,免運	您好！本店滿$699免運，未滿運費$80。今天下單，明天出貨喔！🚚	常問的運費問題
退貨,換貨,退換貨	收到商品7天內享有鑑賞期，如需退換貨請私訊訂單編號，小幫手會盡快協助您！	售後服務
營業時間,幾點開	我們沒有實體店面，但官網24小時都可以下單！客服回覆時間為週一~週五 9:00-18:00喔！	服務時間
黑色,尺寸,庫存	庫存請直接點擊商品頁的尺寸選擇，有顯示的就是現貨喔！如果沒有尺寸就是售完了😢	商品查詢

設定技巧：

每個規則可以設定多個關鍵字，用逗號分隔（例如：運費,運費多少,免運門檻）
關鍵字越精準越好，避免誤觸
可自行決定優先順序（系統會依序比對）

3. 雙模式自動切換

可以同時使用AI和關鍵字嗎？

A：可以！而且強烈建議！ 這是小慧同學最強大的功能：

正常情況：AI智能回覆（最靈活、最人性化，會自動使用您設定的公司資料）
AI異常/額度用完：自動切換關鍵字回覆（確保服務不中斷）

兩者相輔相成，完美互補！

4. 效能說明

會不會影響網站速度？

A：完全不會！ 小慧同學採用輕量化設計：

前端程式碼小於50KB
非同步載入，不影響頁面讀取速度
所有資源都經過壓縮優化

前台操作說明

開啟對話視窗

點擊右下角對話泡泡圖示

對話框標題

可在後台「基本設定」中自訂標題
例如：「線上店小二」、「客服小幫手」、「有任何問題歡迎詢問」

傳送訊息

在輸入框打字
按「發送」按鈕或 Enter 鍵

語音輸入

點擊麥克風圖示「🎤」
對著麥克風說話
自動轉為文字並發送

語音朗讀

每個機器人回覆旁有「🔊」按鈕
點擊朗讀該則訊息
再次點擊暫停

快速回覆

點擊下方按鈕快速發送常用問題

設定選單

點擊對話框右上角「⚙️」
可「清除所有對話紀錄」

關閉視窗

點擊右上角「✕」

常見問題

Q1：安裝後前台看不到客服視窗？

可能原因與解決方法：

前台顯示開關未開啟
- 前往後台「設定 → 智慧客服用戶端」
- 點擊「基本+角色」頁籤
- 確認「前台顯示開關」有勾選
- 點擊「儲存設定」
強制禁用中
- 檢查是否有啟用強制禁用
- 試用版過期會自動禁用
- 輸入授權碼激活即可恢復

Q2：AI都不回覆怎麼辦？

檢查步驟：

確認API設定正確
- 前往「AI設定」頁籤
- 檢查Gemini API Key是否正確輸入
- 點擊「測試連線」確認連線狀態
檢查API額度
- 免費版每分鐘60次限制
- 若額度用完，系統會自動切換關鍵字回覆
- 可至Google AI Studio查看用量
查看錯誤訊息
- 前往「Debug」頁籤
- 查看最近的錯誤記錄
- 確認錯誤類型（金鑰無效/額度用完/無法連線）

Q3：關鍵字回覆沒有作用？

可能原因：

格式錯誤
- 必須使用 => 分隔（含空格）
- 正確：關鍵字 => 回覆內容
- 錯誤：關鍵字：回覆內容 或 關鍵字=回覆內容
AI模式優先
- 當AI正常運作時，會優先使用AI回覆
- 可暫時關閉AI測試關鍵字是否正常
關鍵字太籠統
- 建議設定多個相關關鍵字
- 用逗號分隔：運費,運費多少,免運門檻

Q4：AI會用我填寫的公司資料回答嗎？

A：會！而且完全自動！

您只需要在後台填寫：

🏢 公司介紹（公司名稱、簡介、產品、服務）
🏠 店家資訊（營業時間、電話、地址、價格表）
🎉 近期活動（活動名稱、說明）

AI就會自動學習這些資料，當客戶詢問相關問題時，會使用您提供的資訊準確回答。完全不需要手動設定關鍵字或撰寫腳本！

Q5：可以同時使用AI和關鍵字嗎？

A：可以！而且強烈建議！ 這是小慧同學最強大的功能：

正常情況：AI智能回覆（最靈活、最人性化，會使用公司資料）
AI異常/額度用完：自動切換關鍵字回覆（確保服務不中斷）

兩者相輔相成，完美互補！

Q6：會不會影響網站速度？

A：完全不會！ 小慧同學採用輕量化設計：

前端程式碼小於50KB
非同步載入，不影響頁面讀取速度
所有資源都經過壓縮優化

Q7：小慧同學收費嗎？為什麼API要收費？

A：小慧同學本身完全免費！

小慧同學外掛：完全免費提供給所有WordPress用戶使用
API費用：是Google Gemini API的費用，由Google直接收取，小慧同學沒有經手任何費用
如果您覺得免費版不夠用，可以前往Google升級付費方案，小慧同學依然免費提供服務

Q8：免費版不夠用怎麼辦？

如果您需要：

更高流量限制（超過每分鐘60次）
更快的回應速度
更強大的AI模型

可以前往 Google AI Studio 升級您的Google帳號至付費方案，小慧同學外掛仍然可以免費使用！

📞 技術支援

遇到問題了嗎？我們隨時在這邊幫你！

項目	聯絡方式
合作諮詢（廣告合作、強強聯手）	小助手
服務與建議	小助手
服務時間	週一至週五 10:00-18:00，國定假日除外
技術客服服務時間	週一至週五 9:00-18:00（國定假日休息）
AI客服	24小時不打烊！ 💪