Docusign单信封配置Connect webhooks无法返回JSON格式问题咨询

• 创建信封的API版本不符合要求
  信封级Webhook的JSON格式仅支持通过v2.1版本REST API创建的信封。如果创建信封时调用的是v2版本API，即使eventData中指定了restv2.1参数也不会生效，系统会默认返回XML格式回调。
• eventNotification结构或参数拼写错误
  请确认配置符合以下规则：
  • eventData必须是eventNotification对象的直接子属性，不可嵌套在其他字段下
  • 字段严格区分大小写：format的值必须为小写的json，version的值必须严格写为restv2.1
    你当前的eventData结构是正确的，完整的标准配置参考：

  eventNotification: {
    url: "你的回调服务地址",
    loggingEnabled: true,
    requireAcknowledgment: true,
    envelopeEvents: [
      // 你配置的触发事件列表
    ],
    recipientEvents: [
      // 你配置的触发事件列表
    ],
    eventData: {
      version: 'restv2.1',
      format: 'json',
      includeData: ['custom_fields', 'extensions', 'folders', 'recipients'],
    }
  }
  

• Node.js SDK版本过旧
  低于v5.0.0版本的DocuSign Node.js SDK未内置对信封级JSON回调的支持，提交请求时会自动过滤未识别的eventData字段，导致配置不生效，默认返回XML。请升级到最新稳定版SDK后重试。
• 测试用信封为旧版本
  配置调整前创建的信封，回调会沿用信封创建时的参数，不会应用新的配置规则。请重新创建全新的信封进行测试验证。
• 账户级配置优先级冲突
  部分演示账户可能存在账户级Connect配置的兼容问题，你可以临时关闭账户级Connect配置，仅保留信封级配置后重试，排查是否存在配置优先级冲突。

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