如何在 DocuSign 中为 agents/intermediaries 分配的签名者获取嵌入式签名 URL？

Question

在 DocuSign 中使用 agents/intermediaries 分配签名者时，我们为签名者设置 clientUserId 以使用嵌入式签名功能。但是 DocuSign 会自动向指定的签名者发送电子邮件，我们无法通过 API POST {{baseUrl}}/v2.1/accounts/{{accountId}}/envelopes/{{envelopeId}}/views/recipient.

获得签名 URL

如本帖中所建议：。这是因为 clientUserId 在 agents/intermediaries 更改签名者的 email/name 信息时被删除。建议在签名者的email/name信息更改后添加workflow暂停流程，然后将clientUserId添加到签名者，然后恢复工作流程。

我尝试使用请求正文：

{
  "recipients": {
    "intermediaries": [
      {
        "clientUserId": "1",
        "email": "aaa@example.com.au",
        "name": "Intermediary",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ],
    "signers": [
      {
        "clientUserId": "2",
        "email": "example@example.com",
        "name": "example",
        "recipientId": "2",
        "routingOrder": "2",
        "tabs": {
          "signHereTabs": [
            {
              "anchorIgnoreIfNotPresent": "false",
              "anchorString": "Signature_anchor_1",
              "anchorUnits": "pixels",
              "anchorYOffset": "0",
              "name": "Please sign here",
              "recipientId": "1"
            }
          ]
        }
      }
    ]
  },
  "workflow": {
    "workflowSteps": [
      {
        "action": "pause_before",
        "itemId": "2",
        "triggerOnItem": "routing_order"
      }
    ]
  },
  "emailSubject": "DocuSign API - Signature Request on Document Call",
  "documents": [
    {
      "documentId": "1",
      "name": "{{fileName}}",
      "documentBase64": "{{fileBase64}}"
    }
  ],
  "status": "sent"
}

我可以在签名者的email/name更改后设置clientUserId。 但是无法通过调用 API PUT {{baseUrl}}/v2.1/accounts/{{accountId}}/envelopes/{{envelopeId}}?resend_envelope=true 恢复工作流程。所以进程暂停后无法获取签名者的签名URL，签名者的状态停留在created.

我也试过 agents:

{
  "recipients": {
    "agents": [
      {
        "clientUserId": "1",
        "email": "aaa@example.com.au",
        "name": "Agent",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ],
    "signers": [
      {
        "clientUserId": "2",
        "email": "",
        "name": "",
        "recipientId": "2",
        "routingOrder": "2",
        "tabs": {
          "signHereTabs": [
            {
              "anchorIgnoreIfNotPresent": "false",
              "anchorString": "Signature_anchor_1",
              "anchorUnits": "pixels",
              "anchorYOffset": "0",
              "name": "Please sign here",
              "recipientId": "1"
            }
          ]
        }
      }
    ]
  },
  "workflow": {
    "workflowSteps": [
      {
        "action": "pause_before",
        "itemId": "2",
        "triggerOnItem": "routing_order"
      }
    ]
  },
  "emailSubject": "DocuSign API - Signature Request on Document Call",
  "documents": [
    {
      "documentId": "1",
      "name": "{{fileName}}",
      "documentBase64": "{{fileBase64}}"
    }
  ],
  "status": "sent"
}

代理添加 name/email 后，进程暂停，我为签名者设置了 clientUserId，我通过调用获取收件人信息 [=64] 验证了它是否已添加=].在我恢复该过程后，DocuSign 向签名者发送了一封电子邮件，但我无法获得该签名者的嵌入式签名 URL。通过再次调用获取收件人信息 API，我可以看到该签名者的 clientUserId 已被删除。

我的问题是：

在 DocuSign 中使用 agents/intermediaries 时，我们是否可以通过 agents/intermediaries?
在 DocuSign 中使用 agents/intermediaries 时，我们是否可以关闭从 DocuSign 到签名者的电子邮件，其电子邮件是 updated/added by agents/intermediaries ?

Answer 1

您可以使用新的高级收件人路由 (ARR) 功能暂停信封，获取有关下一个收件人的信息（通过 GET 调用 listRecipients），然后修改它以添加 clientUserId。我没有尝试过这个，但理论上应该可行。所有新创建的帐户的 demo/developer 个帐户现在都可以使用 ARR。 https://developers.docusign.com/docs/esign-rest-api/how-to/pause-workflow 包含有关如何创建信封以使其在特定路由号码后暂停的信息。 https://developers.docusign.com/docs/esign-rest-api/how-to/unpause-workflow 展示了如何在您进行更改后恢复信封。您可能需要做的另一件事是添加一个 webhook 调用，以便在中介状态更新时调用，以便您知道何时更新下一个收件人（但在您这样做之前，您必须获取有关新收件人的信息） .

Answer 2

when using agents/intermediaries in DocuSign, is it possible that we can obtain the embedded signing URL for the assigned signer whose email is updated/added by agents/intermediaries?

是的，但您首先需要将 clientUserId 分配给收件人。由于收件人已经收到了签名仪式的电子邮件邀请，添加 clientUserId 属性是有问题的，因为这样做会使电子邮件邀请无效。

when using agents/intermediaries in DocuSign, is it possible that we can turn off that email from DocuSign to the signer, whose email is updated/added by agents/intermediaries?

为此，您需要停止我在其他答案中描述的工作流程。

更好的方法是扩展您的 API 应用程序，以便它用于更改签名者的 name/email。这样您的应用程序也可以同时设置 clientUserId 并且签名者不会收到任何电子邮件。

基本上，嵌入式签名仅适用于通过 API 程序 created/edited 的信封。您使用 API 程序和使用常规 DocuSign Web 应用程序（专注于电子邮件传递，而不是嵌入式签名）的目标是混合苹果和橘子。这是可能的，但有问题。

如何在 DocuSign 中为 agents/intermediaries 分配的签名者获取嵌入式签名 URL？

How to get embedded signing URL for signers who are assigned by agents/intermediaries in DocuSign?

docusignapi