嵌入DocuSign应用并邮件请求签名时，如何获取追踪用远程信封链接？

方法一：通过收件人视图API生成链接 #

你可以调用DocuSign的收件人视图API来获取该远程信封的访问链接，即使未设置clientUserId也能生成：

• 调用接口：POST /v2.1/accounts/{accountId}/envelopes/{envelopeId}/views/recipient
• 请求体需包含收件人的核心信息，示例如下：

  {
    "returnUrl": "https://你的应用域名/签名状态页",
    "authenticationMethod": "email",
    "email": "收件人邮箱地址",
    "userName": "收件人姓名"
  }
  

• 接口返回的url字段就是收件人访问DocuSign签署页面的链接，你可以保存该链接用于后续追踪，或直接提供给收件人。

方法二：通过状态查询或Webhooks追踪（无需直接获取链接） #

如果你的核心需求是追踪信封状态而非获取链接本身，推荐以下两种方式：

• 定期查询信封状态：调用GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}接口，返回结果中的status字段会显示当前信封状态（如sent已发送、completed已完成、declined已拒绝等）。
• 配置Webhooks（Connect）：在DocuSign后台配置Webhook，当信封状态发生变更时，DocuSign会主动向你的应用推送状态通知，无需主动查询，效率更高。

注意事项 #

• 生成的收件人链接存在有效期，具体时长取决于DocuSign的系统设置。
• 调用所有API时，需确保你的应用持有有效的OAuth访问令牌，且拥有envelopes:read、envelopes:create等对应权限。

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