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

Question

我有一个与 DocuSign 的集成设置，使用 API 创建和发送信封 - 一切正常，符合我们的预期。

但是，随着要求的提高，我现在正在查看 EnvelopeViews:createSender API，因为这似乎可以满足我们提供嵌入到逻辑流中的本机 DocuSign 体验的需求。

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

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

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

而不是“拳头签名者”收到标准 email 来签署文件，我宁愿他们在信封发送后立即被指示签署文件。

IE

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

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

这是第 3 步，我正在努力寻找该怎么做。

这个流程可行吗？

问候，大卫

Answer 1

这种流动是可能的。 您必须拨打三个 API 电话：

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

每个视图都有一个重定向 URL，它应该 go 回到您的应用程序。 在 2 和 3 之间，您将拨打新的 API 电话，然后将它们发送到新视图。

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

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