用資料推送把新名單送進你的系統:建立目的地、驗證簽章到看懂紀錄
想讓網站收到的每一筆表單、預約、訂單與新會員,自動送進自己的 CRM、記帳系統或自動化流程,照這個順序做:在功能開關啟用「資料推送」、新增推送目的地、建立後立刻存好簽章密鑰、送一筆測試、在接收端驗證簽章,最後學會看推送狀態與紀錄。
用資料推送把新名單送進你的系統:建立目的地、驗證簽章到看懂紀錄
完成後你會得到
網站上每出現一筆新的聯絡資料或互動,平台都會帶著簽章把它送到你的網址;你的系統只接受真的來自安庭的請求,送不到時你也知道該修哪裡。
開始前準備
- 你是網站擁有者或「共同管理者」;「內容編輯」看不到「資料推送」。
- 準備一個能接收 POST 請求、而且是 https 開頭的接收網址。不會寫程式的話,可以用支援 webhook 的自動化服務接收。
操作步驟
第 1 步,共 6 步:在「功能開關」啟用「資料推送」
這個功能預設關閉,也不會出現在「探索更多功能」。到網站後台左側「設定」底下的「網站設定」,往下滑到「功能開關」。
在「網站基本功能與設定」那一組勾選「資料推送」,按最下方的「儲存功能設定」。

第 2 步,共 6 步:按「新增推送目的地」,填名稱、網址與事件
打開「資料推送」,按「新增推送目的地」。
在「名稱」填一個看得懂的名字,例如「同步到我的 CRM」;在「接收網址」貼上 https 開頭的網址。
「要推送哪些事件」預設兩種都勾:「第一次留下聯絡資料」是同一個人第一次透過表單、預約、下單或註冊會員出現;「既有聯絡人的新互動」是已經在名單裡的人又送了表單、又預約或又下單。至少要留一種。

第 3 步,共 6 步:按「建立」,立刻把簽章密鑰存好
按「建立」。綠色訊息會寫著「已建立。請把下面的簽章密鑰存到你的系統裡 —— 它只完整顯示這一次。」,下面是一串 whsec_ 開頭的密鑰。
立刻把它複製到你接收端的設定裡,或存進密碼管理器。
第 4 步,共 6 步:按「送一筆測試」,確認你的系統收得到
在目的地卡片上按「送一筆測試」。
看到「測試推送成功:收到 HTTP 200」之類的訊息,就代表你的系統收到了;看到「測試推送失敗:」,後面會接著 HTTP 狀態碼或錯誤原因,先修好接收端。

第 5 步,共 6 步:在接收端驗證簽章
每一筆推送都帶著 x-anting-signature 標頭,格式是 t=<時間戳>,v1=<簽章>;同一個時間戳也放在 x-anting-timestamp。
用你的密鑰,對「時間戳.原始請求內容」計算 HMAC-SHA256(十六進位),和 v1 比對;相同才是安庭送的。再檢查時間戳夠新,太舊的請求一樣拒絕。
驗證通過後,回應 HTTP 200~299 的狀態碼。
第 6 步,共 6 步:看懂推送狀態與「最近的推送紀錄」
每個目的地右上角會顯示「運作中」「連續失敗」或「已停用」;連續失敗 3 次以上時,卡片會列出最近一次的錯誤原因。
往下看「最近的推送紀錄」,每一列有時間、事件、結果與說明。結果是「成功」「重試中(第 N 次)」「已放棄」或「失敗」。
對方暫時連不上時會自動再試,間隔依序是 5 分鐘、30 分鐘、2 小時、6 小時,一筆最多送五次;第五次仍失敗就是「已放棄」,那一筆要你自己從後台名單補進接收端。
暫時不想推送按「停用」,懷疑密鑰外流按「換發密鑰」,確定不用了按「刪除」。

常見問題
- 按「建立」後出現「網址必須是 https:// 開頭」或「不接受指向內部網路或本機的網址」
- 接收網址要是 https,而且是公開網際網路連得到的位址。平台是從自己的伺服器送出請求,不是從你的電腦;本機開發請先用可對外的測試網址。
- 後台顯示「連續失敗」
- 先按「送一筆測試」看錯誤訊息。HTTP 4xx(408、429 除外)表示你的系統收到了但拒絕,通常是路徑錯或驗章失敗,不會重試;5xx、408、429 與逾時會自動再試。
- 推送紀錄的說明欄出現 HTTP 301 或 302
- 接收網址回了轉址,平台不會跟著轉。按「編輯」把網址改成轉址後的最終網址,再「送一筆測試」。
- 建立後忘了複製密鑰
- 密鑰只完整顯示一次。按卡片上的「換發密鑰」產生新的,立刻更新到接收端。
- 側欄找不到「資料推送」
- 到「網站設定」的「功能開關」,在「網站基本功能與設定」勾選「資料推送」並儲存。「內容編輯」層級看不到這一頁,請網站擁有者或共同管理者設定。
這篇如何保持正確
- 負責人
- Growth Team · Help Center
- 複驗節奏
- 最後複驗 2026-10-04;下次應於 2026-11-13 前完成
- 驗證依據與邊界
- 本文依 8 個程式或介面來源重播核對。內容說明安庭產品當下可操作流程;第三方平台、法規與價格請回到各自最新官方頁,本文不取代帳務、法律或資安專業判斷。
發現介面或步驟不同?請從關於安庭與聯絡方式回報,我們會重新驗證。
