DocuSign API - 如何生成ReviewDocument链接

时间:2018-03-01 01:41:58

标签: docusignapi

因此,我们遇到的问题是客户没有收到DocuSign电子邮件。这些电子邮件被标记为垃圾邮件,这给我们带来了麻烦。

我们正在考虑发送自己的电子邮件。

为此,我需要构建DocuSign发出的URL,以便人们可以点击它。这是DocuSign使用的格式。

/Member/EmailStart.aspx?a=&acct=&er =

我从哪里获得'a'和'acct'值?

我确实在信封的签名者中发现了'er.ListRecipients

我认为'acct'以某种方式与我的帐户绑定,但我在我的帐户中找不到那个guid?

我从哪里获得'a'和'acct'?

2 个答案:

答案 0 :(得分:1)

您无法构建DocuSign发出的URL,以便收件人可以使用该URL来启动其签名会话。实现目标的方式(即将您自己的电子邮件发送给收件人而不是发送电子邮件的DocuSign)是使用DocuSign所称的“嵌入式/自锁式”签名。以下是该过程的描述:

1)通过发出Create Envelope API请求创建信封,并为每个收件人指定ClientUserId属性。 ClientUserId属性的存在告诉DocuSign不要向收件人发送电子邮件(这样您就可以自己完成)。

2)向收件人发送一封电子邮件,其中包含指向您构建的网页的链接 - 以及他们点击该链接以启动其信封 的说明准备审核/签署文件 。 (链接URL需要包含某些查询字符串参数,您的网页可用于识别信封和收件人。)

3)设计您的网页,以便在收到入站请求时(就像收件人点击您发送的电子邮件中的链接一样),它会使用查询字符串参数中的信息来识别信封和收件人,然后发出CreateRecipientView请求以检索将启动该收件人签名会话的URL,最后自动将用户重定向到CreateRecipientView响应返回的URL,从而打开收件人查看/签名/提交的信封。请注意,CreateRecipientView请求返回的URL是一个短暂的URL,只需几分钟(我相信5分钟)就会超时 - 这就是为什么您不想发出此请求来检索在收件人实际准备好查看信封之前的URL。

通过遵循这样的流程,您可以制作/发送收件人收到的电子邮件(而不是依赖DocuSign这样做),并且可以确保您每次只检索信封URL用户表示他们已经准备好签名(从而避免了短期链接在使用之前到期的可能性)。

(在“嵌入式​​签名”或“强制签名”中搜索DocuSign API文档或Stack Overflow,您将找到有关此方案的大量信息。)

答案 1 :(得分:0)

DocuSign在其电子邮件上花了很多精力,因此它们没有标记为垃圾邮件。如果电子邮件被标记为垃圾邮件,请联系DocuSign客户服务以获取帮助。他们将升级到工程组以分析问题。

谢谢。