DocuSign无法调用webhook监听器 报URI为空错误咨询

通过webhook监听器接收DocuSign平台已签署文件的功能前期运行正常，自2022年5月31日起，DocuSign始终无法调用部署的webhook监听器。在Connect菜单查看日志，底部报错如下：

2022/6/22 | 下午3:52:07
错误：EnvelopeIntegration.RunIntegration发生异常: ac08432f-18c4-471d-8720-caaf78fe4dfc :: 无URI :: 错误 - 无效URI：URI为空。

配置webhook监听器URL使用的代码如下：

Dim eventNotification = New EventNotification()
eveventNotification.Url ="https://www.sample.com/webhook/default.aspx"   
eventNotification.RequireAcknowledgment = "true"
eventNotification.IncludeDocuments = "true"
eventNotification.LoggingEnabled = "true"

web监听器最后一次成功接收DocuSign推送的时间为2022年5月30日，此后所有推送请求全部失败，需要定位问题诱因。

根因定位 #

报错直接指向推送目标URI为空，问题由代码笔误叠加DocuSign平台规则调整共同导致：

• 代码存在拼写错误：实例化的配置对象名为eventNotification，但给Url属性赋值时误写为eveventNotification（多输入了ev两个字符，将event错拼为evevent）。在VB的宽松编译模式下，这行代码不会触发编译报错，只会动态创建一个无实际作用的临时对象给它赋值Url，真正提交给DocuSign的eventNotification实例的Url属性一直是空值。
• 2022年5月30日之前功能正常，是因为此前DocuSign Connect的推送优先级为账户级全局配置优先，之前的推送实际走的是DocuSign后台配置的全局webhook地址，没有用到代码里写的信封级EventNotification配置。2022年5月31日DocuSign上线了Connect优先级规则更新，信封级EventNotification配置会覆盖全局配置，只要创建信封时携带了EventNotification对象，平台会优先读取该对象内的Url发起推送，读取到空值就直接抛出URI为空的错误，不会再回退到全局配置地址。

修复方案 #

• 修正代码笔误，将eveventNotification.Url改为eventNotification.Url，确保Url属性正确赋值到实例化的配置对象上。
• 修复后创建测试信封，到Connect日志中确认推送目标地址显示为配置的webhook路径，无空值问题即可恢复推送。
• 如果不需要为不同信封配置单独的webhook地址，建议直接删除代码中EventNotification相关定义，统一使用账户级全局Connect配置，减少配置冲突概率。

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