DocuSign API：如何在發送後添加「Carbon Copy」收件人？

理解 DocuSign 中的碳拷貝收件人

在電子簽名領域，DocuSign 的 API 提供了強大的工具來自動化文件工作流程，但是在信封建立後添加收件人可能會很棘手。「碳拷貝」（CC）收件人是一種非簽名角色，他們會收到已簽名文件的副本，用於查看或記錄保存，而無需簽名或批准。從業務角度來看，此功能對於合規團隊、法律部門或銷售經理來說非常寶貴，他們需要通知而無需更改簽名鏈。然而，DocuSign 的 API 在信封發送後對修改有限制，我們將詳細探討這些限制。

本文深入探討了透過 DocuSign eSignature API 在發送信封後添加 CC 收件人的實際步驟。我們將涵蓋先決條件、API 呼叫、潛在陷阱和最佳實踐，參考官方文件和實際實施見解。對於整合 DocuSign 的企業來說，理解這些細微差別可以防止工作流程中斷，並確保審計就緒的流程。

DocuSign API 收件人管理基礎

在發送後添加 CC 收件人之前，理解 DocuSign 的信封生命週期至關重要。信封代表文件包，一旦「發送」，它們就處於活動狀態，此時更改受到限制，以保護簽名者體驗和法律完整性。eSignature REST API（v2.1）管理這些互動，需要透過 JWT 或 OAuth 進行身份驗證以實現安全存取。

關鍵概念：

• 收件人：包括簽名者、審批者和 CC。CC 透過收件人物件中的 carbonCopies 陣列添加。
• 信封狀態：發送後，信封處於「sent」或「delivered」狀態。修改有限制；您不能添加需要行動的簽名者，但 CC 是允許的，因為它們不會更改簽名順序。
• API 端點：使用 /envelopes/{envelopeId}/recipients 進行更新。

從商業角度來看，DocuSign 的 API 定價從 Starter 計劃的每年 600 美元起，支持每月最多 40 個信封，適合小型整合，但高容量需求會增加成本。

逐步指南：在發送後添加 CC 收件人

在發送後添加 CC 需要使用 correct 模式或 void-and-resend 變通方法，因為直接發送後添加並不總是直截了當。DocuSign 推薦提前規劃收件人，但對於動態場景（例如，根據條件業務邏輯添加經理），請按照以下步驟操作。此過程假設您擁有開發者帳戶和 API 存取令牌。

先決條件

1. API 設定：整合 DocuSign SDK（適用於 Java、.NET、PHP 等）或使用原始 REST 呼叫。使用您的整合金鑰和使用者 ID 進行身份驗證。
2. 信封 ID：從初始發送回應中擷取 ID（例如，透過 /envelopes POST）。
3. 權限：確保您的帳戶允許信封更正（在 Admin 設定下的「Features」中啟用）。
4. 信封狀態檢查：查詢 /envelopes/{envelopeId} 以確認它是「sent」狀態，並且沒有簽名者完成鎖定更改的行動。

業務提示：對於企業，Advanced API 計劃（每年 5,760 美元）解鎖了 Bulk Send 和 webhook 等功能，這些功能可以在完成時自動通知 CC。

方法 1：使用信封更正（推薦用於小更改）

DocuSign 的「Correct」功能允許在進度中進行修改，而無需 void 信封，適合添加 CC。

1. 啟動更正：

   • PUT 到 /envelopes/{envelopeId}/correct，主體為：

     {
       "clientUserId": "optional_client_id",
       "correctInProgress": true
     }
     

     這會暫時暫停信封。

2. 添加 CC 收件人：

   • POST 到 /envelopes/{envelopeId}/recipients，帶有 CC 詳細資訊：

     {
       "carbonCopies": [
         {
           "email": "cc@example.com",
           "name": "John Doe",
           "recipientId": "unique_id_for_cc",  // 例如，「CC1」
           "routingOrder": 0  // CC 不影響順序
         }
       ],
       "resendEnvelope": false  // 暫不重新發送通知
     }
     

     • recipientId 必須唯一；避免與現有收件人衝突。
     • 可選：添加 accessControl 以實現密碼保護的 CC 存取。

3. 重新發送或通知：

   • 再次 PUT 到 /envelopes/{envelopeId}/correct 以恢復：

     {
       "resendEnvelope": true  // 觸發新 CC 的電子郵件
     }
     

     一旦信封完成或按請求，CC 將收到副本。

潛在陷阱：如果信封已「completed」，則無法更正——使用 webhook 透過 Connect 功能（Advanced 計劃）監控狀態。

方法 2：Void 並重新發送（適用於複雜場景）

