資料推送
站上收到表單、預約、訂單或新會員時，自動把那筆資料送到你指定的網址。
共 4 項操作・17 個步驟・最後複驗 2026-10-03
從哪裡進入
網站後台 → 資料推送
照著下方圖文逐步完成
重點摘要（TL;DR）
每筆事件都會帶簽章 POST 到你設定的接收網址，讓你接進自己的 CRM、記帳系統、Slack 或自動化流程；對方暫時連不上時會自動再試，間隔依序拉長到 6 小時，最多送五次。
什麼時候會用到
- 你有自己的系統（CRM、記帳、客服）要即時收到站上的新名單或新訂單
- 想把表單與預約接進自動化流程，不必有人一直看後台
開始前先準備
- • 你要有一個能接收 POST 請求的網址，而且必須是 https
- • 這個功能預設關閉，要先在「網站設定」的「功能開關」（「網站基本功能與設定」那一組）啟用「資料推送」；它不會出現在「探索更多功能」
- • 接收端要能用簽章密鑰驗證請求；不會寫程式的話，可以用支援 webhook 的自動化服務接收
第一次設定，照這個順序做
共 3 站。每一站都連到詳細步驟，做完一站再往下。
操作步驟與完成後的結果
每一項操作都列出從哪裡開始、要做什麼，以及完成後應該看到的結果。
新增一個推送目的地
建立一個推送目的地並確認你的系統真的收得到 —— 之後站上每筆新名單都會自動送過去。
用資料推送把新名單送進你的系統：建立目的地、驗證簽章到看懂紀錄
- 1
這一步要做
到「網站設定」的「功能開關」，在「網站基本功能與設定」那一組勾選「資料推送」，按「儲存功能設定」。
為什麼：這個功能預設關閉：推送會把顧客的姓名、Email 與電話送到站外，所以要由你主動開啟。
完成後會看到
側欄的設定群組出現「資料推送」。
- 2
這一步要做
打開「資料推送」，點「新增推送目的地」。
為什麼：一個推送目的地＝一個接收網址；要同時送到兩個系統，就新增兩個目的地。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
出現名稱、接收網址與事件勾選的表單。 - 2操作
- 位置：
- 畫面上的「新增推送目的地」。
- 動作：
- 打開「資料推送」，點「新增推送目的地」。
- 結果：
- 出現名稱、接收網址與事件勾選的表單。
完成後會看到
出現名稱、接收網址與事件勾選的表單。
- 3
這一步要做
填一個看得懂的名稱（例如「同步到我的 CRM」），貼上 https 開頭的接收網址，勾選要推送哪些事件。
為什麼：名稱只給你自己辨認；網址決定資料送到哪裡；事件決定哪些情況要送。
欄位怎麼填
- 名稱
- 寫用途，例如「同步到我的 CRM」「通知 Slack 頻道」。不能留空。
- 接收網址
- 貼上接收端給你的完整網址，必須 https:// 開頭、而且是公開網路連得到的位址；localhost、10.x、192.168.x 這類內部位址不接受。
- 要推送哪些事件
- 「第一次留下聯絡資料」＝新客人；「既有聯絡人的新互動」＝名單上的人又送表單、預約或下單。預設兩個都勾，至少要勾一個。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
至少勾一種事件，否則不會有任何推送。 - 3操作
- 位置：
- 畫面上的「接收網址」。
- 動作：
- 填一個看得懂的名稱（例如「同步到我的 CRM」），貼上 https 開頭的接收網址，勾選要推送哪些事件。
- 結果：
- 至少勾一種事件，否則不會有任何推送。
完成後會看到
至少勾一種事件，否則不會有任何推送。
做錯或略過會怎樣
網址或事件不合格時按「建立」會顯示原因，例如「網址必須是 https:// 開頭」或「至少要勾選一種事件，否則不會有任何推送。」，修正後再建立。
- 4
這一步要做
點「建立」，把畫面上顯示的簽章密鑰複製到你的系統裡。
為什麼：接收端要用這把密鑰驗證請求真的來自安庭，擋掉別人冒充送來的假資料。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
密鑰只完整顯示這一次；之後只能換發新的，看不到舊的。 - 4操作
- 位置：
- 畫面上的「建立」。
- 動作：
- 點「建立」，把畫面上顯示的簽章密鑰複製到你的系統裡。
- 結果：
- 密鑰只完整顯示這一次；之後只能換發新的，看不到舊的。
完成後會看到
密鑰只完整顯示這一次；之後只能換發新的，看不到舊的。
做錯或略過會怎樣
密鑰只完整顯示這一次。沒複製到就只能按「換發密鑰」產生新的，再更新到接收端。
- 5
這一步要做
點「送一筆測試」確認你的系統真的收得到。
為什麼：測試推送會送一筆標明「這是一筆測試推送，不是真實的顧客資料。」的假資料，讓你在真的客人出現前先確認接線。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
顯示「測試推送成功：收到 HTTP 200」之類的結果；失敗時會直接把錯誤訊息端出來。 - 5操作
- 位置：
- 畫面上的「送一筆測試」。
- 動作：
- 點「送一筆測試」確認你的系統真的收得到。
- 結果：
- 顯示「測試推送成功：收到 HTTP 200」之類的結果；失敗時會直接把錯誤訊息端出來。
完成後會看到
顯示「測試推送成功：收到 HTTP 200」之類的結果；失敗時會直接把錯誤訊息端出來。
做錯或略過會怎樣
看到「測試推送失敗」時，訊息會帶 HTTP 狀態碼或錯誤原因；先修好接收端，否則真實的推送也會失敗。
注意事項
- • 測試推送不會寫進推送紀錄 —— 那張表只記真實的顧客事件。
- • 推送內容含顧客個資，接收網址只接受 https。
在接收端驗證簽章
你的系統只接受真的來自安庭的推送，別人偽造或重放的請求會被擋下。
- 6
這一步要做
在接收端讀取請求標頭 x-anting-signature，格式是 t=<時間戳>,v1=<簽章>；同一個時間戳也會放在 x-anting-timestamp。
為什麼：簽章證明請求是用你的密鑰簽的；時間戳讓你判斷這是不是很久以前被截下來重送的舊請求。
完成後會看到
取得時間戳與簽章兩個值。
- 7
這一步要做
用你的密鑰，對「時間戳.原始請求內容」計算 HMAC-SHA256（十六進位），和 v1 比對是否相同。
為什麼：這和 Stripe、GitHub 的簽章做法相同，接收端常常已經有現成的驗證程式可以套用。
完成後會看到
相同就是安庭送的；不同就拒絕這筆請求。
做錯或略過會怎樣
要用收到的原始內容計算，不能先把 JSON 解析再重新組回去；格式只要差一個空白，簽章就對不上。
- 8
這一步要做
再檢查時間戳和現在的時間差距夠小，太舊的請求一樣拒絕。
為什麼：就算有人截到一筆真的請求，也沒辦法過了很久再拿來重送。
完成後會看到
只有新簽出來的請求會被接受。
- 9
這一步要做
驗證通過後回應 HTTP 200～299 的狀態碼。
為什麼：平台只把 2xx 當成送達；其他狀態碼都會記為失敗。
完成後會看到
推送紀錄顯示「成功」。
做錯或略過會怎樣
接收端回轉址（例如 301）時，平台不會跟著轉，這筆會直接記為失敗；網址請填最終的那一個。回應超過 8 秒也算失敗。
注意事項
- • 推送內容是 JSON，包含事件編號、事件類型、發生時間、來源、摘要、顧客聯絡資料，以及客人填寫或預約的內容明細。
查看推送紀錄與處理失敗
知道每筆推送有沒有送到，送不到時知道該修哪裡。
- 10
這一步要做
在「資料推送」頁看每個目的地右上角的狀態：「運作中」「連續失敗」或「已停用」。
為什麼：這是最快發現接收端壞掉的地方，不必等到發現 CRM 少了名單。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
連續失敗 3 次以上時顯示「連續失敗」，並列出最近一次的錯誤原因。 - 10核對
- 位置：
- 畫面上的「運作中」。
- 動作：
- 在「資料推送」頁看每個目的地右上角的狀態：「運作中」「連續失敗」或「已停用」。
- 結果：
- 連續失敗 3 次以上時顯示「連續失敗」，並列出最近一次的錯誤原因。
完成後會看到
連續失敗 3 次以上時顯示「連續失敗」，並列出最近一次的錯誤原因。
- 11
這一步要做
往下看「最近的推送紀錄」，每一列有時間、事件、結果與說明。
為什麼：這裡只列真實顧客事件的最近 20 筆，用來判斷是偶發還是一直失敗。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
結果會是「成功」「重試中（第 N 次）」「已放棄」或「失敗」；說明欄顯示錯誤訊息或 HTTP 狀態碼。 - 11核對
- 位置：
- 畫面上的「最近的推送紀錄」。
- 動作：
- 往下看「最近的推送紀錄」，每一列有時間、事件、結果與說明。
- 結果：
- 結果會是「成功」「重試中（第 N 次）」「已放棄」或「失敗」；說明欄顯示錯誤訊息或 HTTP 狀態碼。
完成後會看到
結果會是「成功」「重試中（第 N 次）」「已放棄」或「失敗」；說明欄顯示錯誤訊息或 HTTP 狀態碼。
做錯或略過會怎樣
「送一筆測試」不會出現在這張表裡，要看測試結果請看按鈕下方的訊息。
- 12
這一步要做
依說明欄判斷：HTTP 5xx、408、429 或「timeout」會自動再試；其他 4xx 表示接收端拒絕，不會重試，要去修接收端。
為什麼：接收端暫時掛掉時，平台會替你補送；但接收端明確拒絕時，重送一模一樣的內容也不會有不同結果。
完成後會看到
會重試的那幾筆顯示「重試中」，依序在 5 分鐘、30 分鐘、2 小時、6 小時後再送。
做錯或略過會怎樣
第五次仍失敗就顯示「已放棄」，那一筆不會再送，需要你從後台名單手動補進接收端。
- 13
這一步要做
修好接收端後，按該目的地的「送一筆測試」，確認回到成功。
為什麼：先用測試確認，比等下一位真實客人出現再看結果快。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
顯示「測試推送成功：收到 HTTP 200」之類的訊息；下一筆真實推送成功後，狀態會回到「運作中」。 - 13操作
- 位置：
- 畫面上的「送一筆測試」。
- 動作：
- 修好接收端後，按該目的地的「送一筆測試」，確認回到成功。
- 結果：
- 顯示「測試推送成功：收到 HTTP 200」之類的訊息；下一筆真實推送成功後，狀態會回到「運作中」。
完成後會看到
顯示「測試推送成功：收到 HTTP 200」之類的訊息；下一筆真實推送成功後，狀態會回到「運作中」。
修改、停用、換發密鑰或刪除目的地
調整推送設定，或在接收端更換、停用時安全地停止推送。
- 14
這一步要做
要改名稱、網址或事件，按目的地卡片上的「編輯」，修改後按「儲存」。
為什麼：接收端換網址時直接改這裡，不必重建目的地，密鑰也維持不變。
欄位怎麼填
- 名稱
- 不能留空。
- 接收網址
- 同樣必須 https:// 開頭、公開網路連得到。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
顯示「已儲存。」，卡片上的「推送事件」跟著更新。 - 14操作
- 位置：
- 畫面上的「編輯」。
- 動作：
- 要改名稱、網址或事件，按目的地卡片上的「編輯」，修改後按「儲存」。
- 結果：
- 顯示「已儲存。」，卡片上的「推送事件」跟著更新。
完成後會看到
顯示「已儲存。」，卡片上的「推送事件」跟著更新。
- 15
這一步要做
暫時不要推送時按「停用」；要恢復時按「啟用」。
為什麼：停用保留所有設定與密鑰，適合接收端維修期間。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
顯示「已停用，不會再推送。」或「已啟用。」，狀態標籤跟著切換。 - 15操作
- 位置：
- 畫面上的「停用」。
- 動作：
- 暫時不要推送時按「停用」；要恢復時按「啟用」。
- 結果：
- 顯示「已停用，不會再推送。」或「已啟用。」，狀態標籤跟著切換。
完成後會看到
顯示「已停用，不會再推送。」或「已啟用。」，狀態標籤跟著切換。
做錯或略過會怎樣
停用期間發生的事件不會事後補送。
- 16
這一步要做
懷疑密鑰外流時按「換發密鑰」，把新顯示的密鑰立刻更新到接收端。
為什麼：換發之後，只有拿到新密鑰的接收端驗得過簽章。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
顯示新密鑰，並提醒舊的立刻失效。 - 16操作
- 位置：
- 畫面上的「換發密鑰」。
- 動作：
- 懷疑密鑰外流時按「換發密鑰」，把新顯示的密鑰立刻更新到接收端。
- 結果：
- 顯示新密鑰，並提醒舊的立刻失效。
完成後會看到
顯示新密鑰，並提醒舊的立刻失效。
做錯或略過會怎樣
在接收端換成新密鑰之前，每一筆推送都會驗章失敗，所以安排在你能馬上更新的時候按。
- 17
這一步要做
確定不再使用時按「刪除」。
為什麼：不用的目的地留著，顧客資料會一直送到一個沒人看的地方。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
顯示「已刪除。」，卡片從清單消失。 - 17操作
- 位置：
- 畫面上的「刪除」。
- 動作：
- 確定不再使用時按「刪除」。
- 結果：
- 顯示「已刪除。」，卡片從清單消失。
完成後會看到
顯示「已刪除。」，卡片從清單消失。
做錯或略過會怎樣
刪除不會再確認一次，也沒有復原；之後要用得重新建立並設定新密鑰。
注意事項
- • 要停掉所有推送，可以在這頁停用或刪除每一個目的地；到「網站設定」的「功能開關」取消勾選「資料推送」也會讓所有目的地一起停止推送，目的地設定會保留。
遇到問題先看這裡
- 網址存不進去，說「不接受指向內部網路或本機的網址」？
- 接收網址必須是公開網際網路連得到的位址。localhost、10.x、192.168.x、169.254.x 這類只在內部網路有效的位址一律不接受 —— 平台是從自己的伺服器送出這筆請求的，不是從你的電腦。本機開發請先用可對外的測試網址（例如 webhook 測試服務或內網穿透工具）。
- 推送一直失敗，後台顯示「連續失敗」？
- 先按「送一筆測試」看錯誤訊息。HTTP 4xx（408、429 除外）表示你的系統收到了但拒絕，通常是路徑錯或驗章失敗，這種不會重試；5xx、408、429 與連線逾時會自動再試，最多送五次。驗章失敗最常見的原因是換發過密鑰但接收端還用舊的。
- 怎麼確認這筆請求真的來自安庭？
- 每筆推送都帶 x-anting-signature 標頭，格式是 t=<時間戳>,v1=<簽章>。用你的密鑰對「時間戳.請求內容」算 HMAC-SHA256，比對 v1 是否相同；同時檢查時間戳夠新，就能擋掉別人重放舊請求。
- 換發密鑰之後會怎樣？
- 舊密鑰立刻失效。在你把新密鑰更新到接收端之前，推送會一直驗章失敗，所以請安排在你能馬上更新的時候換。
- 推送會帶顧客的個資嗎？
- 會 —— 內容包含顧客的姓名、Email 與電話，也就是你在後台名單裡看得到的同一筆。所以接收網址只能是 https，而且請確認你自己的系統有妥善保管這些資料。
- 會推送訂單狀態變更或文章發佈嗎？
- 目前只有兩種事件：有人第一次留下聯絡資料、以及名單上已有的人又有新互動（送表單、預約、下單、註冊會員）。出貨、退款、內容發佈還沒有對應的事件。
- 推送紀錄的說明欄出現 HTTP 301 或 302？
- 接收網址回了轉址，平台不會跟著轉，所以記為失敗而且不重試。請把網址改成轉址後的最終網址（常見是少了結尾的斜線，或 http 轉 https），按「編輯」改好後再「送一筆測試」。
- 建立後忘了複製密鑰怎麼辦？
- 密鑰只完整顯示一次，平台之後也看不到原本那把。按目的地卡片上的「換發密鑰」產生新的，立刻更新到接收端；換發前送出的請求用的是舊密鑰。
逐步操作