接住詢問與名單展開目錄
名單與生意

用資料推送把新名單送進你的系統:建立目的地、驗證簽章到看懂紀錄

想讓網站收到的每一筆表單、預約、訂單與新會員,自動送進自己的 CRM、記帳系統或自動化流程,照這個順序做:在功能開關啟用「資料推送」、新增推送目的地、建立後立刻存好簽章密鑰、送一筆測試、在接收端驗證簽章,最後學會看推送狀態與紀錄。

約 15 分鐘最後複驗:2026-10-04負責維護:Growth Team · Help Center

用資料推送把新名單送進你的系統:建立目的地、驗證簽章到看懂紀錄

繁體中文字幕預設開啟;若和瀏覽器即時字幕重複,可在這裡關閉。

動畫教學片頭:anting.tw 標誌與「用資料推送把新名單送進你的系統」標題。影片附可開關的繁體中文字幕、逐字稿與章節索引,也可以下載 MP4。

完成後你會得到

網站上每出現一筆新的聯絡資料或互動,平台都會帶著簽章把它送到你的網址;你的系統只接受真的來自安庭的請求,送不到時你也知道該修哪裡。

開始前準備

  • 你是網站擁有者或「共同管理者」;「內容編輯」看不到「資料推送」。
  • 準備一個能接收 POST 請求、而且是 https 開頭的接收網址。不會寫程式的話,可以用支援 webhook 的自動化服務接收。

操作步驟

1

第 1 步,共 6 步:在「功能開關」啟用「資料推送」

這個功能預設關閉,也不會出現在「探索更多功能」。到網站後台左側「設定」底下的「網站設定」,往下滑到「功能開關」。

在「網站基本功能與設定」那一組勾選「資料推送」,按最下方的「儲存功能設定」。

用資料推送把新名單送進你的系統:建立目的地、驗證簽章到看懂紀錄:在「功能開關」啟用「資料推送」
網站設定的功能開關中可啟用資料推送;本示範站已啟用。 開啟原尺寸圖片。
完成結果: 畫面顯示「已儲存功能設定」,側欄的「設定」底下多了「資料推送」。
2

第 2 步,共 6 步:按「新增推送目的地」,填名稱、網址與事件

打開「資料推送」,按「新增推送目的地」。

在「名稱」填一個看得懂的名字,例如「同步到我的 CRM」;在「接收網址」貼上 https 開頭的網址。

「要推送哪些事件」預設兩種都勾:「第一次留下聯絡資料」是同一個人第一次透過表單、預約、下單或註冊會員出現;「既有聯絡人的新互動」是已經在名單裡的人又送了表單、又預約或又下單。至少要留一種。

用資料推送把新名單送進你的系統:建立目的地、驗證簽章到看懂紀錄:按「新增推送目的地」,填名稱、網址與事件
按「新增推送目的地」,填名稱、網址與事件:操作位置與畫面範例。 開啟原尺寸圖片。
網址必須是 https,而且要是公開網際網路連得到的位址;localhost、10.x、192.168.x 這類內部網址會被拒絕。
完成結果: 名稱、接收網址都填好,至少勾一種事件。
3

第 3 步,共 6 步:按「建立」,立刻把簽章密鑰存好

按「建立」。綠色訊息會寫著「已建立。請把下面的簽章密鑰存到你的系統裡 —— 它只完整顯示這一次。」,下面是一串 whsec_ 開頭的密鑰。

立刻把它複製到你接收端的設定裡,或存進密碼管理器。

離開這一頁之後就看不到這把密鑰,平台也找不回來。沒存到就按卡片上的「換發密鑰」產生新的,再更新到接收端。
完成結果: 推送目的地出現在清單上,狀態是「運作中」,密鑰已經存在你的系統裡。
4

第 4 步,共 6 步:按「送一筆測試」,確認你的系統收得到

在目的地卡片上按「送一筆測試」。

看到「測試推送成功:收到 HTTP 200」之類的訊息,就代表你的系統收到了;看到「測試推送失敗:」,後面會接著 HTTP 狀態碼或錯誤原因,先修好接收端。

用資料推送把新名單送進你的系統:建立目的地、驗證簽章到看懂紀錄:按「送一筆測試」,確認你的系統收得到
按「送一筆測試」,確認你的系統收得到:操作位置與畫面範例。 開啟原尺寸圖片。
測試這一筆不會出現在「最近的推送紀錄」,要看結果請看按鈕下方的訊息。
完成結果: 卡片下方顯示「測試推送成功」。
5

第 5 步,共 6 步:在接收端驗證簽章

每一筆推送都帶著 x-anting-signature 標頭,格式是 t=<時間戳>,v1=<簽章>;同一個時間戳也放在 x-anting-timestamp。

用你的密鑰,對「時間戳.原始請求內容」計算 HMAC-SHA256(十六進位),和 v1 比對;相同才是安庭送的。再檢查時間戳夠新,太舊的請求一樣拒絕。

驗證通過後,回應 HTTP 200~299 的狀態碼。

要用收到的原始內容計算,不能先把 JSON 解析再組回去,差一個空白簽章就對不上。
接收端回轉址(例如 301)時平台不會跟著轉,這筆會直接記為失敗;回應超過 8 秒也算失敗。
完成結果: 偽造或重放的請求會被你的系統擋下,真的推送回應 2xx。
6

第 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 個程式或介面來源重播核對。內容說明安庭產品當下可操作流程;第三方平台、法規與價格請回到各自最新官方頁,本文不取代帳務、法律或資安專業判斷。

發現介面或步驟不同?請從關於安庭與聯絡方式回報,我們會重新驗證。

相關操作說明

還是沒解決?

依你看到的狀況查一次問題排除,通常比找功能名稱快。真的卡住就直接告訴我們,把你正在做的事和畫面上的訊息寫進來就好。