DocuSign模板创建信封时CC收件人变为签署人问题咨询

问题核心在于DocuSign模板角色的唯一性限制：

模板里定义的每个roleName（比如你设置的“cc”）只能对应一个特定类型的收件人配置。当你在templateRoles数组中重复使用同一个“cc” roleName时：

• 第一个条目（Petya）会匹配模板里的“cc”角色定义（你设置的是抄送类型），所以被正确识别为Carbon Copy；
• 第二个条目（Vasya）因为找不到对应的重复模板角色（模板里只有一个“cc”角色），DocuSign会默认将其创建为Signer类型的收件人，这就是为什么Vasya出现在签署人列表里。

正确的解决方法 #

要添加多个抄送人，推荐用以下方式调整请求载荷：

1. 保留templateRoles里的“signer”角色配置，用于指定主签署人；
2. 直接在请求中添加recipients.carbonCopies数组，把所有抄送人信息放在这个数组里，而非重复使用模板角色。

修改后的请求载荷示例：

{
  "templateId": "my template id here",
  "status": "sent",
  "templateRoles": [
    {
      "email": "signersemail@mydomain.com",
      "roleName": "signer",
      "name": "Main signer",
      "tabs": {}
    }
  ],
  "recipients": {
    "carbonCopies": [
      {
        "email": "petya@mydomain.com",
        "name": "Petya"
      },
      {
        "email": "vasya@mydomain.com",
        "name": "Vasya"
      }
    ]
  }
}

如果抄送人数固定，也可以在模板中创建多个独立的抄送角色（比如cc1、cc2），然后在templateRoles里分别对应这些roleName，但这种方式灵活性较低。

内容的提问来源于stack exchange，提问作者Игорь