Docusign 如何为TemplateRole添加抄送方？建模板信封时如何区分signer与carbonCopies？

核心结论：Docusign 完全支持在模板对应的角色体系中添加抄送类收件人。之所以很多人会觉得“基于模板创建信封时不知道怎么区分签署人和抄送人”，本质是没搞懂模板角色的类型绑定逻辑——模板创建信封的收件人配置能力，和直接从零建信封的能力是完全对齐的，没有功能缺失。

模板内的角色类型预设 #

很多人默认模板角色只能用来配签署人，这是对模板能力的误解：

• 你在Docusign控制台搭建模板的阶段，就可以直接给模板添加两类不同属性的角色：一类是带操作权限的流程类角色（包括签署人Signer、编辑人Editor、认证收件人Certified Recipient等需要完成特定动作的角色），另一类就是无操作权限的纯抄送角色（Carbon Copy）。
• 这两类角色的类型属性，是在模板创建/编辑阶段就永久绑定在对应角色上的，不需要等创建信封的时候再临时标记类型。比如你可以给模板加两个角色：一个叫“项目申请人-签署”，把角色类型设为Signer；另一个叫“财务部-抄送”，把角色类型设为Carbon Copy——这两个角色后续都会出现在创建信封时可填充的templateRoles列表中，系统会自动识别每个角色对应的收件人类型。

基于模板创建信封时的配置规则 #

实际调用接口创建信封时，配置逻辑和大家熟悉的直接建信封的逻辑是对齐的：

• 你不需要在传入的templateRoles对象里额外加字段区分类型，只需要按照模板定义的角色名称，给每个角色匹配对应的收件人姓名、邮箱信息即可。
  • 匹配到Signer类型角色的收件人，会自动进入签署流程，收到待操作的签署通知
  • 匹配到Carbon Copy类型角色的收件人，不会收到任何待办提醒，只会在整个信封完成全部签署动作后，收到一份最终版的归档文档抄送
• 如果是需要给和模板预设角色无关的临时收件人发抄送，不需要强行把这些人套进模板角色体系，直接在创建信封请求的顶层carbonCopies数组里添加对应信息即可，这个配置方式和不基于模板创建信封的抄送逻辑完全一致。

常见的配置踩坑点 #

• 不要尝试在创建信封时，临时把模板里预设的Signer角色改成Carbon Copy。这个操作是系统不支持的，如果需要调整收件人类型，要么回到模板编辑页修改对应角色的类型设置，要么通过信封顶层的carbonCopies字段单独添加抄送对象，不要和模板角色混传。
• 不要误以为模板只能配置需要操作的收件人。你完全可以把固定抄送对象（比如公司合规岗、行政归档岗）的信息提前预填在模板的Carbon Copy角色里，后续批量创建信封时就不需要重复传输这些固定抄送信息了。
• 配置前可以先查模板详情：调用模板详情查询接口拉取目标模板的所有角色列表，每个角色对象里会直接返回对应的roleType字段，提前确认清楚角色类型，避免把收件人匹配到错误的角色上。

注：如果是在控制台可视化界面基于模板发起信封，系统会在收件人选择区自动把签署角色和抄送角色分开列示，不需要手动筛选区分。

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