如何通过API创建Envelope时禁用DocuSign邮件通知？

嘿，我帮你梳理下问题出在哪——你设置了clientUserId但还是收到签署邮件，主要是请求里的几个配置冲突或者错误导致的：

1. 重复的收件人配置搞乱了优先级 #

你在compositeTemplates里面已经定义了嵌入式签署的收件人，但同时在请求最顶层又加了一组recipients。用复合模板创建信封的时候，顶层的收件人配置会优先生效，直接覆盖了你在复合模板里设置的嵌入式参数，这就导致DocuSign还是按照普通签署流程发邮件了。

解决办法很简单：删掉请求顶层的recipients节点，所有收件人相关的配置都放在compositeTemplates的inlineTemplates里就行。

2. 收件人status设置错了 #

对于需要嵌入式签署的收件人，status得设成created而不是sent。如果设成sent，DocuSign会默认触发邮件通知，完全忽略你设置的clientUserId嵌入式标识。

3. 复合模板的sequence顺序不对 #

你把服务器模板和内联模板的sequence都设成了1，这样内联模板的配置没法正确覆盖服务器模板的设置。正确的做法是让内联模板的sequence比服务器模板的大，比如服务器模板设1，内联模板设2，这样内联的配置才能优先生效，覆盖模板里的默认收件人设置。

给你改好的请求示例 #

{
  "emailSubject": "Some Subject",
  "status": "sent",
  "compositeTemplates": [
    {
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "SOME ID"
        }
      ],
      "inlineTemplates": [
        {
          "recipients": {
            "signers": [
              {
                "name": "Ashwin Jacob",
                "email": "admin@ashwinjacob.com",
                "recipientId": "1",
                "clientUserId": "1",
                "status": "created",
                "embeddedRecipientStartURL": "SIGN_AT_DOCUSIGN",
                "roleName": "Advisor"
              }
            ],
            "carbonCopies": null
          },
          "sequence": "2"
        }
      ]
    }
  ]
}

额外提个醒 #

• 虽然你把clientUserId硬编码成1没问题，但如果以后有多个收件人，一定要保证每个收件人的clientUserId和recipientId是一一对应的，别搞混了。
• 也确认下服务器模板里这个角色的默认配置有没有强制发邮件，确保内联模板的设置能完全覆盖掉模板里的默认规则。

内容的提问来源于stack exchange，提问作者Ashwin Jacob