DocuSign API：嵌入式簽名儀式的 webhook 通知

Question

雖然我們可以接收 email 簽名的 webhook 消息，但似乎 DocuSign 不會為嵌入式 session 簽名發送 webhook 事件。 這行得通嗎？

Answer 1

是的，Connect 可以觸發嵌入式簽名事件的事件。

您使用的是帳戶級別的 Connect 配置，還是信封級別的 EventNotifications？

Answer 2

與嵌入式簽名 session 相關的事件是recipient事件，而不是更廣泛的envelope事件。 -- 因此，請檢查您的 Connect 訂閱是否要求正確的事件。 例如，recipient_completed，而不僅僅是信封_completed。

此外，默認的 Connect 排隊策略通常會結合幾乎同時發生的事件的通知。

例如

1. 收件人 1 標志（通過嵌入式儀式或電子郵件發起的儀式）
2. 信封現已完成（收件人 1 是信封的最后一個收件人）

如果您已詢問收件人和信封事件，通常只會針對上述兩個事件通知您一次。

如果您需要針對上述每個事件的單獨通知，請切換到使用 SIM 隊列進行 Connect。 這是通過電子簽名管理工具的更新部分在帳戶級別完成的。

Answer 3

Docusign 通過兩種方式支持 webhook 事件 -

1. 帳戶級別 - 連接配置：為此，您需要配置 webhook URL。 Go 到 Docusign 管理頁面 -> 在集成下，select “連接” -> 添加配置 -> 自定義 -> 指定 webhook ZE6B391A8D2C4D45902A23A8B6585703DD 和觸發事件。 這將適用於該帳戶的所有信封。

2. 信封級別：在 createEnvelope 請求中添加以下內容：

 "eventNotification": { "URL": "<webhookurl>", "loggingEnabled": "true", "requireAcknowledgment": "true", "useSoapInterface": "false", "includeCertificateWithSoap": "false", "signMessageWithX509Cert": "false", "includeDocuments": "true", "includeEnvelopeVoidReason": "true", "includeTimeZone": "true", "includeSenderAccountAsCustomField": "true", "includeDocumentFields": "true", "includeCertificateOfCompletion": "true", "envelopeEvents": [ {"envelopeEventStatusCode": "sent"}, {"envelopeEventStatusCode": "delivered"}, {"envelopeEventStatusCode": "completed"}, {"envelopeEventStatusCode": "declined"}, {"envelopeEventStatusCode": "voided"} ], "recipientEvents": [ {"recipientEventStatusCode": "Sent"}, {"recipientEventStatusCode": "Delivered"}, {"recipientEventStatusCode": "Completed"}, {"recipientEventStatusCode": "Declined"}, {"recipientEventStatusCode": "AuthenticationFailed"}, {"recipientEventStatusCode": "AutoResponded"} ] }

這僅適用於該信封。

您可以配置要觸發 webhook URL 的事件。

DocuSign 使用 XML 在相應事件上點擊 webhook，其中包含有關信封和收件人事件的所有信息。 如果您不想接收 XML 中的簽名文檔，您也可以配置。