B7 — 客製化欄位 / 標籤 / Smart List

May 24, 2026

版本 v1.0 · 更新日期 2026-05-24

B7.1 加 Custom Field 的規範

命名

欄位名稱:中文可,例「樣品寄送日期」
fieldKey:必須 snake_case ASCII,例 sample_ship_date。GHL 對中文 name 不會自動生 fieldKey,要在「Settings → Custom Fields → Add field」明確指定。
不要用空白、連字號、中文符號當 fieldKey

dataType 速查表

dataType	用途	注意
`TEXT`	短文字	—
`LARGE_TEXT`	長文字	—
`NUMERICAL`	數字	整數或小數
`MONETORY` ⚠️	金額	GHL 拼錯但要照用(MONETARY 不行)
`DATE`	日期	ISO 格式 yyyy-mm-dd
`SINGLE_OPTIONS`	下拉單選	options 必須是純字串陣列,不是 object
`MULTIPLE_OPTIONS`	下拉多選	同上
`RADIO`	單選圓鈕	—
`CHECKBOX`	布林勾選	—

加欄位 SOP(透過 API)

POST /locations/{locationId}/customFields
Headers: Authorization: Bearer {PIT}, Version: 2021-07-28
Body:
{
  "name": "樣品寄送日期",
  "fieldKey": "sample_ship_date",
  "dataType": "DATE",
  "model": "contact"
}

透過 UI 也可以,在 Settings → Custom Fields → Add field。

B7.2 Tags 管理

規範

GHL 會自動 lowercase ASCII tag(只是顯示,不影響邏輯)
中文 tag 保留原樣大小寫,例 月結客戶、待判定
業務絕對不要在 contact 上加亂七八糟的 tag — 會污染 Smart List 統計

系統使用中的 27 個 tag(2026-05-24)

分類	Tags
身份(主)	`customer` / `b2b` / `b2c` / `lead`
SHOPLINE 來源	`shopline訂單` / `月結客戶`
訂單狀態	`待判定` / `待付款` / `待放行`
客戶等級	`vip客戶` / `信用凍結` / `出貨前付款`
品牌	`品牌_kimino` / `品牌_sc_lab`
Lead 來源	`廣告來源_facebook` / `廣告來源_instagram` / `廣告來源_line`
Lead 狀態歷史	`lead_新進名單` / `lead_已審核符合` / `lead_已審核不符` / `lead_樣品已寄` / `lead_已成交` / `lead_長線培養` / `lead_無效名單`
AR 帳齡歷史	`ar_current` / `ar_overdue_30` / `ar_overdue_60` / `ar_overdue_90plus`

B7.3 Smart List 維護

當前 4 + 1 個 Smart List

Lead — filter: tag=lead — ~941 contacts
AR 月結客戶 — filter: tag=customer — 62 contacts
B2C — filter: tag=b2c — ~281 contacts
B2B — filter: tag=b2b — ~520 contacts
All(預設,無 filter)— ~1,778 contacts

建新 Smart List SOP

Contacts → 點 Add smart list → 輸入名稱
加 Advanced filters → 設條件(可多條 AND/OR)
儲存 → 自動成為 tab
(可選)拖曳 tab 順序

Smart List 規範

用單一 tag篩最穩(條件少不會錯)
業務需要的 Smart List 才建,不要建半天沒人看的
建好通知所有業務,並在第 3 章手冊更新對照表

想刪舊 Smart List?左側選單三點 → Delete。但建議只 archive 不 delete(萬一還有人 bookmark)。

Leo

Back to Blog