Zapier Webhook触发DocuSign文档签署请求异常问题咨询

异常1：触发后仅返回待签署模板 #

• 检查请求体是否包含模板填充参数：需将模板预设的变量键值对放在template_data字段下传递，不要仅提交模板ID作为唯一业务参数，缺失填充字段时接口会默认返回原始模板，不会生成正式签署任务
• 确认签署人配置完整：需在请求体的signers数组中明确每个签署角色的姓名、联系方式信息，未配置签署人时接口不会启动签署流程，仅返回待配置的模板内容

异常2：运行后提示400 Bad Request错误 #

• 校验请求头配置：确保Content-Type字段值为application/json，多数电子签接口不支持form-data格式提交，请求头不匹配会直接返回400错误
• 验证请求体格式合法性：先将构造的请求体复制到JSON校验工具检查格式，常见问题包括template_id格式错误、signers字段不符合数组要求、参数值类型不匹配（如将数值类型的有效期写为字符串）
• 排查接口权限配置：确认webhook携带的API密钥/访问Token未过期、且具备发起签署请求的接口权限，部分服务商不会单独返回401状态码，会将权限类错误统一封装为400错误返回

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