DocuSign Apex Toolkit：如何动态添加仅接收副本的收件人？

你遇到的问题是代码写法导致抄送收件人被识别为签署人，完全可以通过编程实现添加抄送人，无需创建多个模板。以下是具体修正方案：

问题原因 #

你使用的dfsle.Recipient.fromSource()方法会优先匹配模板中角色的默认类型，如果模板里的CC角色被误配置为需要签署，或者该方法的参数优先级覆盖了后续的withRole()设置，就会导致收件人被标记为Needs to Sign。

正确代码写法 #

使用DocuSign Apex Toolkit提供的newCarbonCopy()方法直接创建抄送类型的收件人，同时关联模板中配置的CC角色：

new List<dfsle.Recipient> {
    // 嵌入式签署人
    dfsle.Recipient.newEmbeddedSigner(),
    // 抄送收件人（Receives a Copy）
    dfsle.Recipient.newCarbonCopy(
        'John Smith',       // 收件人姓名
        'john@smith.com',   // 收件人邮箱
        null,               // 可选手机号
        'CC'                // 模板中定义的CC角色名，必须完全匹配
    )
};

额外注意事项 #

• 确认模板中的CC角色已正确配置为Receives a Copy（而非需要签署的角色），角色名称需与代码中的'CC'完全一致（大小写敏感）。
• 如果不需要关联模板角色，也可以直接创建独立的抄送收件人（无需指定角色名），适用于不依赖模板的场景：

  dfsle.Recipient.newCarbonCopy(
      'John Smith', 
      'john@smith.com', 
      null
  )
  

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