常見問題

行銷事件

測試事件發送失敗？

1. 確認 Webhook URL 為 HTTPS 且 CRM 端可從外網連線
2. 檢查 CRM 是否回傳非 2xx 狀態碼
3. 查看設定頁 最近推送狀態 的錯誤訊息
4. 若使用簽章，確認 CRM 驗證邏輯與 FLOD 的 X-FLOD-Signature 一致

實際消費後 CRM 沒收到事件？

1. 確認 啟用 CRM 事件推送 已開啟
2. 確認 Webhook URL 已儲存
3. purchase.completed 在結帳確認成功後推送；若結帳未完成則不會送
4. 推送失敗不影響 FLOD 內的消費紀錄

purchase.completed 有包含商品嗎？

有。療程購買與商品購買都會出現在 items 陣列，以 type 區分 treatment 與 good。

Intake API

API 回 401 Unauthorized？

• Header 須為 Authorization: Bearer {金鑰}（注意 Bearer 後有空格）
• 金鑰是否已重新產生（舊金鑰會失效）
• 金鑰是否屬於正確診所 location

同一 external_id 重送會建立兩筆嗎？

不會。FLOD 依 external_id（預約意圖去重）回傳既有 pending 的 reservation_id，並帶上該顧客的 flod_id、patient_id、external_patient_id。

external_id 跟 external_patient_id 要填一樣的嗎？

通常不必。external_id 是這一筆預約意圖；external_patient_id 是這位顧客在 CRM 的主檔編號。同一位顧客多次預約，顧客編號可相同，每次意圖的 external_id 應不同。

回應裡的 patient_id 是什麼？

是診所「顧客編號」，可能是空字串。FLOD 顧客系統 ID 請看 flod_id。詳見 Intake API。

Pending 預約為什麼不在日曆上？

Pending 狀態刻意不佔時段。櫃台需在 預約 → 待安排 排入日曆後才會出現在日曆與今日預約。

API 金鑰遺失怎麼辦？

在設定頁按 重新產生 API 金鑰。新金鑰僅顯示一次，請立即複製保存並更新外部系統設定。

與 CRM 的分工

FLOD 不會：

• 同步 CRM 的 lead 或標籤到 FLOD
• 在 FLOD 內建分眾或行銷活動工具
• 取代 CRM 的顧客接觸紀錄
• 代替 PRM 原廠做 官方雙邊串接（診所填設定 ≠ 原廠內建接入）

FLOD 會：

• 在營運事件發生時推送摘要供 CRM 分眾（需 接收端 已就緒）
• 接收外部預約意圖至待安排佇列

我們用大型 PRM，要請原廠客製串接 FLOD？

通常 不是 這條自助整合能解決的。請先讀 開始前：適用情境與整合方式。

重點：

• FLOD 提供 Webhook + Intake，由診所或 代操 設定與維護
• 大型 PRM 的資料多半來自 病歷串接、LINE 行為、人工／CSV，不會因開 FLOD 設定就自動同步
• 若需要 PRM 產品內 官方支援，屬 原廠對原廠 合作，與設定頁自助接口不同

填了 Webhook URL，PRM 後台沒收到？

1. 確認 URL 是 接收 POST 的服務，不是 PRM 登入頁或後台首頁
2. 大型 PRM 常 沒有「貼第三方 Webhook」欄位 → 需 代操、Make／n8n 或自建 receiver
3. 詳見 開始前 的「誰適合直接用」一節