DocuSign API：为嵌入式收件人（专属收件人）指定签名图像

Question

我们的 Docusign 集成使得用户拥有一个 Docusign 帐户，可以创建一个信封，并且他们成为新信封上的嵌入式签名者。

为嵌入式签名者分配了一个clientUserId，这会导致为他们分配一个签名图像。

但是，该用户有一个他们想要使用的现有签名图像（他们的signatureId 是已知的）。

我知道可以使用Accounts: deleteCaptiveRecipient 端点删除强制收件人的签名图像。但是，该描述声明它“提供了一种重置与客户端用户 ID 关联的签名的方法，以便在下次使用客户端用户 ID 时可以创建 新 签名”。

我有兴趣将与用户的 Docusign 帐户关联的现有签名图像分配给该嵌入式收件人。

是否可以为嵌入式收件人设置签名图像？

编辑：由于不可能这样做，我有 2 个后续问题：

1) 由于我们的集成，用户可能是许多信封（即他们创建的每个信封）上的嵌入式收件人。

deleteCaptiveRecipient 是否不合适，因为无法通过 ID 识别唯一的嵌入式收件人（即仅更新一个嵌入式收件人）？

2) 如果为用户分配了新的clientUserId，如果再次分配之前的clientUserId，他们的旧签名图像是否仍然可用？

因此，选项 2 似乎是我们集成的更好选择（因为它是每个信封）。

Answer 1

没有将签名图像与签名者关联的 API 调用。签名只需要作为人类活动来完成。现在嵌入式签名者被视为无帐户签名者，如果您已将该签名者指定为嵌入式签名者，DocuSign 永远不会检查该签名者是否具有 DocuSign 帐户，因此 DocuSign 不会显示用户的帐户签名图像。无法为嵌入式收件人设置签名图像。

对于 #1，理想情况下，您应该为同一收件人使用相同的 clientUserId，因为 clientUserId 是 DocuSign 表上的索引，因此如果在不同的信封中一次又一次地使用相同的 clientUserId，则可以快速获取数据。通常，我们建议使用employeeNumber 或系统中该收件人的任何唯一userId 作为clientUserId。这样，相同的 clientUserId 将用于同一嵌入式收件人的所有信封。如果无法使用上述任何一项，那么您可以在 clientUserId 中使用 emailId，这样在发送给该嵌入式签名者的所有信封中也将使用相同的 clientUserId、名称和电子邮件。

对于 #2，对于嵌入式签名，只要您为特定个人传递相同的 name/email@/clientUserID，DocuSign 就会记住他们采用的签名，并将其重新应用于未来的签名事件。