Webhooks:將Unstructured與後續所有流程連接起來
Unstructured推出webhooks功能,可根據任務生命週期事件自動觸發下游操作,支持通過工作區或工作流範圍與任何端點集成。
2026年4月15日,Unstructured宣佈推出webhooks功能,用於在其平台上自動化任務完成後的下游操作。Unstructured通常位於AI管道的起始端,處理來自各種來源的文檔,經過一系列處理節點後,將結構化數據發送到目標位置。藉助新的webhooks,當任務被安排、開始、完成、停止或失敗時,系統會自動向用户控制的端點發送信號,從而觸發後續流程、發送通知或與其他工具集成。
Webhook基於任務生命週期中的五個事件觸發:job.scheduled(任務已排隊)、job.in_progress(處理中)、job.stopped(已停止)、job.failed(失敗)和job.completed(已完成)。當事件發生時,Unstructured會向用户端點發送HTTPS POST請求,負載中包含事件類型、任務ID、工作流ID和處理時間等信息。同時,每個請求附帶三個驗證頭部:webhook-id、webhook-timestamp和webhook-signature,用於確保請求的真實性和完整性。
Webhook的作用範圍分為兩種:工作區範圍和工作流範圍。工作區範圍的webhook會監聽整個工作區內所有任務的事件,適用於需要全局可見性的場景;工作流範圍的webhook僅針對特定工作流中的任務,適用於需要特定響應的場景。在Unstructured的API中,兩者都稱為通知通道,區別在於創建的位置。工作區範圍的通道可通過Unstructured UI或API創建,而工作流範圍的通道僅通過API創建。
通過webhooks,用户可以構建多種應用。最直接的是實時通知——任務完成時向Slack發送消息,失敗時呼叫值班工程師。另一個重要用途是觸發下游管道——當Unstructured處理完畢後,自動啓動後續處理或更新狀態,實現整個工作流的自動化。任何接受POST請求的端點都可以作為接收器,包括Slack、Discord、郵件服務器或用户自己的服務器。
開始使用webhooks非常簡單。用户可以通過Unstructured UI或API創建一個通知通道,指定目標端點和觸發事件,並可選擇添加簽名密鑰。創建後,匹配的任務事件會立即發送負載。每個請求都包含三個頭部用於驗證,完整的驗證實現可在官方文檔中找到。最快的方式是使用webhook.site設置免費接收器,在十分鐘內即可體驗實時webhook。如需更多信息,可訪問Unstructured文檔或免費註冊開始使用。