---
title: "PDF 活動的即時 Webhook — 簽名事件"
description: "當使用者檢視、下載或填寫 PDF 表單時，立即收到 HTTPS POST。HMAC-SHA256 簽名 Webhook 搭配自動重試功能，加上無須安裝應用程式的 Slack 通知。"
canonical: "https://everypage.co/zh-Hant/pdf-webhooks"
last-updated: "2026-08-28"
---

# PDF 活動的即時 Webhook — 簽名事件

出站 Webhook

# 即時 Webhook 用於 PDF 活動

當有人開啟您的提案、下載報告或完成潛在客戶表單時，EveryPage 會立即將經簽名的 HTTPS POST 傳送至您選擇的任何端點 — 您的 CRM、自有服務或 Slack 頻道。

將你的 PDF 拖放到這裡

或點擊此處瀏覽檔案

僅限 PDF · 上限 20MB

免費開始使用 · 所有方案皆含 Webhook，最多 25 個端點 · 從帳戶設定新增

## 每個事件都被推送

檢視、下載、已完成的閘門表單、讀者評論、收據確認及自毀燒毀 — 每個事件在發生後幾秒內即抵達您的端點。無需輪詢，也無需反覆重新整理。

## 簽名確保可信

每次傳遞都採用以您的端點密鑰計算的 HMAC-SHA256 簽名，採用 Stripe 風格。您的接收方可以證明每個 POST 確實來自 EveryPage 且不是重放。

## 重試直到傳遞成功

失敗的傳遞會按照遞增退避排程自動重試。持續失敗的端點會被停用 — 並通知您 — 而不是無限期地無聲吞下事件。

## Slack 通知，無須安裝應用程式

將 Webhook 指向 Slack 傳入 Webhook URL 並選擇 Slack 格式：事件會以格式化的 Block Kit 訊息形式送達您的頻道。無需從 Slack 目錄安裝或批准任何東西。

## Webhook 可以傳送哪些事件？

共用的 PDF 會產生您想要立即採取行動的時刻 — 潛在客戶開啟提案、潛在客戶完成閘門表單、一次性連結燃盡自身。每個端點都訂閱它所關心的確切事件：

- 已檢視。 讀者開啟了文件。每次造訪觸發，攜帶檔案、造訪來源和您的方案報告的讀者身分 — 足以讓 CRM 記錄誰回訪了。
- 已下載。 一份副本已離開。事件說明是哪份文件，以及哪位讀者取走了它。
- 表單已完成。 讀者通過了電子郵件閘門或潛在客戶擷取表單。酬載攜帶已擷取的欄位，準備好在潛在客戶仍在閱讀時直接發佈到您的 CRM。唯一僅限 Pro 的傳送 — 酬載內含潛在客戶資料，因此帳戶為 Pro 期間才會送出。
- 已新增評論。 讀者在文件上留下回饋 — 私人或公開 — 以便在讀者仍在頁面上時適當的人員可以回應。
- 收據已確認。 讀者將文件標記為已收到。交付證明，推送到您的稽核軌跡所在之處。
- 連結已燃盡。 自毀連結耗盡其檢視預算並自行刪除 — 連結曾傳送的最後一個事件。您的讀者身分記錄倖存下來；Webhook 告訴您文件何時消失。

## 驗證簽名

每次傳遞都包含與 Stripe 相同的 t/v1 風格簽名標頭：Unix 時間戳和十六進位摘要，以逗號分隔。摘要是時間戳、點號和原始請求主體的 HMAC-SHA256，使用接收它的端點的簽名密鑰。

若要驗證：從標頭讀取時間戳和簽名、使用您的密鑰對時間戳-點號-主體重新計算 HMAC-SHA256，並將您的摘要與 v1 進行常數時間比較。拒絕時間戳早於您的容限的任何項目 — 五分鐘是典型的 — 偽造或重放的傳遞永遠無法通過前門。

簽名密鑰按端點生成，在建立時只顯示一次。像密碼一樣儲存它；如果它洩露或丟失，請輪換端點並產生新的密鑰。

## 傳遞、重試和維護

