能否通过DocuSign API调用门户已创建模板并自动填充收件人信息发送？

完全可以实现你描述的需求——先在DocuSign门户创建模板，再通过API填充收件人信息并发送。以下是具体的实现步骤和关键要点：

1. 前期模板准备 #

在DocuSign门户创建模板时，需要注意：

• 给每个收件人设置明确的角色名称（比如“客户”“经办人”），后续API将通过这个角色名称匹配并替换真实的收件人信息。
• 如果模板中有需要自动填充的字段（比如姓名、公司名），要给这些字段设置对应的标签或数据域名称，方便API调用时赋值。

2. API调用核心流程 #

步骤1：获取访问令牌 #

通过DocuSign的OAuth 2.0授权流程获取access_token，这是所有API请求的身份凭证。

步骤2：调用创建信封接口 #

使用Envelopes::create接口，请求体中指定模板ID，并替换收件人信息、设置发送状态。示例请求体如下：

{
  "templateId": "你的模板ID",
  "status": "sent",
  "emailSubject": "请签署这份文档",
  "emailBlurb": "这是需要你签署的合同，请查收。",
  "recipients": {
    "signers": [
      {
        "roleName": "客户",
        "name": "张三",
        "email": "zhangsan@example.com"
      },
      {
        "roleName": "经办人",
        "name": "李四",
        "email": "lisi@example.com"
      }
    ]
  }
}

• templateId：替换为你在DocuSign门户创建的模板ID。
• status设为sent时，接口会直接发送信封给收件人；如果设为created，则会先创建草稿，后续可手动或通过其他API触发发送。
• roleName必须和模板中设置的收件人角色名称完全一致，否则无法匹配替换。

3. 额外注意事项 #

• 如果模板中有自定义字段需要填充，可以在请求体中添加customFields字段，对应设置键值对。
• 确保调用API的账号拥有该模板的访问权限，以及发送信封的权限。
• 测试阶段可以先将status设为created，查看生成的信封是否符合预期，再改为sent正式发送。

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