DocuSign：是否可以通过 PowerForm link 发送自定义负载并通过 webhook 取回？

Question

我正在与 DocuSign APIs 集成，我想知道是否可以实现以下场景：

获取 PowerForm 以获取其 URL
将自定义负载附加到 URL（例如，一些字符串化和 urlencoded JSON)
将 URL 发送给用户
让用户签署附件 PowerForm 的模板
在我的 webhook 上接收回调
以某种方式恢复自定义负载

上下文是这样的：我想向特定用户发送要签名的文档，当他们这样做时 - 识别他们的特定通知。这将是通过 SMS 或 Skype（聊天机器人）聊天的一部分 - 所以 return URL 并不是一个好的选择。

我一直在寻找模板自定义字段 API 的方向，因为实际上您可以使用 URL 来填充它们。但看起来自定义字段在签名时必须在文档上可见，这会带来一个问题——像 dfd84fc1-317f-4939-9dfb-4350d2127d2f（甚至 "asterisked"）这样的东西对最终用户来说是一个糟糕的用户体验。

这是我第一次使用 DocuSign APIs，所以我希望这只是我在基本概念上遗漏的东西...因此我发布了这个问题。

Answer 1

您可以使用文本为白色的模板自定义字段以匹配背景。文本仍将 'burned in' 到文档（可通过 ctrl-f 找到），但不会显示给签名者。

或者，您可以使用信封自定义字段 - 这些对签名者是不可见的，它们不会刻录到文档中，但它们会保留为 'metadata'，可通过 API.每 https://docs.docusign.com/DocuSignHelp/Content/populate-custom-fields.htm：

Envelope Field: To populate an envelope field in the Web PowerForm, add the following text in the URL:
EnvelopeField_<EnvelopeFieldName>=<value>
Where <EnvelopeFieldName> is the name of the envelope field in the Web PowerForm and the <value> is the value you want in the field.
Example: EnvelopeField_Region=Northwest

您可以通过调用

来检索该信息

GET /v2/accounts/{accountId}/envelopes/{envelopeId}/custom_fields

根据https://developers.docusign.com/esign-rest-api/reference/Envelopes/EnvelopeCustomFields/list

信封自定义字段也包含在 Connect 发布中

DocuSign：是否可以通过 PowerForm link 发送自定义负载并通过 webhook 取回？

DocuSign: Is it possible to send a custom payload via PowerForm link and get it back via webhook?

docusignapi

powerform