关于DocuSign EventNotification的EnvelopeEvents是否支持Signed事件的问询

针对你遇到的场景——需要捕捉用户已完成签署但文档暂不可下载的时机，同时避开用户关闭页面触发的Declined/Void状态，结合DocuSign Connect（Webhook）的事件机制，这里给你一套具体的实现思路：

1. 优先监听signing_complete事件（单签署人完成节点） #

当单个签署人点击“完成签署”按钮后，DocuSign会立刻触发signing_complete事件，这个节点的核心特点是：

• 签署人已完成操作，但整个信封的文档还在后台进行最终生成、归档流程，暂无法下载
• 此时信封状态可能是sent（多签署人场景）或completed（单签署人场景），但文档就绪状态还未更新
• 收到这个事件后，你就可以在UI上将对应文档标记为Pending状态，等待后续的文档就绪信号

2. 用envelope_completed事件确认文档可下载 #

当所有签署人都完成操作，且DocuSign完成文档的最终处理后，会触发envelope_completed事件。此时文档已经正式归档完成，可以正常下载，你就可以把UI状态从Pending切换为“已完成/可下载”状态。

3. 精准区分“主动签署完成”和“关闭页面触发的作废/拒绝” #

要避免误判用户关闭页面的情况，你需要在Webhook的事件payload中检查关键字段：

• 对于signing_complete事件：确认签署人的status字段为completed，且declinedReason为空（排除用户中途反悔的情况）
• 对于envelope_voided或envelope_declined事件：这些是用户主动拒绝或信封被作废的触发，直接标记为对应状态即可，不要进入Pending流程

4. 多签署人场景的特殊处理 #

如果你的信封有多个签署人，当第一个签署人完成后，信封状态仍为sent，但该签署人的signing_complete事件会正常触发。此时你可以针对该签署人的操作标记为“部分完成Pending”，直到所有签署人都完成并收到envelope_completed事件，再统一切换为最终状态。

事件payload检查示例 #

在你的Webhook接收逻辑中，可以通过解析JSON payload来判断状态：

// signing_complete事件核心片段示例
{
  "eventType": "signing_complete",
  "envelopeStatus": {
    "status": "sent",
    "recipients": {
      "signers": [
        {
          "status": "completed",
          "declinedReason": "",
          "email": "signer1@example.com"
        }
      ]
    }
  }
}

只要收到这类事件，且后续未收到envelope_declined/envelope_voided事件，就可以判定为“签署完成但文档暂不可下载”，显示Pending状态。

内容的提问来源于stack exchange，提问作者Harts