如果更正不可行（例如，由於簽名者行動），則 void 信封並使用新 CC 重新建立它。

1. Void 信封：

   • PUT 到 /envelopes/{envelopeId}：

     {
       "status": "voided",
       "voidedReason": "Adding CC recipient"
     }
     

2. 使用 CC 重新建立：

   • POST 到 /envelopes，帶有原始負載，加上 recipients 物件中的 CC：

     {
       "emailSubject": "Updated Document",
       "documents": [/* original docs */],
       "recipients": {
         "signers": [/* original signers */],
         "carbonCopies": [
           {
             "email": "cc@example.com",
             "name": "John Doe",
             "recipientId": "CC1"
           }
         ]
       },
       "status": "sent"
     }
     

3. 通知原始簽名者：為每個簽名者使用 /envelopes/{newEnvelopeId}/recipients/{recipientId}/resend 以恢復。

業務觀察：此方法會產生額外的信封使用成本（例如，Business Pro 每年每使用者 ~100 個信封，480 美元/使用者/年），因此適合低容量更正。透過 API 使用儀表板追蹤配額以管理。

最佳實踐和限制

• 錯誤處理：常見錯誤包括 400（無效收件人）或 403（權限不足）。始終先使用 /envelopes/{envelopeId}/recipients GET 驗證。
• 測試：使用 DocuSign 的 Developer Sandbox（免費）模擬，而不消耗生產信封。
• 合規性：CC 添加維護審計追蹤，符合 ESIGN/UETA 標準，但記錄原因以避免爭議。
• 自動化替代方案：對於頻繁的發送後需求，整合 webhook（Advanced 計劃）以觸發外部通知，而不是 API 修改。

在實踐中，企業報告透過 SDK 腳本這些操作可獲得 20-30% 的效率提升，但對於高規模操作，請考慮 Enterprise 自訂計劃以實現無限調整。

正在比較電子簽名平台與 DocuSign 或 Adobe Sign？

eSignGlobal 提供更靈活且成本效益更高的電子簽名解決方案，具有全球合規性、透明定價和更快的入職。

👉 開始免費試用

將 DocuSign 與關鍵競爭對手比較

為了提供平衡觀點，讓我們將 DocuSign 的 API 功能與 Adobe Sign、eSignGlobal 和 HelloSign（現為 Dropbox Sign）等替代方案進行比較。此表格基於 2025 年公開數據，突出定價、收件人管理和區域優勢，幫助企業在供應商選擇中做出決策。

此比較顯示 DocuSign 在成熟 API 深度方面表現出色，但成本更高，而競爭對手為特定細分市場提供靈活性。

Adobe Sign 焦點

Adobe Sign 是 Adobe Document Cloud 的一部分，提供無縫 API 用於收件人管理，包括透過其「Amend」API 端點更容易的發送後 CC 添加。定價具有競爭力，基礎版每月 10 美元/使用者，擴展到 Enterprise 自訂。它適合已在 Adobe 套件中的企業，提供強大的 PDF 處理和全球合規性，儘管 APAC 延遲可能是个問題。

eSignGlobal 焦點

eSignGlobal 將自己定位為全球玩家，在 100 多個主流國家合規，尤其在亞太 (APAC) 地區具有強大優勢。APAC 的電子簽名景觀碎片化，具有高標準和嚴格法規——不同於美國/歐盟的框架式 ESIGN/eIDAS，APAC 需要「生態系統整合」解決方案。這意味著與政府數字身份 (G2B) 的深度硬體/API 級對接，這是一個遠超西方常見電子郵件驗證或自我聲明模式的技術障礙。eSignGlobal 透過香港的 iAM Smart 和新加坡的 Singpass 等原生整合解決此問題，確保法律有效性而無需額外成本。

定價實惠，其 Essential 計劃每年每月 16.6 美元，允許最多 100 個文件簽名、無限使用者席位，以及透過存取代碼驗證。此合規性導向的價值使其在與 DocuSign 和 Adobe Sign 的競爭中具有競爭力，尤其適合尋求更低 TCO 的跨境團隊。

正在尋找比 DocuSign 更智能的替代方案？

eSignGlobal 提供更靈活且成本效益更高的電子簽名解決方案，具有全球合規性、透明定價和更快的入職。

👉 開始免費試用

電子簽名選擇的最終思考

對於導航 API 驅動工作流程的企業來說，DocuSign 仍是可靠的選擇，儘管發送後修改需要仔細規劃。隨著替代方案的興起，請考慮區域需求——eSignGlobal 作為 APAC 導向操作的中立、合規導向選項脫穎而出。根據您的容量、整合和地理位置進行評估，以實現最佳匹配。