嵌入式发送和发起者需要签名答案

【问题标题】：Embedded Sending and initiator needs to sign嵌入式发送和发起者需要签名
【发布时间】：2021-01-16 02:53:44
【问题描述】：

我有一个与 DocuSign 的集成设置，使用 API 创建和发送信封 - 一切都按我们的预期工作。

但是，随着要求的提高，我现在正在研究 EnvelopeViews:createSender API，因为这似乎满足了我们提供嵌入到逻辑流程中的原生 DocuSign 体验的需求。

我还希望使用模板 - 即帐户有一系列预定义的模板，其中定义了文档、收件人角色、路由顺序等。我可以使用 Envelopes:Create 并传入 TemplateID 和“已创建”状态轻松创建处于草稿状态的信封。这导致信封处于草稿状态，我可以将其传递给 EnvelopeViews:createSender 以获取视图。

在签名过程的启动过程中，我的名义角色是“内部第一个签名者”。举例来说，考虑 HR Letter of Offer - 其中 DocuSign 模板将包含标准文档和“批准经理”、“HR 经理”和“候选人”角色。在这种情况下，“第一个内部签名者”将是“审批经理”。

在这种情况下，我需要作为发起人（“第一个签名者”）连接到 DocuSign，从模板创建信封，填充收件人详细信息（使用 createSender 中的视图），然后是发起者（“第一个签名者” ") 应该在文件上签名。

与其让“签名者”收到标准电子邮件来签署文件，我宁愿他们在信封发出后立即被指示签署文件。

即

主要应用程序发出 API 请求以从模板创建信封。
用户被定向到视图（新浏览器窗口）以填充剩余的收件人（在本机 DocuSign 界面中）
然后立即将发起用户带到签名会话以签署文档。
重定向到一个URL，负责更新一个状态缓存，然后关闭新窗口。

我们已经有效地处理了第 1 步和第 4 步（尽管在不同的集成流程中），第 2 步我可以从 API Explorer 中看到如何完成。

这是第 3 步，我正在努力寻找如何去做。

这个流程可行吗？

问候，大卫

【问题讨论】：

标签： docusignapi

【解决方案1】：

这个流程是可能的。您必须进行三个 API 调用：

从模板创建信封，但处于草稿“已创建”状态。
创建您要为其重定向的发件人视图并让用户填充收件人。
为相关用户创建收件人视图。

每个视图都有一个重定向 URL，它应该会返回到您的应用。在 2 到 3 之间，您将进行新的 API 调用，然后将它们发送到新视图。

请注意，还有另一种方法，您可以使用可以添加新收件人的特殊类型的收件人，然后您不会让他们使用发件人视图而是收件人视图。如果您想限制他们进行其他更改以便他们只能添加收件人，这将非常有用。

最后要注意的是，对于第 3 步，您需要正确的收件人 ID 并匹配已登录并将要签名的电子邮件/姓名。

【讨论】：

嗨 Inbar - 感谢您的回复。据我所知，所有这一切都很清楚，并没有完全达到我所追求的目标。为清楚起见，“我”正在启动信封并需要签署其中包含的文件。信封将基于模板。据我了解，用户完成时的发件人视图实际上会发送信封 - 因此“我”会收到一封来自 DocuSign 的电子邮件，提示我签署文件。即使我重定向到收件人视图，发件人视图的完成也会向我生成一封电子邮件，如果我使用收件人视图，这不是必需的 - 对吗？
理想情况下，在发件人视图中，如果第一个签名者与发起信封的用户相同，那么能够将他们直接带到签名视图然后重定向回调用应用程序。
不清楚您需要我帮助解决什么问题。您可以自定义发送的任何电子邮件。如果您为收件人提供 clientUserId - 他们将不会收到初始电子邮件。可以从帐户设置中控制最终电子邮件。至于让第一个签名者签名 - 这也是可能的。我们自己的一些第一方集成（如 DocuSign for Outlook 或 SharePoint）已经这样做了。您检查信封的设置方式以及登录用户是否是下一个签名者 - 您创建一个视图并将其重定向到那里。