B3 — Pipeline / Stage 維護
業務絕對不要碰 Pipeline 設定。改 pipeline 結構 = 改 stage_id = 既有所有 workflow 觸發條件可能失效。動之前先看 §B3.3。
B3.1 兩條 Pipeline 結構
| Pipeline | ID | 階段數 | 對應 workflow |
|---|---|---|---|
| Lead Pipeline | kXZF66fCJmQkI79O3zB0 | 11(主流程 7 + 分支 4) | #06 / #07 / #08 / #09 |
| 應收帳款 AR Tracker | h9PQ834vPKh9WQDRRQp3 | 7(帳齡 5 + 結案 2) | #01-#05 + n8n Flow 3 |
B3.2 GHL Pipeline 設定 PIT 進不去
PIT token 沒有 pipeline CRUD scope(memory: ❌ pipeline CRUD UI only)。所有 pipeline 結構修改必須走 UI:
路徑:Settings → Opportunities & Pipelines
B3.3 改 Pipeline 結構的注意事項
不能做的事
- ❌ 刪掉現有 stage(會造成在該 stage 的所有 opp 變孤兒)
- ❌ 重命名 stage 後沒同步更新 workflow trigger
- ❌ 改 stage 順序 — 視覺順序變,但 stage_id 沒變,自動化邏輯仍正確
新增 stage 的 SOP
- UI 加 stage,記下生成的 stage_id(從 URL 或 API
GET /opportunities/pipelines看) - 檢查是否需要新的 workflow 或修改現有 workflow trigger
- 如果是 AR Tracker 加帳齡階段 → 同步改 n8n Flow 3 的帳齡 bucket 邏輯
- 更新本手冊 第 4 章 或 第 5 章 的階段表
重命名 stage(只改顯示名,不影響邏輯)
- UI 改名 → stage_id 不變 → workflow trigger 不受影響
- 更新本手冊與 cheat sheet 的階段表
刪 stage 的 SOP(高風險)
- 先移走所有該 stage 的卡片(到其他 stage 或 archive)
- 檢查是否有 workflow 以該 stage_id 為 trigger,若有先停用或改 trigger
- UI 刪除
- API 確認:
GET /opportunities/pipelines看新結構
圖 B3 — AR Tracker pipeline 7 階段
B3.4 與 PIT 相關的 scope 限制
| 操作 | PIT 能做嗎 |
|---|---|
| 讀 pipeline 結構 | ✅ GET /opportunities/pipelines |
| 建 opportunity | ✅ POST /opportunities/ |
| 移 opportunity 階段 | ✅ PUT /opportunities/{id} with pipelineStageId |
| 建/改 pipeline | ❌ UI only |
| 建/改 stage | ❌ UI only |
| 建 location-level setting | ❌ location.write scope missing |