傳遞是對您的 HTTPS 端點的 POST，附帶 JSON 主體；任何 2xx 回應都被視為已接收。其他任何事情 — 逾時、500 或連線斷開 — 都會按照遞增退避自動重試，因此在您這一方進行部署或出現小故障不會造成成本。事件會在您恢復時送達。

在持續執行中每次重試都失敗的端點會自動停用，因此不會放任它持續把事件吸入虛空 — 其狀態會顯示在帳戶設定中，一旦您這一方修復，您可以重新啟用它。每個帳戶最多可以註冊 25 個端點，每個端點都有自己的密鑰、自己的事件選擇和自己的酬載格式。

## 三個步驟實現 Slack 通知

Slack 支援以 Webhook 格式提供，而不是 Slack 應用程式 — 無需從應用程式目錄安裝任何東西，也無需工作區管理員批准。

1. 建立 Slack 傳入 Webhook。 在 Slack 中，將傳入 Webhook 新增至您想要接收通知的頻道。Slack 會為您提供該頻道的唯一 URL。
2. 將 URL 貼入 EveryPage。 在帳戶設定中將其新增為 Webhook 端點，就像您對待任何其他端點 URL 一樣。
3. 選擇 Slack 格式。 選擇 Slack 作為酬載格式並選擇您的事件。從此以後，您提案的檢視會在幾秒後變成頻道中的格式化 Block Kit 訊息。

## 偏好無代碼？使用 Zapier

如果您根本不想執行接收端點， Zapier 整合 會將 EveryPage 連接到 7,000 多個應用程式，無需代碼。它按排程輪詢而非即時推送，這對大多數通知和記錄流程都沒問題。

Webhook 是同一光譜的即時、開發人員級端點：推送傳遞、簽名酬載，以及您自己的代碼決定下一步。瀏覽 所有 EveryPage 整合 了解介於兩者之間的所有內容。

## Webhook 問題.

### PDF Webhook 是什麼？

Webhook 是 EveryPage 在您共用的文件發生狀況時立即傳送至您控制的 URL 的 HTTPS POST — 檢視、下載、已完成的閘門表單、評論、已確認的收據或自毀燒毀。您的系統會即時收到通知，而不是檢查您的讀者儀表板。

### 當有人閱讀我的 PDF 時，我如何獲得 Slack 通知？

在 Slack 中為您想要的頻道建立傳入 Webhook、將其 URL 貼入 EveryPage 作為 Webhook 端點，並選擇 Slack 酬載格式。事件然後會以格式化的 Block Kit 訊息形式送達該頻道。無需 Slack 應用程式安裝或工作區管理員批准。

### 我如何驗證 Webhook 確實來自 EveryPage？

每次傳遞都使用您的端點密鑰以 HMAC-SHA256 簽名，採用與 Stripe 相同的時間戳加簽名標頭風格。對時間戳和原始請求主體重新計算摘要、以常數時間與 v1 值進行比較，並拒絕陳舊時間戳 — 偽造或重放的請求檢查失敗。

### 如果我的端點關閉會怎樣？

失敗的傳遞會按照遞增退避排程自動重試，因此在您這一方發生中斷只會延遲事件。在整個排程中持續失敗一段時間的端點會自動停用；其狀態會顯示在帳戶設定中，修復後您可以重新啟用它。

### 哪個方案包括 Webhook，我可以新增多少個端點？

所有方案都包含出站 Webhook — Free、Basic 和 Pro — 以及 Slack 格式。每個帳戶最多可以註冊 25 個端點，每個端點都有自己的簽名密鑰、事件選擇和酬載格式。唯一的例外：表單完成（gate.completed）的傳送內含擷取的潛在客戶資料，因此僅在帳戶為 Pro 期間送出。如果您想要無代碼的自動化，Zapier 整合可作為替代方案。

## 將您的文件連接至其他所有內容.

新增端點或 Slack 頻道 — 任何方案皆可 — 下次有人開啟您的提案時，您的工具會在您之前就知道。

相關： 開發人員 API · PDF 閱讀追蹤 · 潛在客戶擷取表單 · 所有整合