客人:打開 WhatsApp/Telegram,直接問一句就得。
唔使學功能表;想掣嘅打「選單」。商戶喺 控制台 改行業同 三選一 AI。
同一套接待流程,差在 錢、地區、技術門檻。可列印或轉傳 demo/AI_PROVIDER_COMPARISON_ZH.md。
| 方案 | 最適合 | 成本(約) | 地區/帳戶 | 要準備 |
|---|---|---|---|---|
| A. OpenAI 官方 | 要穩定、模型新、接受官方計費 | 按用量(見官網定價) | 視 OpenAI 政策;香港常走企業/Azure | .env 嘅 OPENAI_API_KEY;可選 OPENAI_BASE_URL |
| B. 相容 API | 官方難申請;要 DeepSeek/OpenRouter 等 | 各平台自有定價 | 一般較易開戶(以平台為準) | 控制台 ④ 填 Base URL/模型;Key 可表單或 ③ 帳戶與連線 |
| C. 本機 Ollama | 零雲端 API 費、資料留本機、試用 | API 費 $0(電費/硬件另計) | 唔經 OpenAI/Groq 雲端限制 | 裝 Ollama、ollama pull;控制台選 Ollama |
點揀:省心肯比錢 → A;平/易開 API → B;免費、私隱 → C(要自己顧部機)。
以下為對外託管參考價(HK$);自建本專案則只需付通道+你所選 AI 供應商用量。
data/*.jsonl。快捷字(兩邊一樣):選單 狀態 說明 行業 重設行業 · 「狀態」會顯示而家用緊邊個 AI。Telegram 亦可用按鈕同 /industry。
開波前(IT/同事一次)
npm install。.env.example → .env:至少 OpenAI Key(或先手動設 Ollama 設定檔)+ Telegram 或 WhatsApp。README.md。WEB_ADMIN_TOKEN、WHATSAPP_APP_SECRET。日常(打開 控制台)
WEB_ADMIN_TOKEN;瀏覽器會記住工作階段(登出請撳控制台內「登出」)。.env)。.env 嘅 AI_PROVIDER_MODE 等)。失靈時客人點搵人 → demo/PICKUP_RESILIENCE.md;合規 → demo/LEGAL_AND_COMPLIANCE_GUIDE_ZH.md。
由零開始唔識 set up? 逐步教學(.env、TG/WA、AI 三模式、驗證)→ demo/SETUP_TUTORIAL_DETAILED_ZH.md
商戶版(服務商已代裝): demo/CUSTOMER_MERCHANT_GUIDE_ZH.md
GTM/採購補強(一至五點):demo/HOSTED_DEPLOY_SOP_ZH.md · demo/IPAAS_GOLDEN_RECIPES_ZH.md · demo/LOAD_TEST_POC_ZH.md(npm run loadtest:k6-smoke)· demo/AUTOMATION_VS_BPMN_ZH.md · demo/PROCUREMENT_COMPLIANCE_BRIEF_ZH.md
治理+SLO 邊界(C/F/K、維度 D):demo/GOVERNANCE_SLO_WORKFLOW_ZH.md · 控制台 SLO/治理(要管理密鑰)。
GTM 對照(非第三方排名):demo/COMPETITOR_SCORECARD_50_ZH.md(文末「五、延伸」匯總上文檔同 /admin/connectors、/admin/usage 等)。
選單 → 三掣:行業、狀態、說明。WHATSAPP_MARK_READ)、打字中、非文字附件唔靜默;首次歡迎/快捷清單持久化(重啟唔會亂發)。示範程式唔取代正式服務條款或私隱政策。上線前請睇 repo 內 demo/LEGAL_AND_COMPLIANCE_GUIDE_ZH.md(非法律意見)、demo/MERCHANT_CUSTOMER_FAQ.md;可設 env CUSTOMER_REPLY_DISCLAIMER_FOOTER 於每一則 AI 回覆尾(含 FAQ)加店方/律師審定短句。驚死火 pickup 唔到→ demo/PICKUP_RESILIENCE.md(MERCHANT_PUBLIC_CONTACT_LINE、OPS_ALERT_WEBHOOK_URL)。
醫療/法律/金融等務必轉真人並跟行業指引。
/webhook/whatsapp · LINE /webhook/line · WX /webhook/wechat · MS /webhook/messenger · IG /webhook/instagram · TH /webhook/threads · WA 建議 WHATSAPP_APP_SECRET;Meta MS/IG/TH 建議設 App Secret(TH 可用 THREADS_APP_SECRET 或共用 Messenger)· 代理後 TRUST_PROXY=1data/booked-slots.json;提醒可選 BOOKING_REMINDER_ENABLEDREADME.md、demo/MULTI_CHANNEL_TIME_DEDUPE.md、demo/OPS_MONITORING_CHECKLIST.mddemo/LOAD_TEST_POC_ZH.md · npm run loadtest:k6-smoke(須裝 k6 並設 TARGET_URL)demo/IPAAS_GOLDEN_RECIPES_ZH.md · 控制台 CRM 連接示範用假資料;實際以店方為準。敏感行業請轉真人。