如何为在DocuSign中由代理/中介体分配的签名者获取嵌入式签名URL？

Question

当使用代理/中介体在DocuSign中分配签名者时，我们设置签名者使用嵌入式签名特性的clientUserId。但是DocuSign将自动发送电子邮件给指定的签名者，我们无法通过API POST {{baseUrl}}/v2.1/accounts/{{accountId}}/envelopes/{{envelopeId}}/views/recipient获得签名URL。

正如这个线程中所建议的：https://stackoverflow.com/a/63810135/13191875。这是由于当代理/中介更改签名者的电子邮件/名称信息时，clientUserId被删除。它建议在签名者的电子邮件/名称信息被更改后，可以添加一个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"
}

我可以在签名人的电子邮件/名字更改后设置clientUserId。，但是不能通过调用API PUT {{baseUrl}}/v2.1/accounts/{{accountId}}/envelopes/{{envelopeId}}?resend_envelope=true来恢复工作流。因此不能获得签名者的签名URL，因为进程暂停了，签名者的状态保持在created中。

我也尝试了with 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"
}

在代理添加了名称/电子邮件之后，进程被暂停，我为签名者设置了clientUserId，我通过调用get收件人信息API来验证它的添加。在我继续这个过程之后，DocuSign会向签名者发送一封电子邮件，而我无法获得该签名者的嵌入签名URL。我可以看到，通过再次调用get收件人信息API，该签名者的clientUserId被删除了。

我的问题是：

1. when使用DocuSign中的代理/中介体，我们是否可以使用DocuSign中的代理/中介体为其电子邮件由agents/intermediaries?
2. when更新/添加的指定签名者获取嵌入式签名URL，我们是否可以将该电子邮件从DocuSign关闭到签名者，该签名者的电子邮件由agents/intermediaries?

更新/添加

Answer 1

在使用DocuSign中的代理/中介体时，我们是否有可能获得由代理/中介更新/添加其电子邮件的指定签名者的嵌入签名URL？

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

在DocuSign中使用代理/中介时，我们是否可以将该邮件从DocuSign关闭给签名者，该签名者的电子邮件是由代理/中介更新/添加的？

要做到这一点，您需要像我在另一个答案中描述的那样停止工作流。

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

基本上，只有在通过API程序创建/编辑信封时，嵌入式签名才能工作。您使用API程序和使用常规的DocuSign网络应用程序(它专注于电子邮件传递，而不是嵌入式签名)的目标是混合苹果和橘子。这是可能的，但却是有问题的。

Answer 2

您可以使用新的高级收件人路由(ARR)功能暂停信封，获取有关下一个收件人的信息(通过对listRecipients的GET调用)，然后修改它以添加clientUserId。我没有试过这个，但理论上应该是可行的。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展示了如何在更改后恢复信封。您可能需要做的另一件事是添加一个web钩子调用，以便了解何时更新下一个收件人(但在此之前，您必须获得有关新收件人的信息)。