# Meow Walk - Apps Script Setup

## 1) 建立 Google Sheet
1. 建一份新 Google Sheet（例如：`MeowOrders`）。
2. 開啟 `Extensions -> Apps Script`。

## 2) 貼上腳本
1. 把 `apps-script/Code.gs` 全部貼到 Apps Script 編輯器。
2. 如果需要安全驗證，可設定：
   - `WEBHOOK_TOKEN = '你的密鑰'`

## 3) 部署成 Web App
1. 點 `Deploy -> New deployment`。
2. Type 選 `Web app`。
3. Execute as: `Me`。
4. Who has access: `Anyone`（或你可用的範圍）。
5. 部署後複製 Web App URL（會是 `/exec` 結尾）。

## 4) 回到網站填設定
在網站管理模式的「代購 -> Email 自動通知設定」中填入：
- Apps Script Web App URL
- Webhook Token（若你有設定）

儲存後可使用兩種雲端流程：
- 訪客送出「購買需求」：把訂單寫進 `Orders` 分頁並寄通知到你的 Gmail。
- 代購區「送出到雲端」：把報價單寫進 `Orders` 分頁並寄通知。
- 聯絡表單「寄出聯絡信」：把表單寫進 `Contacts` 分頁並寄通知。

## 5) 驗證
- 訪客購買需求送出成功時，網站會顯示「購買需求已送出」。
- Sheet 的 `Orders` 分頁會新增一列，包含：
  - 類型（`purchase_intent` 或 `order`）
  - 聯絡人
  - 電話
  - 聯絡方式類型
  - 聯絡方式內容
  - 商品明細與完整 JSON
- 若有填 `siteEmail`，Apps Script 會自動寄 Gmail 通知信。
- 聯絡表單送出後，`Contacts` 分頁會新增一列並寄合作聯絡信。

## 訪客購買信內容
收到的 Gmail 會包含：
- 報價單號
- 類型（訪客購買需求 / 管理報價單）
- 聯絡人
- 電話
- 聯絡方式
- 備註
- 商品明細
- 商品總額 / 代購費 / 國內運費 / 總金額

## 常見問題
- `Unauthorized token`: 網站與 `WEBHOOK_TOKEN` 不一致。
- `Items are required`: 報價清單是空的。
- `buyer.phone is required`: 訪客購買表單沒有填電話。
- `buyer.contact is required`: 訪客購買表單沒有填聯絡方式內容。
- `fromEmail is invalid` / `toEmail is invalid`: 聯絡表單 email 格式不正確。
- 部署後沒反應：請確認網址是 `/exec` 不是 `/dev`。
- 更新程式碼後要重新部署新版本，或在 deployment 裡更新版本。