即時 Webhook 用於 PDF 活動

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 整合 了解介於兩者之間的所有內容。