在Docusign中发送签名请求时是否可以使用returnUrl

时间:2017-07-13 09:24:03

标签: docusignapi

我想知道是否可以使用在签名文档后重定向用户的returnUrl,但是使用您将签名请求通过电子邮件发送给收件人的路径。

嵌入式流程对我们不起作用,除非我遗漏了一些东西,因为5分钟超时不起作用。

我想将签名请求通过电子邮件发送给收件人,然后在完成签名后将其重定向到自定义的“谢谢”页面。

问题是您可以立即拥有一个标志,但其他收件人需要几天时间,当他们到达请求时,它会超时。我还尝试重新创建了RecipientViewRequest,但是新的URL只显示了要签名的文档而没有签名的选项,即使水印显示“正在进行中”。

我正在使用C#SDK,我们将不胜感激。

1 个答案:

答案 0 :(得分:1)

要向嵌入式收件人发送电子邮件,请在创建收件人时指定 clientUserId embeddedRecipientStartURL

  

embeddedRecipientStartURL :这是发件人提供的有效网址字符串,用于重定向嵌入式收件人。使用此选项时,嵌入式收件人仍会收到来自DocuSign的电子邮件,就像远程收件人一样,但是当单击电子邮件中的文档链接时,收件人将通过DocuSign重定向到此URL以完成其操作。路由到URL时,由发件人的系统(响应URL的服务器)决定是否请求收件人令牌启动签名会话。

以下是createEnvelope请求示例

{
  "emailSubject": "Please sign the agreement",
  "status": "sent",
    "recipients": {
        "signers": [
            {
                "email": "janedoe@acme.com",
                "name": "jane doe",
                "recipientId": 1,
                "clientUserId":"1234",
                "embeddedRecipientStartURL":"<Add Url to your App here>",
                "tabs": {"signHereTabs": [{ "documentId": "1", "pageNumber": "1", "xPosition": "80", "yPosition": "80"}]}
            }
        ]
    },
    "documents": [{ "documentId": "1", "name": "Contract", "fileExtension": "txt", "documentBase64": "RG9jIFRXTyBUV08gVFdP" }]
}

当收件人点击其电子邮件中的链接时,他会被重定向到您在 embeddedRecipientStartURL 中指定的网址。在您的应用验证并识别收件人之后,您必须使用CreateRecipientView api请求收件人令牌,并在returnUrl参数中指定自定义感谢页面的网址。确保包含https://

   {
      "email": "janedoe@acme.com",
      "userName": "jane doe",
      "recipientId": 1,
      "clientUserId":"1234",
      "returnUrl":"https://www.google.com", //Include your custom thank you page here
      "AuthenticationMethod" :"email"
   }

另见answer