帳號、權限與網站設定目前可使用
資料推送
站上收到表單、預約、訂單或新會員時，自動把那筆資料送到你指定的網址。
共 1 項操作・5 個步驟・最後複驗 2026-09-17
從哪裡進入
網站後台 → 資料推送
照著下方圖文逐步完成
重點摘要（TL;DR）
每筆事件都會帶簽章 POST 到你設定的接收網址，讓你接進自己的 CRM、記帳系統、Slack 或自動化流程；送不出去會自動重試五次，最久到六小時後。
什麼時候會用到
- 你有自己的系統（CRM、記帳、客服）要即時收到站上的新名單或新訂單
- 想把表單與預約接進自動化流程，不必有人一直看後台
開始前先準備
- • 你要有一個能接收 POST 請求的網址，而且必須是 https
- • 這個功能預設關閉，要先在網站設定裡啟用
操作步驟與完成後的結果
每一項操作都列出從哪裡開始、要做什麼，以及完成後應該看到的結果。
1
新增一個推送目的地
建立一個推送目的地並確認你的系統真的收得到 —— 之後站上每筆新名單都會自動送過去。
- 1
這一步要做
到網站後台的「網站設定」，先在功能開關裡啟用「資料推送」。
完成後會看到
側欄的設定群組出現「資料推送」。
- 2
這一步要做
打開「資料推送」，點「新增推送目的地」。
完成後會看到
出現名稱、接收網址與事件勾選的表單。
- 3
這一步要做
填一個看得懂的名稱（例如「同步到我的 CRM」），貼上 https 開頭的接收網址，勾選要推送哪些事件。
完成後會看到
至少勾一種事件，否則不會有任何推送。
- 4
這一步要做
點「建立」，把畫面上顯示的簽章密鑰複製到你的系統裡。
完成後會看到
密鑰只完整顯示這一次；之後只能換發新的，看不到舊的。
- 5
這一步要做
點「送一筆測試」確認你的系統真的收得到。
完成後會看到
顯示「測試推送成功：收到 HTTP 200」之類的結果；失敗時會直接把錯誤訊息端出來。
注意事項
- • 測試推送不會寫進推送紀錄 —— 那張表只記真實的顧客事件。
- • 推送內容含顧客個資，接收網址只接受 https。
遇到問題先看這裡
- 網址存不進去，說「不接受指向內部網路或本機的網址」？
- 接收網址必須是公開網際網路連得到的位址。localhost、10.x、192.168.x、169.254.x 這類只在內部網路有效的位址一律不接受 —— 平台是從自己的伺服器送出這筆請求的，不是從你的電腦。本機開發請先用可對外的測試網址（例如 webhook 測試服務或內網穿透工具）。
- 推送一直失敗，後台顯示「連續失敗」？
- 先按「送一筆測試」看錯誤訊息。HTTP 4xx 表示你的系統收到了但拒絕（通常是路徑錯或驗章失敗），這種不會重試；5xx 與連線逾時會自動重試五次。驗章失敗最常見的原因是換發過密鑰但接收端還用舊的。
- 怎麼確認這筆請求真的來自安庭？
- 每筆推送都帶 x-anting-signature 標頭，格式是 t=<時間戳>,v1=<簽章>。用你的密鑰對「時間戳.請求內容」算 HMAC-SHA256，比對 v1 是否相同；同時檢查時間戳夠新，就能擋掉別人重放舊請求。
- 換發密鑰之後會怎樣？
- 舊密鑰立刻失效。在你把新密鑰更新到接收端之前，推送會一直驗章失敗，所以請安排在你能馬上更新的時候換。
- 推送會帶顧客的個資嗎？
- 會 —— 內容包含顧客的姓名、Email 與電話，也就是你在後台名單裡看得到的同一筆。所以接收網址只能是 https，而且請確認你自己的系統有妥善保管這些資料。
- 會推送訂單狀態變更或文章發佈嗎？
- 目前只有兩種事件：有人第一次留下聯絡資料、以及名單上已有的人又有新互動（送表單、預約、下單、註冊會員）。出貨、退款、內容發佈還沒有對應的事件。