DocuSign:是否可以通过PowerForm链接发送自定义有效负载并通过Webhook取回?

时间:2018-10-11 18:25:44

标签: docusignapi powerform

我正在与DocuSign API集成,我想知道是否有可能实现以下方案:

  1. 获取PowerForm以获得其URL
  2. 将自定义有效内容附加到网址(例如,一些字符串化字符串和 urlencoded JSON)
  3. 将URL发送给用户
  4. 让用户签署所附文件 PowerForm的模板
  5. 在我的Webhook上接收回调
  6. 以某种方式恢复自定义有效载荷

上下文是这样的:我想向特定用户发送要签名的文档,当他们签名时-识别他们的特定通知。这将是通过SMS或Skype(聊天机器人)进行聊天的一部分-因此返回URL并不是一个很好的选择。

我一直在寻找Template Custom Fields API的方向,因为实际上您可以使用URL填写它们。但是看来,自定义字段在签名时必须在文档上可见,这带来了一个问题-对于最终用户来说,使用dfd84fc1-317f-4939-9dfb-4350d2127d2f(甚至带星号)之类的东西将是不好的UX。

这是我第一次使用DocuSign API,所以我希望这只是我在基本概念中缺少的东西...因此,我要发布此问题。

1 个答案:

答案 0 :(得分:1)

您可以使用模板自定义字段,其文本颜色为白色以匹配背景。文本仍将“刻录”到文档中(可通过ctrl-f查找),但对签名者而言不会出现。

或者,您可以使用信封自定义字段-签名者不可见这些字段,它们不会刻录到文档中,而是保留为可通过API访问的“元数据”。根据{{​​3}}:

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://docs.docusign.com/DocuSignHelp/Content/populate-custom-fields.htm

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