DocuSign信封创建后如何立即获取新的委托用户？

一、Connect配置问题排查 #

• Aggregate类型配置限制：Aggregate类型的Connect webhook本身不支持「Recipient Delegate」触发事件，仅SIM（Single Instance Message）类型配置支持该事件。若之前使用Aggregate配置，必须切换为SIM类型才能捕获委托操作事件。
• SIM配置触发失效检查：
  • 确认SIM配置的事件过滤规则仅勾选recipient_delegate的同时，是否覆盖了信封可能发生委托的状态范围（如sent、delivered等）。
  • 验证webhook端点可用性：通过DocuSign后台的「测试连接」功能，确认你的端点能被正常访问，无防火墙、认证拦截等问题。
  • 检查信封委托权限：确认执行委托操作的用户具备对应权限，且委托动作是在信封处于可委托状态（如收件人未签署）时完成的。

二、API获取最新委托收件人方法 #

• 指定参数查询收件人：调用收件人状态查询接口时，必须添加include_delegates=true参数，默认接口不会返回委托后的收件人数据。示例请求：

  GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients?include_delegates=true
  

  该接口会返回所有委托相关的收件人信息，包含新的委托用户详情。
• 通过Connect事件实时获取：当SIM配置正确触发recipient_delegate事件后，webhook推送的payload中会包含recipient_delegate对象，可直接从中提取新委托用户的ID、邮箱等信息，无需额外调用API查询。

三、额外注意事项 #

• 委托事件触发时机：仅当收件人实际完成委托操作后，Connect事件才会推送，并非信封创建后立即触发。
• API权限验证：确保调用接口的集成用户拥有account_read和envelope_read权限，否则无法获取委托收件人数据。

内容的提问来源于stack exchange，提问作者G.Mich