解決方案指南

嵌入式電子簽名:將簽署功能整合到您的產品中

如何透過 API 和 SDK 方式,將電子簽名能力直接嵌入您的應用、門戶或 CRM 系統。

eSign.AI 解決方案團隊7 分鐘閱讀

為什麼選擇嵌入式簽署而非跳轉?

將使用者跳轉到第三方簽署頁面會帶來摩擦:上下文切換、品牌不連貫以及使用者流失。嵌入式簽署讓使用者在整個簽署過程中始終停留在您的應用內。簽署介面以 iframe 或原生元件的形式呈現,使用您的品牌視覺風格,而簽名引擎執行在提供商的後端。

三種嵌入方式對比

開發工作量品牌控制力
Iframe 嵌入低(僅需前端)中等 — 可定製的 iframe
API + 自定義 UI高(全棧)完全 — 自建 UI
移動端 SDK中等(分平臺)完整的原生體驗

何時使用嵌入式簽署

嵌入式簽署並非總是最佳選擇。以下是其價值最大的應用場景。

01

如果您的產品已有合同生成流程(如 HR 入職、貸款申請、供應商註冊),嵌入簽署功能可以消除跳轉,讓使用者始終保持在業務流程中。

02

服務員工或客戶的企業門戶可以嵌入簽署功能,用於政策確認、內部審批和自助協議,無需將使用者引導至外部工具。

03

當簽署量很大(每天數千份)時,每次跳轉都會損失轉化率。嵌入式簽署可減少使用者流失並提高完成率,直接影響營收。

04

嵌入式簽署讓您完全掌控使用者旅程,更輕鬆地在自己的應用上下文中實現自定義審計追蹤、合規披露和同意書採集。

嵌入式簽署 API 流程

典型的嵌入式簽署實現遵循以下步驟序列。

01

透過 API 建立信封

您的後端呼叫簽署 API 建立信封:上傳文件、定義簽名欄位、設定簽署人角色,並配置身份認證要求。API 返回信封 ID。

02

生成簽署 URL

為每位簽署人從 API 獲取簽署 URL。該 URL 包含一次性令牌,用於對特定信封的簽署人進行身份認證。可選傳入接收方認證方式(訪問碼、簡訊驗證碼、eID)。

03

嵌入 iframe 或 SDK

將簽署 URL 嵌入 iframe(Web 端)或移動端 SDK(iOS/Android)。簽署介面在您的應用內載入,可自定義外觀以匹配您的品牌色彩、字型和 Logo。

04

處理完成回撥 webhook

當簽署人完成簽署(或拒絕)時,簽署平臺會向您的後端傳送 webhook。您可據此更新應用狀態、觸發後續流程或通知相關方。

05

獲取已簽署文件

透過 API 下載已簽署的文件和證據包(簽署完成證書、審計追蹤),儲存到您的系統或雲端儲存中。

嵌入式簽署的技術考量

跨域與 CSP

Iframe 嵌入要求籤署域名在您的 CSP(內容安全策略)中被允許。需配置 frame-ancestors 和 child-src 頭部。大多數簽署平臺提供域名白名單機制。

Webhook 可靠性

Webhook 可能因網路問題而失敗。請實現冪等的 webhook 處理器和輪詢兜底機制,定期檢查信封狀態。切勿僅依賴 webhook 處理關鍵狀態變更。

移動端適配

簽署介面必須適配移動裝置。請在 iOS Safari 和 Android Chrome 上測試 iframe 嵌入式簽署。某些簽名板實現在移動端存在觸控事件問題。原生移動應用請使用 SDK。

速率限制與批處理

高頻嵌入式簽署可能觸及 API 速率限制。請實現請求佇列,並在支援的情況下批次建立信封。監控 API 用量並設定接近限制的告警。

eSign.AI 嵌入式簽署如何工作

eSign.AI 為需要在自有介面中整合簽署功能的 SaaS 產品提供白標嵌入式簽署方案。

iframe 與元件 SDK

透過 iframe 或 React/Vue 元件將 eSign.AI 簽署體驗嵌入您的產品中。簽署人無需離開您的應用。嵌入式簽署支援 eSign.AI 的全部功能:多方簽署路由、身份驗證、QES、審計追蹤。

實時狀態 webhook

配置 webhook 接收簽署事件:信封已傳送、已檢視、已簽署、已完成、已拒絕。您的應用可在簽署完成後立即觸發後續工作流(合同啟用、通知、計費)。

嵌入式電子簽名 API:延遲、SLA 與 webhook

用於 API 整合規劃的效能規格。

API 延遲基準

eSign.AI:建立信封 200-400 毫秒,獲取狀態 50-100 毫秒,下載已簽署 PDF 300-800 毫秒。DocuSign:建立信封 300-600 毫秒,獲取狀態 80-150 毫秒。Adobe Sign:建立信封 400-800 毫秒。嵌入式簽署 iframe 載入:eSign.AI 1-2 秒,DocuSign 2-4 秒。

Webhook 可靠性

eSign.AI webhook:30 秒超時,3 次重試並採用指數退避(5 分鐘、30 分鐘、2 小時),HMAC 簽名用於載荷驗證。DocuSign:10 秒超時,24 小時重試視窗。Adobe Sign:3 秒超時,72 小時內 6 次重試。對於實時後續工作流,eSign.AI 的 webhook 交付最為可靠。

常見問題

不會。簽名的法律效力取決於簽名方式(SES、AES、QES)、身份驗證和證據包——而非簽署介面是嵌入式還是跳轉式。嵌入式簽署產生與獨立簽署相同的法律證據。

團隊正在討論適合業務的電子簽名方案

為你的業務探索合適的電子簽名方案

與我們的團隊溝通你在目標市場的電子簽名需求、合規考量和文件流程。