DocuSign - 也是 DocuSign 用户的嵌入式收件人需要在收件箱中查看信封

DocuSign - Embedded Recipient that is also a DocuSign User needs to view Envelope in their Inbox

我有一个 Web 应用程序,我们的用户可以在其中创建合同,并且我们通过嵌入式收件人体验与 DocuSign 集成。

我的 Web 应用程序相当多地参与收集适当的签名者、发送电子邮件、请求签名、跟上签名者状态等,因此我相信嵌入式收件人体验对我们来说最有意义。

但是,我们第一个使用该集成的客户已经使用 DocuSign 一段时间了,他们的签名者(CEO、CFO 等)习惯于登录 DocuSign,在他们的收件箱中看到信封并点击它们进行签名- 这只有通过将它们添加为远程收件人才能在集成中实现。嵌入的收件人无法关联到 DocuSign 用户帐户。

我想继续使用嵌入式收件人,但我的客户迫切希望在他们的 DocuSign 用户帐户收件箱中看到从我的应用程序创建的信封并从那里签名,而无需先登录我的应用程序。

有什么聪明的方法可以通过嵌入式收件人体验来发送此类请求吗?即使是非典型的解决方法,例如在嵌入的收件人和用户帐户或我不知道的其他收件人类型之间共享文档,等等?

不幸的是没有。创建嵌入式签名会话时,收件人成为所谓的专属收件人。专属收件人在电子邮件通知和收件箱中的存在方面遵循一组不同的规则。

例如,默认情况下,专属收件人不会收到电子邮件通知——但他们可以提供电子邮件以抄送到信封上。

由于专属收件人也有一个通用帐号,从技术上讲,该用户是您或您的收件人之外的帐户的一部分。

IE:您的收件人在帐户 XXXXXXXXX 上查看链接到其用户 ID 的收件箱。 Captive Recipient 是帐户 YYYYYYYYYY 的一部分,具有自己唯一的 userId,因此没有任何匹配项。

如果您的应用程序依赖于嵌入式签名将 DocuSign 信封加载到 iFrame 之类的东西中,您仍然可以在不使用嵌入式收件人的情况下执行此操作,这将使您能够通过您的 webApp 加载它们并让您的签名者通过他的 DocuSign 收件箱访问它们。

要检索签名 URL,您使用以下调用主体对 https://{endpoint}.docusign.net/restapi/v2/accounts/{accountId}/envelopes/{envelopeId}/views/recipient 进行 POST 调用:

{
  "returnUrl": "http://localhost/returnUrl",
  "authenticationMethod":"email",
  "email": "{recipientEmail}",
  "userName": "{recipientFullName}",
  "recipientId":"{recipientId}"
}