DocuSign PowerForm预填充文本字段未通过Webhook返回问题求助

• 检查PowerForm字段核心设置
  确保预填充的文本字段同时开启两个关键选项：

  • 发送到文档（Send to Document）：让预填充值写入文档
  • 包含在信封数据中（Include in Envelope Data）：让字段数据被纳入信封元数据，Webhook才能获取到

• 调整Webhook的事件与数据配置

  1. 确认订阅的事件类型包含completed（签署完成），只有信封完成后，完整的字段数据才会被推送
  2. 在Webhook的「数据包含」设置里，勾选文档字段（Document Fields）选项，这是控制表单字段数据是否进入Webhook payload的开关

• 验证字段标识符一致性
  预填充字段的tabLabel（标签）必须和URL中用于预填充的参数名完全一致，DocuSign通过这个标签匹配并返回字段值，标签不匹配会导致数据无法被识别

• 测试环节注意事项

  • 修改配置后必须发起新的签署流程，旧信封不会补发Webhook数据
  • 在webhook.site中查看完整的payload结构，字段数据通常位于envelopeFields或documentFields节点下，不要只检查表层内容

• 排查辅助步骤
  若仍无数据，先在DocuSign控制台的「信封历史」中查看信封的字段数据：

  • 这里有数据 → 问题出在Webhook配置
  • 这里无数据 → 问题出在PowerForm的字段设置

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